validate-doc

Dispatches parallel review-doc subagents to validate markdown documents across multiple focus areas.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multi-perspective document reviews is slow and error-prone when done sequentially. This Skill fans out parallel review subagents for a markdown artifact, assigns sequential review file numbers, and returns a consolidated per-reviewer summary. ## Core Features & Use Cases - Parallel review dispatch: Launches one review-doc subagent per focus (e.g., accuracy, architecture, depth, dx) in a single batch, each writing an rNN-{focus}.md file alongside the artifact. - Sequential file numbering: Derives the next free NN from existing rNN-*.md files, preventing gaps, collisions, and overwrites. - Error surfacing: Reports landed or errored status per reviewer without retrying or silently swallowing failures. - Use Case: During a create-plan workflow, validate a plan chapter by dispatching reviewers for accuracy, architecture, integration, dx, and scope, then receive a summary of which review files landed. ## Quick Start Validate the chapter file 03-architecture.md with the focus list accuracy, architecture, and dx for iteration 2.

Frequently Asked Questions about validate-doc

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

FAQPage Schema
How do I validate a markdown document with multiple reviewers?▼

Provide the artifact path, an ordered focus list, an iteration number, and optionally a review directory. The skill dispatches one review-doc subagent per focus in parallel, each writing an rNN-{focus}.md file, then returns a summary of results.

How are review file numbers assigned for rNN files?▼

The skill globs existing rNN-*.md files in the review directory, takes the maximum NN plus one as the base (or 1 if none exist), and assigns consecutive numbers to each focus in input-list order. Any filename collision aborts the whole batch.

What focus lists do lifecycle skills use for document review?▼

Conventional baselines are accuracy, architecture, depth, dx for create-spike; accuracy, architecture, integration, dx, scope for create-plan; and accuracy, comprehensiveness, clarity for archive-project. Callers may extend or trim the list per chapter.

What happens when a review subagent fails during validation?▼

The failed focus is recorded with status errored and its error message in the returned summary. The skill never retries, auto-bypasses, or silently swallows errors; the calling skill or captain decides whether to retry, skip, or stop.

Can I dispatch persona agents like qa or architect for document review?▼

No. The only subagent type dispatched is review-doc, which reads the focus brief and adopts the named persona's lens internally. Dispatching persona agents directly is an explicit failure mode the skill forbids.