Help us improve
Share bugs, ideas, or general feedback.
From abstract
Generates context optimization report for skills directory: total size, token estimates, size distribution by category, per-file details, and modularization recommendations. Supports --stats, --estimate, --report flags.
npx claudepluginhub athola/claude-night-market --plugin abstractHow this command is triggered — by the user, by Claude, or both
Slash command
/abstract:context-reportThe summary Claude sees in its command listing — used to decide when to auto-load this command
# Context Optimization Report Generates a detailed context window optimization report for all skills in a directory. Identifies large files, categorizes by size, and provides actionable optimization recommendations. ## When To Use Use this command when you need to: - Assessing overall skill portfolio efficiency - Pre-publish verification before releasing plugins - Planning modularization priorities across many skills - Identifying large files that need optimization ## When NOT To Use Avoid this command if: - Analyzing single skill - use /analyze-skill instead - Evaluating skill quality...
/analyze-skillsAnalyzes installed skills for token usage, dependencies, and optimization suggestions. Reports totals, largest skills, quality scores, dependency patterns, and recommendations.
/skill-reportGenerates report of installed skills with quick health scan, context budget, portfolio overview, and quality summary. Supports --skip-scan and --scan-only flags.
/validate-skillValidates skill file at given path for structure, quality, security, standards, and ecosystem compliance, producing detailed report with summary, findings, recommendations, and readiness status.
/skill-auditPerforms static audit of SKILL.md files — validates frontmatter, checks edge-case coverage, surfaces prompt-injection risks, and reports length budget.
/fire-skillManages skills: create interactively/quick/from-session/summary, import from URL/file/marketplace, test/validate, list/filter, stats, export, browse, upgrade.
/reviewAudits an existing skill for structure, frontmatter, description and body quality, triggering risks, and MCP usage, producing a scored review report with recommendations.
Share bugs, ideas, or general feedback.
Generates a detailed context window optimization report for all skills in a directory. Identifies large files, categorizes by size, and provides actionable optimization recommendations.
Use this command when you need to:
Avoid this command if:
# Analyze skills directory
/context-report skills/
# Analyze specific plugin's skills
/context-report ~/.claude/plugins/my-plugin/skills
# Full statistics with detailed breakdown
/context-report skills/ --stats
# Estimate tokens for a single skill file
/context-report --estimate skills/my-skill/SKILL.md
# Estimate with dependency analysis
/context-report --estimate skills/my-skill/SKILL.md --include-dependencies
Skills are categorized by byte size for optimization priority:
| Category | Size Range | Recommendation |
|---|---|---|
| Small | < 2KB | Optimal, no action needed |
| Medium | 2-5KB | Good, monitor growth |
| Large | 5-15KB | Consider modularization |
| XLarge | > 15KB | Should modularize |
/context-report skills/
# Output:
# Context Optimization Analysis
# ==================================================
# Total Skills: 12
# Total Size: 45,230 bytes
# Estimated Tokens: 11,842
#
# Size Distribution:
# Small (<2KB): 8 files
# Medium (2-5KB): 3 files
# Large (5-15KB): 1 files
# XLarge (>15KB): 0 files
#
# Recommendation: 1 file(s) exceed 5KB
# Consider using progressive disclosure or modularization
/context-report skills/ --report
# Adds detailed per-file breakdown:
# Path Size Category Tokens
# ----------------------------------------------------------------
# skills-eval/SKILL.md 4,521 medium 1,180
# modular-skills/SKILL.md 3,892 medium 985
# ...
Get a bird's-eye view of your entire skill collection's context efficiency:
/context-report ~/.claude/skills
Before publishing a plugin, validate all skills are within optimal bounds:
/context-report ./skills
Identify which skills need the most attention for modularization.
When used with --estimate, provides detailed per-file token breakdown:
--include-dependencies)/context-report --estimate skills/modular-skills/SKILL.md
# Output:
# === skills/modular-skills/SKILL.md ===
# Total tokens: 1,847
# Component breakdown:
# Frontmatter: 45 tokens
# Body content: 1,402 tokens
# Code blocks: 400 tokens
# === Recommendations ===
# GOOD: Optimal token range (800-2000 tokens)
Complements other commands:
/analyze-skill - Deep dive on individual files/skills-eval - Quality and compliance scoring# Directory report mode
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/context_optimizer.py report "${1:-.}"
# Token estimation mode (--estimate flag)
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/token_estimator.py --file "${1:-.}"