Productivity

markdown-token-optimizer

microsoft/github-copilot-for-azure · updated Apr 8, 2026

$npx skills add https://github.com/microsoft/github-copilot-for-azure --skill markdown-token-optimizer
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 recommendati
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

  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