Skill

wiki-markdown-structure-gate

Validates wiki markdown structure before publishing, blocking malformed tables, escaped wiki-links, unbalanced code/callout fences, heading hierarchy issues, and missing TOC on manual-TOC platforms with 4+ headings.

Markdown

Javascript

Bash

documentation

code-quality

npx claudepluginhub bordenet/superpowers-plus --plugin superpowers-plus

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Block structurally broken wiki markdown before publish. Stage 5.5 in

SKILL.md

Similar Skills

using-superpowers

185.1k

Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.

3 files

superpowers

Stats

Stars6

Forks1

Last CommitMay 1, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

wiki-markdown-structure-gate

Block structurally broken wiki markdown before publish. Stage 5.5 in wiki-orchestrator. Validator: tools/wiki-markdown-validate.js.

When to Use

Before publishing any wiki page — run as Stage 5.5 in wiki-orchestrator
When asked to audit or fix wiki markdown structure, table syntax, heading hierarchy, or broken code fences
Triggered by: audit wiki markdown structure, fix malformed wiki table, wiki formatting gate, broken admonition block

Procedure

# On generated draft
node tools/wiki-markdown-validate.js draft.md
# On fetched body (pipe stdin, strip YAML if present)
tools/wiki-read.sh get "$PAGE_ID" | jq -r '.text' \
  | node tools/wiki-markdown-validate.js --stdin

Exit 0 → pass (publish allowed). Non-zero → BLOCK: read stderr for line numbers, fix, re-run. Do not publish until exit 0.

What the gate blocks

Check	Block when
H1 heading	Any `# Title` line in the body — Outline renders the page title automatically; H1 creates a redundant duplicate
Table structure	Missing separator row, inconsistent cell counts, stray `\|` row
Escaped wiki-links	`\[title\[/doc/...` and similar round-trip artifacts
Code fences	Unbalanced backtick (```) or tilde (`~~~`) fences
Callout fences	Unbalanced `:::info` / `:::warning` / similar
Heading hierarchy	H3+ before any H2, or a level skipped
Missing TOC	`toc_behavior=manual` and ≥4 body H2/H3 (outside fences) and no adapter `toc_syntax`

A generic Contents heading does not satisfy the TOC rule — only the adapter's declared toc_syntax counts. Outline example: a +++ toggle whose first line contains Table of contents. If no adapter config is resolvable, the gate fails closed as misconfiguration.

Advisory (WARN, do not block)

Very wide tables · dense cells with many links · duplicate manual TOCs.

Enforcement notes

Canonical gate invoked by wiki-orchestrator Stage 5.5
Also runs post-fetch inside tools/wiki-write.sh verification step
Never waive a BLOCK finding — fix or halt

Failure modes

Failure	Fix
Structural checks treated as advisory	Treat BLOCK as halt; only WARN is advisory
Only links/secrets checked before publish	Run this gate (Stage 5.5) on every draft
Long page published without TOC	Insert adapter `toc_syntax` after intro; re-run
Heading count included fenced code	Validator already excludes fences; re-run if you hand-rolled the count

Companion skills

wiki-orchestrator (invokes this at Stage 5.5) · wiki-content-coherence · wiki-debunker