Markdown Token Optimizer
Microsoft built this to help you slim down markdown files that are eating too many tokens. It counts tokens (using the 4 chars per token estimate), scans for the usual culprits like emoji spam and repetitive blocks, then gives you a table of specific suggestions with estimated savings. Nothing gets changed automatically, you review and decide. The included anti-patterns and optimization technique references are handy if you're trying to keep SKILL.md files under 500 tokens. Honestly most useful when you've written something verbose and need to make it AI-friendly without losing the actual content.
- skills.sh installs
- 1.1K
- GitHub stars
- 217
- last updated
- Jun 11, 2026
Install
$ npx -y skills add microsoft/github-copilot-for-azure --skill markdown-token-optimizer --agent claude-codeInstalls into .claude/skills of the current project.
Files
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
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/microsoft/github-copilot-for-azure
- Categories
- Git & Pull Requests, AI & Agent Building, Cloud & Infrastructure
- First seen
- Apr 16, 2026
More from microsoft/github-copilot-for-azure
All 40- Sensei1K
- Skill Authoring1K
- File Test Bug978
- Analyze Test Run847
- Airunway Aks Setup
- Analyze Skill Issues
- Azure Cloud Migrate
- Azure Cost
- Azure Enterprise Infra Planner
- Azure Kubernetes
- Azure Quotas
- Azure Reliability
- Azure Upgrade
- Entra Agent Id
- Investigate Integration Test
- Skill Reviewer
- Submit Skill Fix Pr
- Vally Eval
- Azure Ai103.7K
- Azure Cost Optimization103.2K
- Azure Deploy103.2K
- Azure Storage103.2K
- Azure Diagnostics103.1K
- Microsoft Foundry103.1K
Recommended
More Git & Pull Requests
karpathy-coderalirezarezvani/claude-skillsUse when writing, reviewing, or committing code to enforce Karpathy's 4 coding principles — surface assumptions before coding, keep it simple, make surgical cha1.1Kskills.sh installs
critical-code-reviewerposit-dev/skillsRigorously review code or pull requests for correctness, security, accessibility, maintainability, tests, and edge cases. Use when users request a critical code1.1Kskills.sh installs
arize-linkgithub/awesome-copilotGenerates deep links to the Arize UI for traces, spans, sessions, datasets, labeling queues, evaluators, and annotation configs. Produces clickable URLs for sha1.1Kskills.sh installs
capacitor-ci-cdcap-go/capgo-skillsComplete CI/CD guide for Capacitor apps covering GitHub Actions, GitLab CI, build automation, app signing, and deployment pipelines. Use this skill when users n1Kskills.sh installs
visual-recapbuilderio/skillsTurn a PR, branch, commit, or git diff into an interactive visual recap with diagrams, file maps, API/schema summaries, annotated diffs, and focused review note984skills.sh installs
cicd-pipeline-generatorailabs-393/ai-labs-claude-skillsThis skill should be used when creating or configuring CI/CD pipeline files for automated testing, building, and deployment. Use this for generating GitHub Acti982skills.sh installs