What problem does it solve?
Maintaining AI agent skills in sync with their underlying source code is a manual, error-prone process that leads to outdated instructions, broken agent workflows, and wasted debugging time. This Skill automates drift detection to ensure skills always reflect the current state of their source code.
Core Features & Use Cases
- AST-Backed Structural Drift Detection: Traces all findings to actual code with file:line citations, eliminating hallucinations and ensuring every drift report is grounded in source truth.
- Severity-Graded Reporting: Classifies drift into CRITICAL/HIGH/MEDIUM/LOW levels with actionable remediation suggestions, so you can prioritize fixes based on impact.
- Adaptive Analysis Depth: Supports multiple forge tiers (Quick/Forge/Forge+/Deep) to match your tooling availability, plus specialized auditing for stack skills (code-mode and compose-mode) and upstream version drift detection.
- Use Case: A team maintaining multiple BMAD agent skills can run this audit in minutes to identify which skills are out of sync with recent source code changes, preventing broken agent behavior in production.
Quick Start
Use the skf-audit-skill to audit the bmad-agent-patterns skill for drift against its current source code and receive a prioritized remediation report.