validate-document-artifacts
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
More from nesnilnehc/ai-cortex
review-codebase
Review given file/dir/repo for current-state code organization: module boundaries, design patterns, cross-module dependencies, tech debt, and interface stability. Scope-only atomic skill; output is a findings list.
106review-vue
Review Vue 3 code for Composition API, reactivity, components, state (Pinia), routing, and performance. Framework-only atomic skill; output is a findings list.
94review-diff
Review only git diff for impact, regression, correctness, compatibility, and side effects. Scope-only atomic skill; output is a findings list for aggregation.
91review-java
Review Java code for language and runtime conventions: concurrency, exceptions, try-with-resources, API versioning, collections and Streams, NIO, and testability. Language-only atomic skill; output is a findings list.
84review-architecture
Review code for architecture: module and layer boundaries, dependency direction, single responsibility, cyclic dependencies, interface stability, and coupling. Cognitive-only atomic skill; output is a findings list.
83review-security
Review code for security: injection, sensitive data, auth, dependencies, config, and crypto. Atomic skill; output is a findings list.
74