eval-skills

# Skill Evaluator Discover all skills in the project, score them across 6 criteria, and infer the appropriate `effort` level based on content analysis. ## When to Use - New project: run once to establish baseline quality - Before committing a skill to a team repo - After bulk-importing skills from another project - When adding `effort` fields for the first time (v2.1.80+) ## What Gets Audited All `SKILL.md` files and flat `.md` files found in: - `.claude/skills/**` - `~/.claude/skills/**` (if requested) - Any path passed as argument: `/eval-skills ./my-skills-dir` --- ## Pre-Check: Use the Official Validator Before scoring manually, run the official CLI validator first — it catches structural issues in seconds: ```bash # Install (one-time) uv tool install skills-ref # Validate a skill directory skills-ref validate ./my-skill # Validate all skills in project find .claude/skills -name "SKILL.md" -exec dirname {} \; | xargs -I{} skills-ref validate {} ``` If `skills-ref` passes cleanly, proceed to quality scoring below. --- ## Scoring Criteria (14 pts per skill) | # | Criterion | Max | What is checked | |---|-----------|-----|-----------------| | 1 | **name** | 1 | Present, lowercase, hyphens only, matches directory name | | 2 | **description** | 2 | Present + has "Use when" / "when to" / trigger phrasing | | 3 | **allowed-tools** | 2 | Present + not overly broad (Bash without scoping when read-only) | | 4 | **effort** | 3 | Present (1pt) + appropriate for content...