validate-document-artifacts
Installation
SKILL.md
Skill: Validate Document Artifacts
Purpose
Check that documents under docs/ conform to the project's artifact norms (or default spec/artifact-contract.md). Emit a findings list for path, naming, and front-matter violations so users can remediate.
Core Objective
Primary Goal: Produce a findings list of documents that violate artifact norms, with Location, Severity, Title, Description, and Suggestion for each finding.
Success Criteria (ALL must be met):
- ✅ Norms resolved: Project norms read from
docs/ARTIFACT_NORMS.mdor.ai-cortex/artifact-norms.yaml; fallback to spec/artifact-contract.md - ✅ Docs scanned: All relevant Markdown under
docs/(or specified scope) enumerated - ✅ Artifact type inferred: Per file, inferred from path pattern or front-matter
artifact_type - ✅ Compliance checked: Path, naming, front-matter validated against norms
- ✅ Findings emitted: Each violation as a finding with Location, Category, Severity, Title, Description, Suggestion