skill-drift-detector

Run an automated drift check that analyzes frontmatter descriptions and triggers across the catalog to prevent misrouting. It flags significant keyword overlap so you can resolve conflicting skills.

Skill drift occurs when Claude Code skills deviate from standards through missing triggers or oversized files. You audit it by running a nightly detector that checks frontmatter integrity, overlap, and progressive disclosure compliance across the directory.

Check SKILL.md frontmatter integrity by running a drift detector that enforces required fields. It scans the skill directory and flags any SKILL.md files missing the mandatory name or description attributes in their frontmatter.

Yes, you can generate a JSON drift report by running the detector from the repository root with the --json option. This outputs a structured report covering frontmatter integrity, overlap analysis, and progressive disclosure violations.

Flag oversized SKILL.md files by running a size and disclosure check that scans the skill directory. The detector identifies files exceeding limits and reports poor progressive disclosure compliance to reduce catalog bloat.

No, the drift detector requires no external dependencies to run. It operates directly on skill directories containing a SKILL.md frontmatter and optional resources like scripts, references, and assets folders.