markdown-token-optimizer

v2026.03.15

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

GitHub
Install command
npx skhub add microsoft/markdown-token-optimizer
Markdown
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

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.03.15

Published

Mar 15, 2026

Category

Uncategorized

License

NOASSERTION

Source path

.github/skills/markdown-token-optimizer

Default branch

main

Latest commit

c624dca

Tree SHA

bc5ed39