markdown-token-optimizer
Installation
Summary
Analyzes markdown files and suggests token-reduction optimizations while preserving clarity.
- Counts tokens using a 4-character-per-token approximation and identifies token-wasting patterns including emojis, verbosity, duplication, and oversized code blocks
- Generates a detailed suggestions table showing issue location, description, recommended fix, and estimated token savings
- Targets SKILL.md files for under 500 tokens and reference files for under 1000 tokens
- Provides recommendations only without auto-modifying files, ensuring developers retain full control over changes
SKILL.md
Markdown Token Optimizer
This skill analyzes markdown files and suggests optimizations to reduce token consumption while maintaining clarity.
When to Use
- Optimize markdown files for token efficiency
- Reduce SKILL.md file size or check for bloat
- Make documentation more concise for AI consumption
Workflow
- Count - Calculate tokens (~4 chars = 1 token), report totals
- Scan - Find patterns: emojis, verbosity, duplication, large blocks
- Suggest - Table with location, issue, fix, savings estimate
- Summary - Current/potential/savings with top recommendations
See ANTI-PATTERNS.md for detection patterns and OPTIMIZATION-PATTERNS.md for techniques.