Summarize

Use this skill as an operator manual for the @steipete/summarize CLI.

Core Rule

• Invoke summarize with bun x @steipete/summarize ....
• Prefer the local wrapper ./scripts/summarize.sh ... in this skill for consistency.
• Treat summarize as a black-box CLI. Do not inspect source code unless the user asks.
• Do not claim credentials/config are missing from parent-shell env inspection alone; prove it with the real CLI path or ./scripts/summarize-doctor.sh, since config may also live outside the current shell.

Workflow

1. Identify intent.

• summary: summarize content.
• extract: extract raw content/transcript without LLM summary.
• slides: extract slide screenshots from video.
• transcriber-setup: print ONNX setup env vars.
• refresh-free: rebuild OpenRouter free preset.

2. Run a baseline command.

• Summary baseline: ./scripts/summarize.sh "<input>"
• Extract baseline: ./scripts/summarize.sh "<input>" --extract
• Slides baseline: ./scripts/summarize.sh slides "<video-url>"

3. Apply mode-specific flags.

• Load references/capabilities.md for complete option surface.
• Load references/recipes.md for ready-to-run recipes.
• Load references/config-and-env.md for config/env setup.
• Load references/help-snapshots.md for exact live --help outputs by subcommand.
• Load references/troubleshooting.md for failure handling.

4. Verify result quality.

• For debugging, re-run with --verbose.
• For machine-readable output, use --json.
• Quote exact error text when reporting failures.

Quick Command Map

• Main help: ./scripts/summarize.sh --help
• Summarize: ./scripts/summarize.sh "https://example.com"
• Extract only: ./scripts/summarize.sh "https://example.com" --extract --format md
• YouTube transcript path: ./scripts/summarize.sh "<youtube-url>" --youtube auto
• Slides in summary: ./scripts/summarize.sh "<youtube-url>" --slides --slides-ocr
• Slides-only mode: ./scripts/summarize.sh slides "<youtube-or-video-url>" --render auto
• ONNX helper: ./scripts/summarize.sh transcriber setup --model parakeet
• Free preset refresh: ./scripts/summarize.sh refresh-free --set-default

Guardrails

• Use --extract when user asks for source text/markdown, not a summary.
• Use --video-mode transcript when user explicitly wants transcription-first for media URLs.
• Use --model openrouter/... only when user wants forced OpenRouter routing.
• Run ./scripts/summarize-doctor.sh before deep troubleshooting.
• Prefer incremental tuning: first baseline command, then add one flag at a time.