| name | cd-content-audit |
| description | Validate structure, voice, front matter, and cross-references for CD migration site content pages |
| user_invocable | true |
CD Content Audit
Role: worker. This skill validates content files and reports findings.
It does not modify files.
Validate content pages for structural compliance, front matter correctness, tone and voice, cross-references, and terminology consistency.
Constraints
- Read-only. Do not modify files. Report findings only.
- Be concise. Output the report and summary. No preambles or per-file narration.
- Follow the output format. Use the structured format below for every audit.
- Delegate out-of-scope concerns. Do not check writing quality (
tech-writing-review) or glossary linking (glossary-link).
Instructions
- Accept file paths or globs as arguments. If no arguments are given, ask which files to audit.
- Read
page-templates.md in this skill directory for canonical values and page structures.
- Detect page type from the file path (anti-pattern, symptom, or guide). If the file does not match a known page type, report it and skip.
- For each file, run all checks described below.
- Report findings grouped by file, then by check category. Use severity levels:
ERROR (must fix), WARNING (should fix), INFO (awareness only).