Audit Skills

Overview

Run an on-demand audit of every skill in skills/ against ASDLC alignment (Factory Architecture, Standardized Parts, Quality Control) and Agent Skills format. Produce one markdown report in .plans/ (e.g. .plans/skill-audit-YYYY-MM-DD.md) for human review. The skill does not modify any file in skills/.

Definitions

• skills/: Project directory containing one folder per skill, each with SKILL.md (source of truth for this repo).
• Agent Skills format: SKILL.md with YAML frontmatter (name, description, disable-model-invocation) and required body sections—Overview, Definitions, Prerequisites, Steps, Tools, Guidance (per AGENTS.md).
• ASDLC pillars: Factory Architecture (skill stations, phase boundaries), Standardized Parts (schemas, AGENTS.md), Quality Control (gates, validation).
• Audit report path: Single file per run in .plans/ with date stamp, e.g. .plans/skill-audit-2026-02-16.md.
• Spec: specs/skill-audit/spec.md — Blueprint (methodology, skills in scope, anti-patterns) and Contract (DoD, deliverable structure).

Prerequisites

• Spec and AGENTS.md: specs/skill-audit/spec.md and AGENTS.md must exist at repo root. If either is missing, STOP and report.
• skills/ present: Directory skills/ with at least one */SKILL.md. If empty or missing, STOP and report.
• Read-only: Do not edit, move, or delete any file under skills/. Only create or overwrite one file in .plans/.