review-markdown-plan

Validate markdown implementation plans by section and annotate inline fixes.

8|1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/ccomkhj/skills --skill review-markdown-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-markdown-plan
Source: https://github.com/ccomkhj/skills/tree/main/review-markdown-plan
Command: npx skills add https://github.com/ccomkhj/skills --skill review-markdown-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents you from acting on a markdown plan that contains concrete execution flaws by validating steps and inserting only decisive inline fixes.

Core Features & Use Cases

  • Section-by-section validation: Groups related sections and checks sequencing, prerequisites, ownership, and execution risk.
  • Subagent cross-checking: Uses independent reviewers per group to reduce missed dependencies or ordering errors.
  • Conservative, trust-preserving annotations: Adds inline [Model name] notes only when a specific failure, data loss, or incorrect result is confident.
  • Plan annotation workflow: Returns annotated markdown or applies edits to a provided markdown file.

Quick Start

Ask an AI to review your markdown plan by section and annotate only the specific steps that will fail if followed as written, leaving the rest unchanged.

Frequently Asked Questions about review-markdown-plan

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

FAQPage Schema
How do I validate a markdown implementation plan for execution risks?

To validate a markdown implementation plan, group its sections into reviewable themes and run parallel validations to check sequencing, prerequisites, and handoffs. This process catches concrete execution flaws and inserts targeted inline annotations at the specific steps that will fail if followed as written.

What is a subagent review for markdown plans?

A subagent review uses independent reviewers per grouped section to cross-check your markdown plan. This parallel validation method reduces missed dependencies and ordering errors by filtering out speculative feedback and focusing only on confident execution flaws.

Can I use inline annotations to fix a rollout checklist?

Yes, you can apply inline annotations to fix a rollout checklist by inserting concise notes directly at the smallest affected unit. This conservative workflow leaves unchanged steps intact and only annotates specific failures, data loss risks, or incorrect results.

How do I check dependencies and prerequisites in a migration plan?

To check dependencies and prerequisites in a migration plan, validate the markdown file section by section. This catches incorrect sequencing and missing handoffs by applying parallel validations that target execution risks specific to your migration steps.

What is the best way to review a markdown plan without altering correct steps?

The best way to review a markdown plan without altering correct steps is to use conservative, trust-preserving annotations. This method filters out non-executable or speculative feedback and adds inline notes only when a specific failure, data loss, or incorrect result is confident.

Does this markdown review work for non-executable or speculative feedback?

No, this markdown review specifically filters out non-executable or speculative feedback. It focuses exclusively on concrete execution flaws by validating ordering, prerequisites, and ownership, ensuring that only confident, targeted fixes are annotated in your plan.