Agent skill

Doc Condenser

by Mathews-Tom in Mathews-Tom/armory

DEPRECATED: The base model handles document condensation and summarization natively at high quality.

MITAuto-check passedWriting & Content

Install Doc Condenser

skills CLI
$ npx skills add Mathews-Tom/armory --skill doc-condenser -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Mathews-Tom/armory doc-condenser --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Mathews-Tom/armory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/doc-condenser .claude/skills/doc-condenser && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
doc-condenser
GitHub stars
328
Token cost
~1.4k tokens
SKILL.md length
571 words
Files
4 (incl. references, assets)
Skills in repo
80
Repo updated
First seen
Licence
MIT

At a glance

DEPRECATED: The base model handles document condensation and summarization natively at high quality.

  • Works in 5 steps: Paths first - Every file reference… → Tables over prose - Use tables for… → Code samples stay - Keep small,… → …
  • Tasks that involve Summarization
  • SKILL.md covers Core Principles, Output Structure, Transformation Rules and Working with Existing Documents, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Doc Condenser is an agent skill from Mathews-Tom/armory. DEPRECATED: The base model handles document condensation and summarization natively at high quality. This skill no longer provides meaningful uplift. Retained for reference only.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files and assets (for example `assets/template.md`, `evals/cases.yaml` and `references/style-guide.md`).

It sits in Writing & Content, covering Summarization. The repository describes itself as: Curated, production-grade skills for AI coding agents. Battle-tested workflows for developers who use AI seriously. The licence is MIT.

When your agent uses it

  • Tasks that involve Summarization

Example prompts

  • “/doc-condenser”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Paths first - Every file reference includes full/relative path
  2. Tables over prose - Use tables for metrics, coverage, file lists
  3. Code samples stay - Keep small, illustrative snippets; remove verbose examples
  4. Commentary, not explanation - Brief context sentences, not paragraphs
  5. One-line history - Reference legacy docs, don't preserve their content

What it can do on your machine

Read from SKILL.md and the folder at commit 4594fb7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Doc Condenser loads about 1.4k tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 48 tokens; SKILL.md has 571 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Mathews-Tom/armory at commit 4594fb7, republished under its MIT licence (© Mathews-Tom). 571 words, ~1,393 tokens.

Download SKILL.mdSave it as .claude/skills/doc-condenser/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
doc-condenser
description
DEPRECATED: The base model handles document condensation and summarization natively at high quality. This skill no longer provides meaningful uplift. Retained for reference only.
metadata.version
1.1.1
metadata.status
deprecated
metadata.category
review
metadata.tags
documentation, summarization, technical-writing, conciseness
metadata.difficulty
beginner

DEPRECATED — Modern Claude models condense and summarize technical documentation natively with comparable quality. The output format preferences encoded here (40% length cap, tables over prose, paths first) are too generic to justify skill overhead. Retained for archival reference only.

Document Condenser

Transform verbose technical documentation into concise, developer-focused specs.

Core Principles

  1. Paths first - Every file reference includes full/relative path
  2. Tables over prose - Use tables for metrics, coverage, file lists
  3. Code samples stay - Keep small, illustrative snippets; remove verbose examples
  4. Commentary, not explanation - Brief context sentences, not paragraphs
  5. One-line history - Reference legacy docs, don't preserve their content

Output Structure

markdown
# [path/to/output.md]

# [Title] - [Subtitle if needed]

## Purpose

[2-3 sentences: what this is, why it exists, key design principle]

## Status

[Table: metrics, rates, performance]

## Architecture Overview

[Optional diagram or brief flow description]
[Only if it aids understanding]

## Implementation Files

[Grouped by category with paths and one-line descriptions]

## [Domain-Specific Sections]

[Tables, code snippets, brief commentary as needed]

## Quick Reference

[Box or code block with key stats for scanning]

See assets/template.md for a copy-ready scaffold of this structure.

Transformation Rules

KEEP
  • File paths (always full or project-relative)
  • Metrics and measurements
  • Code snippets under 15 lines that illustrate patterns
  • Schema examples and data structures
  • Coverage/status tables
CONDENSE
  • Multi-paragraph explanations → 1-2 sentences
  • Verbose examples → representative snippet + "see X for more"
  • Implementation checklists → completion status table
  • Long rationales → single "Design principle: X" line
  • Code snippets longer than 20 lines → condense to the core pattern + a reference comment pointing to the source file
  • Rationale sections where the same point is restated across more than 3 sentences → collapse to one "Design principle:" line
