skill-stocktake

Audit skill directories for valid SKILL.md frontmatter and template synchronization.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/cheafi/Trading-bot-CC --skill skill-stocktake-cheafi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-stocktake
Source: https://github.com/cheafi/Trading-bot-CC/tree/main/.github/skills/skill-stocktake
Command: npx skills add https://github.com/cheafi/Trading-bot-CC --skill skill-stocktake-cheafi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly discover which skills exist, which are out of sync with templates, and which may be stale or incomplete so your skill catalog stays reliable.

Core Features & Use Cases

  • Inventory auditing: Detect missing SKILL.md files across .github/skills/ directories.
  • Frontmatter validation: Check required YAML fields and enforce v1.0.5 conventions like argument-hint and correct naming.
  • Template sync & coverage checks: Compare skills between .github/skills/ and vscode-omg/resources/templates/skills/, and cross-check against copilot-instructions.md to find gaps.
  • Quality scoring & reporting: Produce a structured health report including severity for issues such as mismatched names, missing sections, stubs, and orphan templates.

Quick Start

Run the skill stocktake to produce a health report for your current skill inventory and highlight any missing, outdated, or unsynchronized skills.

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 GitHub skill inventory for missing or outdated SKILL.md files?

To audit a GitHub skill inventory, scan the `.github/skills/` directories for valid SKILL.md frontmatter, detect missing files, and categorize coverage gaps into a structured health report highlighting outdated or incomplete entries.

What does YAML frontmatter validation for skills check in a repository?

YAML frontmatter validation checks required fields and enforces v1.0.5 conventions, such as correct naming constraints and the `argument-hint` field, to ensure your skill catalog meets governance standards and maintains structured metadata.

How do I check if my skill templates are synchronized with the documented catalog?

Template synchronization is checked by comparing skills between `.github/skills/` and `vscode-omg/resources/templates/skills/`, then cross-referencing with `copilot-instructions.md` to identify mismatches, orphan templates, and coverage gaps.

When should I run a skill inventory health audit during development?

Run a skill inventory health audit during periodic maintenance, after repository refactors, or as a pre-migration check before adding new skills to ensure your catalog remains reliable, synchronized, and free of stubs or orphaned templates.

Can I detect staleness and quality issues in a GitHub skill directory?

Yes, staleness and quality issues are detected by applying frontmatter rule validation and template diffing, which produces a health report scoring severity for mismatched names, missing sections, stubs, and orphan templates.

What is the best way to find coverage gaps in a skill catalog before migration?

The best way to find coverage gaps is to cross-check the existing skill inventory against the documented catalog in `copilot-instructions.md`, validating frontmatter and diffing templates to produce a categorized health report before migration.