Markdown Token Optimizer

SkillFiles & storage

Analyzes markdown files for token efficiency. TRIGGERS: optimize markdown, reduce tokens, token count, token bloat, too many tokens, make concise, shrink file, file too large, optimize for AI, token efficiency, verbose markdown, reduce file size

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Markdown Token Optimizer skill

What this skill tells your AI

The instructions your AI receives, as published by microsoft/github-copilot-for-azure in .github/skills/markdown-token-optimizer/SKILL.md and read by ahel’s review.

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

  1. Count - Calculate tokens (~4 chars = 1 token), report totals
  2. Scan - Find patterns: emojis, verbosity, duplication, large blocks
  3. Suggest - Table with location, issue, fix, savings estimate
  4. 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

Signals

GitHub stars
251
Forks
202
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
markdown-token-optimizer
Source
github.com/microsoft/github-copilot-for-azure