REMOVE
  • Historical context beyond one reference line
  • Achieved/completed celebration language
  • Redundant explanations of the same concept
  • Step-by-step tutorials (link to them instead)
  • "What we learned" retrospectives
FORMAT
  • Use code blocks for paths and commands
  • Group related files under headers
  • Prefer tables over bullet lists for structured data
  • End with quick-reference block for scanning

Working with Existing Documents

When condensing an existing verbose doc:

  1. Identify the core purpose (first paragraph of output)
  2. Extract all file paths into grouped tables
  3. Preserve code samples that show patterns
  4. Convert prose sections to tables where possible
  5. Add single history reference line
  6. Verify no information loss on key technical details

Style Guide

See references/style-guide.md for detailed formatting rules, table patterns, and code sample guidelines.

Example Transformation

Before (verbose):

text
We have successfully achieved and EXCEEDED the original goals of this specification!
After many iterations and improvements, our automation rate reached 96.6% which is
above our target of 95%. The team worked hard on this and we're very proud...

After (concise):

text
**v31 PRODUCTION** | 96.6% automation (target: 95%)
Show full SKILL.md (241 more words)Show less

Calibration Rules

  • Condensed output must not exceed 40% of source document length measured in words.
  • All file paths present in the original must appear in the condensed output — paths are never dropped.
  • Code blocks are never removed outright; reduce length by extracting the representative pattern and adding a source reference comment.

Error Handling

  • Source document has no clear purpose: ask for one sentence of context before condensing — do not infer a purpose and proceed.
  • A section contains items that are ambiguous between KEEP and REMOVE: default to KEEP and flag the section with a <!-- review: ambiguous --> comment in the output.
  • Condensed result loses required technical detail identified during verification: restore the omitted detail and re-measure against the 40% length cap; if the cap cannot be met, document the exception inline.
  • Source contains no file paths: skip the Implementation Files section entirely rather than generating placeholder paths.
  • Source is a non-text format (image, diagram, spreadsheet): report the format is unsupported and return without output.
  • Style guide conflicts with source formatting conventions: follow references/style-guide.md and note the override at the top of the output.

Limitations

  • Works on text documents only; images, diagrams, and binary files cannot be condensed.
  • Condensation ratio depends on source verbosity — highly structured sources yield less reduction.
  • Style guide deference (references/style-guide.md) takes precedence over source formatting, which can alter heading levels and table layouts.
  • Does not follow hyperlinks or fetch referenced external documents; referenced content is noted but not inlined.

© Mathews-Tom, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references, assets) in skills/doc-condenser of Mathews-Tom/armory.

  • SKILL.md
  • assets/template.md
  • evals/cases.yaml
  • references/style-guide.md

Open the folder on GitHubat commit 4594fb7

Compare with similar skills

Doc Condenser next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Doc Condenser compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Doc Condenser this skillMathews-Tom/armory328—~1.4kAutomated safety check: PassMIT
News Aggregator Skillcclank/news-aggregator-skill1.3k—~2.1kAutomated safety check: PassNone
Vss Search ArchiveNVIDIA-AI-Blueprints/video-search-and-summarization1.9k—~3.6kAutomated safety check: PassApache-2.0
AI Daily Newsgeekjourneyx/ai-daily-skill235—~2.3kAutomated safety check: PassNone
AnalyzeriBigQiang/feedgrab614—~1kAutomated safety check: PassMIT
Reportmicrosoft/data-formulator18k—~1.5kAutomated safety check: PassMIT

Similar skills

  • News Aggregator Skill

    cclank/news-aggregator-skill

    Comprehensive news aggregator that fetches, filters, and deeply analyzes real-time content from 44+ sources including Hacker News, Lobsters, Dev.to, GitHub, arXiv, Hugging Face Papers, AIHOT, TLDR…

    1.3k GitHub stars~2.1k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Vss Search Archive

    NVIDIA-AI-Blueprints/video-search-and-summarization

    A skill your agent uses when a user wants to search archived VSS video or ingest or delete a source for search.

    1.9k GitHub stars~3.6k tokensUpdated today
    Writing & ContentAuto-check passed
  • AI Daily News

    geekjourneyx/ai-daily-skill

    Fetches AI news from smol.ai RSS and generates structured markdown with intelligent summarization and categorization.

    235 GitHub stars~2.3k tokensUpdated today
    Writing & ContentAuto-check passed
  • Analyzer

    iBigQiang/feedgrab

    Content Analyzer — any content (URL, text, transcript) into structured analysis report with actionable insights.

    614 GitHub stars~1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Report

    microsoft/data-formulator

    Official

    Turn an exploration (threads, findings, charts) into a single Markdown report — note, blog post, executive summary, KPI dashboard, slide brief, or multi-section analytical report, with embedded…

    18k GitHub stars~1.5k tokensUpdated today
    Writing & ContentAuto-check passed
  • Tldr

    earlyaidopters/claudeclaw

    Summarize the current conversation into a TLDR note and save it to your notes folder.

    173 GitHub stars~953 tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed

