Summarize
Verified@steipete
npx machina-cli add skill @steipete/summarize --openclawSummarize
Fast CLI to summarize URLs, local files, and YouTube links.
Quick start
summarize "https://example.com" --model google/gemini-3-flash-preview
summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview
summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
Model + keys
Set the API key for your chosen provider:
- OpenAI:
OPENAI_API_KEY - Anthropic:
ANTHROPIC_API_KEY - xAI:
XAI_API_KEY - Google:
GEMINI_API_KEY(aliases:GOOGLE_GENERATIVE_AI_API_KEY,GOOGLE_API_KEY)
Default model is google/gemini-3-flash-preview if none is set.
Useful flags
--length short|medium|long|xl|xxl|<chars>--max-output-tokens <count>--extract-only(URLs only)--json(machine readable)--firecrawl auto|off|always(fallback extraction)--youtube auto(Apify fallback ifAPIFY_API_TOKENset)
Config
Optional config file: ~/.summarize/config.json
{ "model": "openai/gpt-5.2" }
Optional services:
FIRECRAWL_API_KEYfor blocked sitesAPIFY_API_TOKENfor YouTube fallback
Overview
Summarize is a fast CLI that condenses content from URLs, local files, and YouTube into concise summaries. It supports multiple providers and can output JSON for downstream workflows, making it ideal for research, reporting, and automation.
How This Skill Works
Install summarize, configure provider API keys (OpenAI, Anthropic, xAI, or Google Gemini), then run summarize on a URL, a local file, or a YouTube link. The tool sends the content to the chosen model, applies length or format options, and returns a human-readable or machine-readable summary.
When to Use It
- You need a quick digest of a long article from a URL for a briefing
- You must summarize a local PDF, DOC, or text file for notes or a report
- You want a YouTube video summarized for meeting notes or a storyboard
- You require machine-readable, structured output (JSON) for automation or pipelines
- You want to extract only URLs from a page for citation or research
Quick Start
- Step 1: summarize "https://example.com" --model google/gemini-3-flash-preview
- Step 2: summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview
- Step 3: summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
Best Practices
- Set a suitable model and keep API keys secure in environment variables
- Use --length to control summary size and --max-output-tokens for longer outputs
- Use --extract-only when you only need URLs from a page
- Use --json when integrating summaries into workflows or databases
- For large documents, test with a short example first and adjust length accordingly
Example Use Cases
- Summarize a web article for a quick briefing with the Gemini model
- Summarize a local PDF report to create slide-ready bullets
- Summarize a YouTube video to capture key points for a recap
- Extract all URLs from a page for citation tracking
- Get a structured JSON summary for ingestion into a CMS or data store
