checkmd

Generates and updates feature implementation plan documents from inline comments and Q&A discussions.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/nayounghye/my-claude-skills --skill checkmd-nayounghye
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: checkmd
Source: https://github.com/nayounghye/my-claude-skills/tree/main/checkmd
Command: npx skills add https://github.com/nayounghye/my-claude-skills --skill checkmd-nayounghye

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Feature planning often happens in scattered chat threads and gets lost, making it hard to track decisions, assumptions, and progress. This Skill maintains a single versioned plan document that records requirements, design decisions, open questions, and implementation status in one consistent format. ## Core Features & Use Cases - Plan Document Generation: Creates a structured plan file with status dashboard, requirements, phased implementation steps, QA plan, and change history when given a file path that does not yet exist. - Q&A-Driven Updates: Reads user comments and questions left inside the plan file and converts them into a discussion log with documented decisions, alternatives considered, and rationale. - Built-in Review Gates: Enforces reuse-first checks, over-engineering guards, security gates (trust boundaries, idempotency, secrets, rollback), and a self-critique section that lists open questions and assumptions before implementation begins. - Use Case: A developer starts a new feature, runs the skill to draft a plan, annotates the file with questions over several days, and watches the document evolve through versioned updates until it is ready for implementation. ## Quick Start Run /checkmd with a plan file path to create a new implementation plan or update an existing one based on my inline comments.

Frequently Asked Questions about checkmd

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

FAQPage Schema
How do I create a feature implementation plan document with Claude?▼

Invoke /checkmd with a target file path. If the file does not exist, the skill generates a full plan template covering requirements, phased implementation steps, QA criteria, and a status dashboard based on the current conversation context.

How do I update a plan document with questions and comments?▼

Add comments or questions directly inside the plan file, then run /checkmd on that file. The skill converts your annotations into Q&A entries in the discussion section, records the decisions made, and bumps the version tag with the date.

Does the plan skill write code automatically?▼

No. The skill only updates the plan document until you explicitly say to implement. It is designed to keep planning and implementation as separate phases, with open questions blocking implementation until resolved.

What safety checks does the planning template include?▼

The template includes gates for trust boundaries, idempotency and concurrency, failure paths, secret leakage, observability, and reversibility. It also requires a reuse review table to prevent duplicate implementations and over-engineering.

When should I not use a plan document workflow?▼

For trivial one-line fixes or throwaway scripts, maintaining a versioned plan document adds overhead without benefit. The workflow is best suited for multi-phase features involving data models, APIs, and frontend changes.