More from Mathews-Tom/armory

All 80 skills in this repo
  • Architecture Reviewer

    Mathews-Tom/armory

    Architecture reviews across 7 dimensions (structural, scalability, enterprise readiness, performance, security, ops, data) with scored reports.

    328 GitHub stars~4.6k tokensUpdated 2 days ago
    Auto-check passed
  • Concept To Image

    Mathews-Tom/armory

    Turn concepts into static HTML visuals exported as PNG or SVG files via HTML/CSS/SVG.

    328 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • Watch

    Mathews-Tom/armory

    A skill your agent uses when analyzing an existing video URL or local recording: "watch this video", "analyze youtube video", "summarize this video", "youtube transcript", "find this moment", "what…

    328 GitHub stars~2.8k tokensUpdated 2 days ago
    Auto-check passed
  • Code Refiner

    Mathews-Tom/armory

    Deep code simplification and refactoring preserving behavior across Python, Go, TypeScript, Rust.

    328 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Concept To Video

    Mathews-Tom/armory

    Turn concepts into animated explainer videos using Manim (Python) with MP4/GIF output, audio overlay, multi-scene composition.

    328 GitHub stars~4.9k tokensUpdated 2 days ago
    Auto-check passed
  • Decision Map

    Mathews-Tom/armory

    Maps the unresolved architecture, policy, and scope decisions that must be answered before planning can start: one durable decision ticket per question on the issue tracker, typed and blocker-linked…

    328 GitHub stars~2.7k tokensUpdated 2 days ago
    Auto-check passed

Questions about Doc Condenser

What does Doc Condenser do?

DEPRECATED: The base model handles document condensation and summarization natively at high quality. Doc Condenser is an agent skill from Mathews-Tom/armory. DEPRECATED: The base model handles document condensation and summarization natively at high quality.

When should I use Doc Condenser?

Doc Condenser fits situations like: tasks that involve Summarization.

How do I install Doc Condenser in Claude Code?

Run `npx skills add Mathews-Tom/armory --skill doc-condenser -a claude-code`. Or copy the skill folder (skills/doc-condenser in Mathews-Tom/armory) into .claude/skills/doc-condenser in your project. Claude Code loads it when a task matches its description.

How do I install Doc Condenser in Codex?

Run `npx skills add Mathews-Tom/armory --skill doc-condenser -a codex`. Or copy the skill folder (skills/doc-condenser in Mathews-Tom/armory) into .agents/skills/doc-condenser in your project. Codex loads it when a task matches its description.

Can I use Doc Condenser in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Mathews-Tom/armory --skill doc-condenser -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/doc-condenser, .gemini/skills/doc-condenser, .github/skills/doc-condenser and .opencode/skills/doc-condenser in your project.

What does Doc Condenser need to run?

SKILL.md names no scripts, command-line tools or credentials: Doc Condenser is instructions for the agent only.

Does Doc Condenser access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Doc Condenser safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Doc Condenser use?

Doc Condenser is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Doc Condenser use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 814 tokens, read only when the agent opens those files.

What are the alternatives to Doc Condenser?

Skills that share tags, products or a category with Doc Condenser: News Aggregator Skill (cclank/news-aggregator-skill, 1.3k stars), Vss Search Archive (NVIDIA-AI-Blueprints/video-search-and-summarization, 1.9k stars), AI Daily News (geekjourneyx/ai-daily-skill, 235 stars) and Analyzer (iBigQiang/feedgrab, 614 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Doc Condenser?

Mathews-Tom (a GitHub user) maintains it in Mathews-Tom/armory, which has 328 GitHub stars. The repository holds 80 skills in this directory. The repository was last updated on October 6, 2026.

Source: Mathews-Tom/armory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.