skill-stocktake

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

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/Femad-6/my-skills --skill skill-stocktake-femad-6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-stocktake
Source: https://github.com/Femad-6/my-skills/tree/main/.github/skills/skill-stocktake
Command: npx skills add https://github.com/Femad-6/my-skills --skill skill-stocktake-femad-6

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Over time, collections of Claude skills and slash commands accumulate stale, overlapping, or low-quality entries, and manually reviewing dozens of skill files is slow and inconsistent. This Skill automates the audit with a fixed quality checklist, holistic AI judgment, and cached results so repeat reviews only re-evaluate what changed. ## Core Features & Use Cases - Two audit modes: Quick Scan re-evaluates only skills changed since the last run using mtime comparison against results.json, while Full Stocktake inventories and evaluates every skill in global and project-level .claude/skills directories. - Structured verdicts: Each skill receives a Keep, Improve, Update, Retire, or Merge verdict with a self-contained reason, evaluated in batches of roughly 20 skills per subagent with resumable progress tracking. - Usage-aware inventory: The scan script enriches each skill with 7-day and 30-day usage counts from an observations JSONL log, plus frontmatter metadata and UTC modification times. - Use Case: Run a Full Stocktake across 80 installed skills, receive a summary table of verdicts, then confirm which overlapping skills to merge and which outdated ones to retire. ## Quick Start Ask the AI to run a full skill stocktake audit of all installed Claude skills and produce 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 Claude skills for quality and overlap?

Run the skill-stocktake command, which inventories all skills in global and project .claude/skills directories, then evaluates each against a checklist covering overlap, freshness, and usage. Results are returned as Keep, Improve, Update, Retire, or Merge verdicts with reasons.

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

Quick Scan compares file modification times against the cached results.json and re-evaluates only changed or new skills, taking 5-10 minutes. Full Stocktake evaluates every skill from scratch and takes 20-30 minutes.

Does skill-stocktake evaluate project-level skills?

Yes, it scans both ~/.claude/skills and the .claude/skills directory of the current working directory. Run it from a project root to include that project's skills; otherwise only global skills are evaluated.

Can a long skill audit be resumed after interruption?

Yes, intermediate results are saved to results.json with an in_progress status after each batch of roughly 20 skills. On the next run, evaluation resumes from the first unevaluated skill instead of starting over.

Does skill-stocktake delete skills automatically?

No, all archive and delete operations require explicit user confirmation. The command presents detailed justification for each Retire or Merge verdict, including the defect found and what covers the same need, before any action.