skills-eval

# Skills Evaluation and Improvement ## Table of Contents 1. [Overview](#overview) 2. [Quick Start](#quick-start) 3. [Evaluation Workflow](#evaluation-workflow) 4. [Evaluation and Optimization](#evaluation-and-optimization) 5. [Resources](#resources) ## Overview This framework audits Claude skills against quality standards to improve performance and reduce token consumption. Automated tools analyze skill structure, measure context usage, and identify specific technical improvements. Run verification commands after each audit to confirm fixes work correctly. The `skills-auditor` provides structural analysis, while the `improvement-suggester` ranks fixes by impact. Compliance is verified through the `compliance-checker`. Runtime efficiency is monitored by `tool-performance-analyzer` and `token-usage-tracker`. ## Quick Start ### Basic Audit Run a full audit of all skills or target a specific file to identify structural issues. ```bash # Audit all skills make audit-all # Audit specific skill make audit-skill TARGET=path/to/skill/SKILL.md ``` ### Analysis and Optimization Use `skill_analyzer.py` for complexity checks and `token_estimator.py` to verify the context budget. ```bash make analyze-skill TARGET=path/to/skill/SKILL.md make estimate-tokens TARGET=path/to/skill/SKILL.md ``` ### Improvements Generate a prioritized plan and verify standards compliance using `improvement_suggester.py` and `compliance_checker.py`. ```bash make improve-skill TARGET=path/to/skill/SKILL.m...