compress-markdown

Compress Markdown files into concise prose with backup and validation.

3|2|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/AdamCaviness/agentic-toolkit --skill compress-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compress-markdown
Source: https://github.com/AdamCaviness/agentic-toolkit/tree/main/skills/compress-markdown
Command: npx skills add https://github.com/AdamCaviness/agentic-toolkit --skill compress-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Compress Markdown files into concise prose to reduce token usage and streamline documentation workflows.

Core Features & Use Cases

  • Lossless default mode reduces verbosity without sacrificing content.
  • Deep mode audits sections against the codebase, removing stale or incorrect details before compression.
  • Backups original files and validates changes with a built-in validator to ensure fidelity.

Quick Start

Provide the path to a Markdown file to compress it in place after creating a backup.

Frequently Asked Questions about compress-markdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compress Markdown files to reduce token usage?

To compress Markdown files and reduce token usage, provide the file path to the Skill. It shrinks prose in place after creating a backup, using a built-in validator to ensure content fidelity.

What is codebase-aware Markdown auditing?

Codebase-aware Markdown auditing is a deep mode process that checks documentation sections against your actual codebase. It removes stale or incorrect details before compressing the remaining prose to reduce tokens.

Can I compress Markdown documentation without losing content?

Yes, you can compress Markdown without losing content using the default lossless mode. It reduces verbosity while preserving essential meaning, and creates a backup of the original file before making any changes.

Does Markdown compression modify my original files?

Markdown compression modifies your original files in place, but it safely creates a backup first. Changes are then validated using a built-in validator to preserve fidelity and ensure no essential meaning is lost.

What is the best way to audit stale Markdown documentation against a codebase?

The best way to audit stale Markdown documentation is using a deep mode compression tool. It audits sections against the codebase, removes incorrect details, validates changes, and compresses the remaining prose to reduce token usage.