agents/skills/summarize/SKILL.md
Use when asked to summarize, read, or convert a PDF, DOCX, PPTX, HTML file, or URL — converts to Markdown via markitdown, with an optional model-written summary.
npx skillsauth add timofreiberg/dotfiles summarizeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Turn “things” (URLs, PDFs, Word docs, PowerPoints, HTML pages, text files, etc.) into Markdown so they can be inspected/quoted/processed like normal text.
markitdown can fetch URLs by itself; this skill mainly wraps it to make saving + summarizing convenient.
The wrapper uses the markitdown[pdf] extra automatically, so PDF inputs just work.
Use this skill when you need to:
The wrapper works from any cwd:
node "$HOME/dotfiles/agents/skills/summarize/to-markdown.mjs" <url-or-path> --tmp
--tmp writes Markdown to a temp file and prints the path.--out <file> writes to a specific file instead.uvx --from 'markitdown[pdf]' markitdown <url-or-path> does the same).If conversion fails (auth-walled or JS-heavy pages, unsupported formats), fall back to fetching/reading the source directly or ask the user.
Summaries are only useful when you provide what you want extracted and the audience/purpose.
node "$HOME/dotfiles/agents/skills/summarize/to-markdown.mjs" <url-or-path> --summary --prompt "Summarize focusing on X, for audience Y. Extract Z."
This will:
uvx --from 'markitdown[pdf]' markitdown.md file and print its path as a "Hint" line (always — so you can open/inspect the full content)pi --model claude-haiku-4-5 (no-tools, no-session) to summarize using your extra prompt (--summary-prompt is an alias for --prompt)databases
Use when a judgment forms during work that a future session would benefit from — a fork you resolved, a correction from the user, a wrong assumption about the environment, something you had to rediscover. Appends one timestamped entry to the journal staging dir.
development
Use when starting your work day: groom the todo list to a trusted state, archive finished work, surface today's candidates, and propose a concrete first move. Stab-then-confirm, ~5 min.
data-ai
Use when reviewing local changes — the working-copy diff, a branch, a commit, or a GitHub PR by number — with a fresh subagent that returns a structured findings report.
tools
Use when a question needs current internet information — docs, news, releases, prices. Prefer a built-in web search tool for quick lookups if the harness has one; this script returns a model-summarized answer with source URLs and works without one.