GitHub-Copilot-for-Azure markdown-token-optimizer

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

install
source · Clone the upstream repo
git clone https://github.com/microsoft/GitHub-Copilot-for-Azure
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/microsoft/GitHub-Copilot-for-Azure "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.github/skills/markdown-token-optimizer" ~/.claude/skills/microsoft-github-copilot-for-azure-markdown-token-optimizer && rm -rf "$T"
manifest: .github/skills/markdown-token-optimizer/SKILL.md
source content

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