markdown-token-optimizer▌
microsoft/github-copilot-for-azure · updated Apr 8, 2026
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 recommendati
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.
Rules
- Suggest only (no auto-modification)
- Preserve clarity in all optimizations
- SKILL.md target: <500 tokens, references: <1000 tokens
References
- OPTIMIZATION-PATTERNS.md - Optimization techniques
- ANTI-PATTERNS.md - Token-wasting patterns
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.7★★★★★49 reviews- ★★★★★Dev Martin· Dec 12, 2024
markdown-token-optimizer is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Min Torres· Dec 4, 2024
markdown-token-optimizer reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Jin Mehta· Nov 23, 2024
I recommend markdown-token-optimizer for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Sakshi Patil· Nov 15, 2024
markdown-token-optimizer has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★James White· Nov 3, 2024
markdown-token-optimizer fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Aarav Thomas· Oct 22, 2024
We added markdown-token-optimizer from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Valentina Ndlovu· Oct 14, 2024
Useful defaults in markdown-token-optimizer — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Chaitanya Patil· Oct 6, 2024
Solid pick for teams standardizing on skills: markdown-token-optimizer is focused, and the summary matches what you get after install.
- ★★★★★Dev Thompson· Sep 25, 2024
markdown-token-optimizer fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Oshnikdeep· Sep 21, 2024
Registry listing for markdown-token-optimizer matched our evaluation — installs cleanly and behaves as described in the markdown.
showing 1-10 of 49