mj-agent-doc-validate

Validates mj-agent documentation frontmatter, wikilinks, and format compliance against Meta v2.1 standards.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/MJ-AgentLab/mj-agent --skill mj-agent-doc-validate-mj-agentlab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mj-agent-doc-validate
Source: https://github.com/MJ-AgentLab/mj-agent/tree/main/.claude/skills/mj-agent-doc-validate
Command: npx skills add https://github.com/MJ-AgentLab/mj-agent --skill mj-agent-doc-validate-mj-agentlab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It ensures every markdown document in the mj-agent docs tree conforms to the Meta v2.1, Code_Side v1.1, and Agent_Side v1.1 documentation standards before commits or PRs, catching schema violations, broken wikilinks, and format drift early. ## Core Features & Use Cases - Frontmatter schema validation: Runs scripts/check_frontmatter.py to verify required fields (type, summary, owner, created, updated, state, track) and the 4-value track enum. - Wikilink integrity checks: Runs scripts/check_wikilinks.py to confirm internal [[...]] links resolve, with living vs frozen archive path judgment per ADR-011. - Semi-automated OB checks: Reports PASS/FAIL/WARN/SKIP for OB1-OB5 quality dimensions (length, tense, content boundary, summary quality, internal consistency) plus track-specific A1-A14 checks. - Use Case: After editing a GUIDE document in docs/, run this skill to confirm frontmatter passes, all wikilinks resolve, and INDEX.md/CLAUDE.md sync requirements are flagged before opening a PR. ## Quick Start Ask the assistant to validate the documentation in the mj-agent repo by running the doc-validate checks on docs/ and report any FAIL or WARN items.

Frequently Asked Questions about mj-agent-doc-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate markdown documentation frontmatter in mj-agent?▼

Run uv run python scripts/check_frontmatter.py from the repo root. It scans all canonical docs and verifies the seven required frontmatter fields plus the state and 4-value track enums, reporting per-document violations.

How to check broken wikilinks in a markdown documentation repository?▼

Run uv run python scripts/check_wikilinks.py. It resolves internal [[...]] links across documents, handles relative paths, and applies living vs frozen archive rules per ADR-011, outputting unresolved links with file and line numbers.

What is the difference between mj-agent-doc-validate and mj-agent-flow-verify?▼

mj-agent-doc-validate performs interactive single-document or docs-subset schema and wikilink validation. mj-agent-flow-verify is the Stage 10 multi-domain command matrix (lint, mypy, pytest, docker) that calls the same scripts directly as Level A commands without entering this skill's interactive flow.

Does the doc validator automatically fix documentation violations?▼

No. It only reports PASS/FAIL/WARN/SKIP per check with repair guidance. Fixes are applied manually or via the mj-agent-doc-author skill, then validation is re-run until it passes.

When should documentation validation be skipped?▼

It may be skipped for typo-only fixes at user discretion and for changes under .claude/skills/, which are outside the scripts' SCAN_ROOTS and follow the ADR-013 native schema checked elsewhere.