skill-stocktake

Audit Claude skills and commands against a quality checklist with cached incremental re-evaluation.

5|Updated Jul 8, 2019
One-click install
npx skills add https://github.com/rinchsan/dotfiles --skill skill-stocktake-rinchsan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-stocktake
Source: https://github.com/rinchsan/dotfiles/tree/main/.claude/skills/skill-stocktake
Command: npx skills add https://github.com/rinchsan/dotfiles --skill skill-stocktake-rinchsan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve? Over time, accumulated Claude skills and commands become stale, duplicated, or outdated, and manually reviewing each one is tedious and inconsistent. This Skill automates the audit process with a structured checklist, AI-based holistic judgment, and cached results so unchanged skills are not re-evaluated. ## Core Features & Use Cases - Quick Scan mode: Compares file modification times against the cached results.json and re-evaluates only changed or new skills, completing in minutes. - Full Stocktake mode: Inventories all global and project-level skills, then evaluates them in batched subagent runs against a quality checklist covering overlap, freshness, usage frequency, and actionability. - Actionable verdicts: Each skill receives a Keep, Improve, Update, Retire, or Merge verdict with a self-contained reason, followed by a consolidation phase that requires explicit user confirmation before any deletion. - Use Case: Run a quarterly review of your ~/.claude/skills directory to identify skills superseded by newer ones, outdated technical references, and overlapping content that should be merged. ## Quick Start Run /skill-stocktake from a project directory to audit all global and project-level Claude skills and receive a verdict table with consolidation recommendations.

Frequently Asked Questions about skill-stocktake

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my Claude skills for quality and staleness?

Run the /skill-stocktake command, which inventories all skills in ~/.claude/skills and the current project's .claude/skills directory, then evaluates each against a checklist covering overlap, freshness, usage frequency, and actionability. Results include a verdict and reason per skill.

What is the difference between Quick Scan and Full Stocktake modes?

Quick Scan runs when a results.json cache exists and re-evaluates only skills whose files changed since the last run, taking 5-10 minutes. Full Stocktake evaluates every skill from scratch, takes 20-30 minutes, and is triggered when no cache exists or by passing the full argument.

Can I audit skills for only one specific project?

Yes. Change into the project's root directory before running /skill-stocktake, and the scan auto-detects that project's .claude/skills directory alongside the global skills. If the project has no .claude/skills directory, only global skills are evaluated.

Does skill-stocktake delete skills automatically?

No. Retire and Merge verdicts are presented with detailed justification covering the defect found, the alternative that covers the need, and the impact of removal. Archive or delete operations always require explicit user confirmation before any action.

What happens if a full stocktake is interrupted mid-run?

Progress is saved to results.json with status in_progress after each batch of roughly 20 skills. On the next run, the command detects the in_progress status and resumes from the first unevaluated skill instead of starting over.