skill-health-check

Audit SKILL.md files and related instruction artifacts for inconsistencies and missing metadata.

3|Updated Dec 15, 2025
One-click install
npx skills add https://github.com/u9401066/template-is-all-you-need --skill skill-health-check-u9401066
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-health-check
Source: https://github.com/u9401066/template-is-all-you-need/tree/main/.claude/skills/skill-health-check
Command: npx skills add https://github.com/u9401066/template-is-all-you-need --skill skill-health-check-u9401066

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects drift, missing metadata, stale versions, and inconsistencies between SKILL.md files, copilot-instructions, chatmodes, and bylaws so maintainers can trust their skill catalog and related documentation.

Core Features & Use Cases

  • Repository-wide Skill Audit: Scans .claude/skills, validates SKILL.md frontmatter, records versions and last modified times, and identifies missing or malformed entries.
  • Instruction & Chatmode Synchronization: Compares .github/copilot-instructions.md and chatmode definitions against actual skills to find omissions or mismatched trigger phrases.
  • Dependency & Freshness Analysis: Builds a dependency graph, detects broken or circular dependencies, and flags skills that need updating based on configurable age thresholds.
  • Use Case: Run before release or as a pre-commit hook to produce a structured health report summarizing issues and suggested fixes.

Quick Start

Run a skill health check across the repository to generate a comprehensive Skill & Instruction health report.

Frequently Asked Questions about skill-health-check

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

FAQPage Schema
How do I audit SKILL.md files for missing frontmatter and stale versions?

To audit SKILL.md files, run a repository-wide health check to validate frontmatter fields, record versions, and identify missing or malformed entries. This generates a structured report highlighting staleness, metadata drift, and suggested remediation steps for maintainers.

How do I synchronize copilot-instructions with my actual claude skills?

Synchronize copilot-instructions by comparing .github/copilot-instructions.md and chatmode definitions against actual skills. This detects omissions or mismatched trigger phrases, ensuring your instruction artifacts align with your skill catalog during repository maintenance.

What is the best way to detect broken or circular dependencies in a skill catalog?

Detect broken dependencies by running a dependency and freshness analysis that builds a dependency graph across your skills. This flags broken or circular dependencies and identifies skills needing updates based on configurable age thresholds.

Can I run a skill health check as a pre-commit hook?

Yes, you can run a skill health check as a pre-commit hook or before a release. It scans .claude/skills, validates SKILL.md frontmatter, and produces a structured health report summarizing inconsistencies, staleness, and suggested fixes to block problematic commits.

Does a skill health check validate bylaws and chatmode definitions?

Yes, a skill health check validates bylaws and chatmode definitions by comparing them against actual skills. It detects drift, missing metadata, and inconsistencies between SKILL.md files, chatmodes, and bylaws so maintainers can trust their skill catalog and documentation.