qmd-consistency-check

mikepsinn 的头像作者 mikepsinn

Checks QMD files for consistency, variable references, and cross-format links. Use after batch editing multiple files or before commits.

📖 中文导读:Checks QMD files for consistency, variable references, and cross-format links. Use after batch editing multiple files or before commits. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

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.

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