| name | qmd-consistency-check |
| description | Checks QMD files for consistency, variable references, and cross-format links. Use after batch editing multiple files or before commits. |
| allowed-tools | ["Read","Grep","Glob","Bash"] |
QMD Consistency Checker
What This Does
Validates entire book for:
- Variable references (all
{{< var ... >}} are valid)
- Cross-file links use
.qmd extensions
- Referenced files exist in
_quarto.yml
- No hardcoded values that should be variables
- Consistent formatting and style
- No em-dashes (should be periods, commas, or parentheses)
Process
1. Find all QMD files
find knowledge -name "*.qmd" -type f
2. Check all variable references
grep -r "{{< var" --include="*.qmd" knowledge/
Compare against _variables.yml to verify all variables exist.
3. Check cross-file links
grep -r "\](.*\.html" --include="*.qmd" knowledge/
All links should use .qmd not .html for cross-format compatibility.
4. Find hardcoded values
grep -rE '\$[0-9,]+(\.[0-9]+)?[MBK]?' --include="*.qmd" knowledge/
Check if these values exist as variables in _variables.yml.
5. Check for em-dashes
grep -r "—" --include="*.qmd" knowledge/
Linter requires replacing em-dashes with periods, commas, or parentheses.
Expected Outcome
After running this skill:
- All variable references are valid
- All links use cross-format compatible
.qmd extensions
- No broken cross-file references
- Hardcoded values are flagged for review
- Style issues are identified
