skill-stocktake

name	skill-stocktake
description	Audit all installed skills, commands, agents, and hooks for quality, freshness, and duplication. Use periodically to maintain a clean plugin.

Skill Stocktake

Audit Claude skills and commands through quality assessment.

Operating Modes

• Quick Scan — Recently modified skills only (5-10 minutes). Activates when results cache exists.
• Full Stocktake — Comprehensive review of everything (20-30 minutes). Runs when cache is absent or explicitly requested.

Scanning Scope

• Global skills: ~/.claude/skills/
• Project skills: {cwd}/.claude/skills/
• Plugin skills: current plugin's skills/ directory
• Commands: current plugin's commands/ directory
• Agents: current plugin's agents/ directory

Evaluation Process

Phase 1: Inventory

Scan all skill files, extract metadata (name, description, origin, modification date).

Phase 2: Evaluate

For each skill, assess against this checklist:

• Content overlap — Does this duplicate another skill?
• Technical freshness — Are referenced tools/APIs/patterns current?
• Usage patterns — Is this skill actually invoked by workflows?
• Uniqueness — Does this provide value no other skill covers?

Phase 3: Summarize

Present results in a table with verdicts.

Phase 4: Recommend

Consolidate findings with actionable recommendations.

Verdict Categories

Verdict	Meaning
Keep	Useful and current
Improve	Worth retaining with specific enhancements
Update	Outdated references need refreshing
Retire	Low value — name what replaces it
Merge into [target]	Substantial duplication — name the target

Reason fields must be evidence-based, restating specific defects rather than generic labels.

Results Cache

Results stored at ~/.claude/skills/skill-stocktake/results.json:

• Evaluation timestamp (UTC)
• Mode (quick/full)
• Per-skill verdicts with reasoning

When to Run

• After adding new skills or commands
• Quarterly maintenance
• When workflows feel slow or bloated
• After upgrading plugin versions