wiki-lint

Installation
SKILL.md

Lint — Wiki health check

Follow wiki/CONVENTIONS.md for format conventions, frontmatter, and links.

Language

Write the artifact in the user's language. Apply correct grammar and any required diacritics or script-specific characters. If the user's language is unclear, ask before generating output.

Query language alignment

For semantic lint checks, query in the wiki language. Determine it from .wiki-guardrails.yml (query_language or language), then from wiki frontmatter/index if guardrails are absent. Preserve exact names and code identifiers. Reports to the user should remain in the user's language.

Retrieval — prefer QMD when available

Use QMD (local hybrid search) for the semantic checks (orphans, missing cross-refs, contradictions). Setup is one-time per repo — see docs/wiki/qmd-setup.md. For purely structural checks (frontmatter, broken links), grep/glob is fine and faster.

  • Use mcp__qmd__query (MCP) or qmd query --json --files (CLI) when looking for semantic neighbors of a page (orphan candidates, contradiction candidates, missing cross-refs).
  • Always pass an intent: line to QMD describing what you are looking for.
  • Do not run qmd embed / qmd update automatically — flag the need at the end of the lint if the wiki has changed and the index is stale.
Related skills

More from djalmajr/essential-skills

Installs
14
First Seen
Apr 12, 2026