docs-steward

Purpose

Run external markdown formatters and yamllint on existing repo docs; emit findings as NDJSON on stdout; apply the chosen formatter's --fix / --write mode on explicit approval.

Is / is-not

• Is: an orchestrator that runs markdown formatters + yamllint on existing repo docs and emits findings.
• Is not: a doc generator, a code editor, a code reviewer, a native markdown parser. Whatever checks the chosen formatter performs are the checks that fire — the skill adds no rules of its own beyond the bundled fallback configs (step 4).

The skill respects whatever formatter / linter config the repo declares; an undeclared concern gets the bundled fallback where the skill ships one, tool defaults otherwise.

Supported file types

• Markdown (.md, .markdown) via md-audit.py / md-format.py / md-fix.py — driven by the chosen formatter.
• YAML frontmatter and fenced YAML blocks inside markdown via md-audit-frontmatter.py — driven by yamllint.

No other file types are handled.