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

1.37x

Quality

78%

Does it follow best practices?

Impact

84%

1.37x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/markdown-token-optimizer/SKILL.md

Evaluation results

100%

46%

Token Efficiency Analysis for Service Documentation

Token analysis workflow and output format

Criteria

Without context

With context

Token count method

20%

100%

Count step present

71%

100%

Scan step present

100%

Suggestion table present

25%

100%

Table has location column

100%

Table has issue column

100%

Table has fix column

12%

100%

Table has savings column

50%

100%

Summary step present

100%

Summary has current/potential/savings

90%

100%

Top recommendations listed

75%

100%

File not modified

100%

12%

Documentation Quality Review for AI Assistant Integration

Anti-pattern detection

Criteria

Without context

With context

Decorative emoji detection

100%

Echo header detection

100%

Filler word detection

100%

Duplicate content detection

100%

Long code block detection

100%

Horizontal rule detection

100%

Redundant intro detection

100%

No file modification

100%

53%

10%

Optimize API Documentation for AI Assistant Consumption

Optimization technique recommendations

Criteria

Without context

With context

Move to references suggestion

Reference links for duplicates

30%

Verbose phrase replacement

100%

List to table conversion

100%

Code block to inline code

100%

Token target for main file

100%

Token target for references

Progressive disclosure structure

Savings estimates provided

100%

No file modification

100%

Repository: microsoft/github-copilot-for-azure
Commit: 1f4304b

Evaluated: 19 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Token Efficiency Analysis for Service Documentation Documentation Quality Review for AI Assistant Integration Optimize API Documentation for AI Assistant Consumption

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.