mcpField
S
summarize

summarize

github.com/mitsuhikoDocuments3.2k280 installsUpdated 5w ago
Repository

About summarize

A skill that converts URLs and common document files into Markdown, with an option to create a short summary using a specified prompt. It is for agents that need text representations for inspection, quotation, or analysis.

Key features

  1. 01Convert URLs and files to Markdown
  2. 02Handle PDF, DOCX, and PPTX inputs
  3. 03Save converted text to a temporary file
  4. 04Summarize with a custom prompt
  5. 05Keep the full Markdown available

Use cases

  1. 01Prepare a web page for analysis
  2. 02Convert a PDF before reviewing it
  3. 03Summarize a long document
  4. 04Extract content for quotation

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mitsuhiko/agent-stuff --skill summarize

After installing, type/summarizein Claude Code to confirm it loaded.

Bundled filesto-markdown.mjs

Details

From the project README

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. For PDF inputs, use the markitdown[pdf] extra (or the wrapper below, which now does this automatically).

When to use

Use this skill when you need to:

  • pull down a web page as a document-like Markdown representation
  • convert binary docs (PDF/DOCX/PPTX) into Markdown for analysis
  • quickly produce a short summary of a long document before deeper work

Quick usage

Convert a URL or file to Markdown

Run from this skill folder (the agent should cd here first):

uvx --from 'markitdown[pdf]' markitdown <url-or-path>

To write Markdown to a temp file (prints the path) use the wrapper:

node to-markdown.mjs <url-or-path> --tmp

Tip: when summarizing, the script will always write the full converted Markdown to a temp .md file and will always print a final "Hint" line with the path (so you can open/inspect the full content).

Write Markdown to a specific file:

uvx --from 'markitdown[pdf]' markitdown <url-or-path> > /tmp/doc.md
Convert + summarize with haiku-4-5 (pass context!)

Summaries are only useful when you provide what you want extracted and the audience/purpose.

node to-markdown.mjs <url-or-path> --summary --prompt "Summarize focusing on X, for audience Y. Extract Z."

Or:

node to-markdown.mjs <url-or-path> --summary --prompt "Focus on security implications and action items."

This will:

  1. convert to Markdown via uvx --from 'markitdown[pdf]' markitdown
  2. write the full Markdown to a temp .md file and print its path as a "Hint" line
  3. run pi --model claude-haiku-4-5 (no-tools, no-session) to summarize using your extra prompt

Comments

Markdown supported