with one click
cd-content-audit
// Validate structure, voice, front matter, and cross-references for CD migration site content pages
// Validate structure, voice, front matter, and cross-references for CD migration site content pages
Audit and update the curated persona symptom pages (for-developers.md, for-agile-coaches.md, for-managers.md) when symptoms or anti-patterns are added, removed, or moved. Use this skill whenever new symptom or anti-pattern pages are created, when existing pages are deleted or reorganized, after running /cd-symptom-page or /cd-anti-pattern-page, or when the user asks to update the persona reading lists. Also use proactively at the end of any session that added or changed symptom content.
Generate a complete CD migration facilitator chatbot setup from the beyond.minimumcd.org site content. Use this skill whenever a user wants to create a chatbot, assistant, or guide that teams can use to navigate the CD migration journey — especially when they mention facilitating workshops, helping teams self-diagnose delivery problems, or guiding teams through continuous delivery adoption. Also use this when someone asks "how can teams use this site interactively" or "can we make a bot from this". Invoke proactively any time the user is thinking about team enablement, self-service CD coaching, or turning site content into an interactive guide.
Generate SVG diagrams for the CD migration documentation site (beyond.minimumcd.org). Use this skill whenever the user asks for a diagram, visual, workflow illustration, before/after comparison, or any figure to embed in a content page. Also use it when adding a diagram would meaningfully improve a content page being written or edited, even if the user has not explicitly asked for one. This skill is the single source of truth for the site's diagram color palette, layout conventions, and SVG output format.
Compare documentation against CD principles and practices from continuousdelivery.com and minimumcd.org, identifying gaps, misalignments, and improvement opportunities
Generate guide pages for the Migrate to CD section following the standard template
Generate symptom pages for the CD migration guide following the standard template
| name | cd-content-audit |
| description | Validate structure, voice, front matter, and cross-references for CD migration site content pages |
| user_invocable | true |
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.
tech-writing-review) or glossary linking (glossary-link).page-templates.md in this skill directory for canonical values and page structures.ERROR (must fix), WARNING (should fix), INFO (awareness only).Compare the file's heading structure against the required template for its page type.
Anti-pattern pages:
## What This Looks Like exists## Why This Is a Problem exists with required H3 subsections in order:
### It reduces quality### It increases rework### It makes delivery timelines unpredictable### Impact on continuous delivery (must be last H3 under this H2)## How to Fix It exists with at least one ### Step N: subsection containing a week number## Measuring Progress exists and contains a table## Related Content exists and contains at least one link{{% pageinfo %}} block exists after front matterSymptom pages:
## What you are seeing exists (note lowercase)## Common causes exists with 2-5 H3 subsections**Read more:** followed by a link## How to narrow it down exists with a numbered listGuide pages:
{{% pageinfo %}} block exists with phase indicatorSeverity: Missing required sections are ERROR. Missing optional elements are WARNING.
Anti-pattern pages:
title: required, non-empty - ERROR if missinglinkTitle: required, non-empty - ERROR if missingweight: required, positive integer - ERROR if missingcategory: required, must be one of 7 canonical values - ERROR if missing or invalidrisk_level: required, must be one of critical, high, medium, low - ERROR if missing or invaliddescription: required, under 160 characters - ERROR if missing, WARNING if over 160 charstags: required, array, each from allowed vocabulary of 11 tags - ERROR if missing, WARNING if tag not in vocabularySymptom pages:
title: required - ERROR if missinglinkTitle: required - ERROR if missingdescription: required, under 160 characters - ERROR if missing, WARNING if over 160 charstags: required, array, each from allowed vocabulary - ERROR if missing, WARNING if tag not in vocabularycategory or risk_level - WARNING if presentGuide pages:
title: required - ERROR if missinglinkTitle: required - ERROR if missingweight: required - ERROR if missingdescription: required, under 160 characters - ERROR if missing, WARNING if over 160 charscategory, risk_level, or tags - WARNING if presentERROR if target does not exist.anti-patterns/. Severity: ERROR if pointing elsewhere.migrate-to-cd/ or reference/. Severity: WARNING if pointing to other anti-pattern or symptom pages (these are not wrong but may indicate a missed guide link).under-construction/. Severity: INFO (these are intentional drafts, just surface them).Scan for inconsistent usage within each file:
WARNINGINFO\u2013 (endash) or \u2014 (emdash) characters. Severity: ERRORERRORFor each file, report:
## [file path]
Page type: [anti-pattern | symptom | guide]
### Errors (N)
- [CHECK_CATEGORY] description of issue (line N)
### Warnings (N)
- [CHECK_CATEGORY] description of issue (line N)
### Info (N)
- [CHECK_CATEGORY] description of issue (line N)
---
If a file has no findings at any severity level, report:
## [file path]
Page type: [type]
No issues found.
At the end, report a summary:
## Summary
Files audited: N
Errors: N (across N files)
Warnings: N (across N files)
Info: N (across N files)
_index.md files, triage.md, and for-*.md files (these have different structures)./tech-writing-review - that skill handles passive voice, hedging, paragraph length, and reader experience.