What problem does it solve? It detects structural and semantic problems in Command and Skill definition files—such as broken Command→Skill references, invalid frontmatter, poor granularity, responsibility boundary violations, and Markdown syntax corruption—without modifying the diagnosed files, and records findings for later triage. ## Core Features & Use Cases - Semantic diagnosis of Skill structure: Evaluates reference validity, frontmatter, body structure, progressive disclosure, responsibility boundaries, canonical naming, and internal structure dependencies. - Distribution syntax health checks: Detects frontmatter duplication, duplicate headings, broken Markdown, references to nonexistent commands, encoding inconsistencies (UTF-8 BOM, mixed CRLF/LF), and responsibility description contradictions. - Finding classification and routing: Classifies each finding (false positive, pre-existing, fix target), presents recommended routes without auto-fixing, writes findings to .agentdev/inspect/inbox/, and persists them via git commit/push. - Use Case: Run the /agentdev/inspect-skills command after editing Skill definitions to receive a classified diagnostic report of structural issues, persisted as finding files for the inspect-promote workflow to triage. ## Quick Start Run the /agentdev/inspect-skills command to diagnose all Command and Skill definitions and generate a classified findings report.
