skill-drift-audit-skill
NewAudit SKILL.md drift against repo docs, scripts, examples, and release notes
Summary
md file against a repository's README, docs, scripts, examples, and release notes to detect drift and inconsistencies.
- It helps developers maintain accurate and up-to-date skill documentation by generating actionable reports.
Overview
Skill Drift Audit Skill
When To Use
Use this skill when reviewing or refreshing an agent-skill repo and you need evidence that SKILL.md still matches README, docs, package scripts, examples, and release notes.
Required Inputs
- •A local repo path containing
SKILL.md. - •Optional README, docs, package metadata, changelog, and release-candidate notes.
Side-Effect Boundaries
scan reads local files and writes reports to stdout. plan writes only to an explicit --output path. The skill must not rewrite SKILL.md, call external services, publish packages, or modify release artifacts by default.
Approval Requirements
Ask for explicit approval before editing durable skill instructions, deleting examples, publishing packages, or sending audit reports outside the local workspace.
Examples
skill-drift-audit scan . --format markdown
skill-drift-audit scan fixtures/stale-skill --format json
skill-drift-audit plan . --output tmp/skill-drift-plan.mdValidation Workflow
Run these before relying on the skill:
npm run check
npm test
npm run smoke
npm run package:smokeInstall & Usage
mkdir -p .claude/skillsmkdir -p .claude/skills && curl -o .claude/skills/skill-drift-audit-skill.md https://raw.githubusercontent.com/rogerchappel/skill-drift-audit-skill/main/SKILL.md/skill-drift-audit-skillUse Cases
Usage Examples
/skill-drift-audit-skill scan . --format markdown
/skill-drift-audit-skill scan fixtures/stale-skill --format json
/skill-drift-audit-skill plan . --output tmp/skill-drift-plan.md
Security Audits
Frequently Asked Questions
What is skill-drift-audit-skill?
This skill audits a SKILL.md file against a repository's README, docs, scripts, examples, and release notes to detect drift and inconsistencies. It helps developers maintain accurate and up-to-date skill documentation by generating actionable reports.
How to install skill-drift-audit-skill?
To install skill-drift-audit-skill: create the skills directory (mkdir -p .claude/skills), then run: mkdir -p .claude/skills && curl -o .claude/skills/skill-drift-audit-skill.md https://raw.githubusercontent.com/rogerchappel/skill-drift-audit-skill/main/SKILL.md. Finally, /skill-drift-audit-skill in Claude Code.
What is skill-drift-audit-skill best for?
skill-drift-audit-skill is a skill categorized under General. Created by rogerchappel.
What can I use skill-drift-audit-skill for?
skill-drift-audit-skill is useful for: Review a SKILL.md file before a release to ensure it matches the latest README and docs.; Detect outdated examples or scripts in SKILL.md after a major repo refactor.; Validate that release notes align with the current skill behavior described in SKILL.md.; Generate a drift report for a stale skill repository to plan documentation updates.; Compare SKILL.md against package scripts to verify all commands are documented correctly.; Audit multiple skill repos in a CI pipeline to enforce documentation consistency..