gen-draft

Generate structured draft.md documents from task descriptions via a two-phase question checklist.

7|1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/gyy0592/claude-config --skill gen-draft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gen-draft
Source: https://github.com/gyy0592/claude-config/tree/main/skills/gen-draft
Command: npx skills add https://github.com/gyy0592/claude-config --skill gen-draft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts ambiguous or incomplete task descriptions into a clear, high-level draft document that captures the WHAT and WHY so work is planned before any implementation decisions are made.

Core Features & Use Cases

  • Enforces a mandatory two-phase pipeline: Phase 1 gathers missing context via a consolidated checklist and user questions, and Phase 2 writes a structured draft.md based on those answers.
  • Provides strict templates and self-check rules to separate facts from implementation, specify observable outputs, and guard destructive operations.
  • Use Case: Preparing a feature implementation or experiment plan where constraints, inputs, outputs, and acceptance criteria must be explicitly recorded before coding or training.

Quick Start

Invoke the gen-draft skill by running /gen-draft and answer the checklist questions to produce a structured draft.md capturing goal, inputs, outputs, constraints, and observable outputs.

Frequently Asked Questions about gen-draft

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

FAQPage Schema
How do I create a structured requirements draft from a task description?

To create a structured requirements draft, you can use a two-phase human-in-the-loop workflow that consolidates missing context into a checklist and then generates a draft.md capturing the WHAT and WHY of your task.

What is the best way to plan software features before starting implementation?

The best way to plan software features is to generate a high-level draft document that explicitly separates facts from implementation decisions, recording constraints, inputs, and observable outputs before coding begins.

How do I write an experiment plan that captures constraints and acceptance criteria?

To write an experiment plan with constraints and acceptance criteria, use a strict template that enforces execution-order rules and specifies observable outputs, ensuring the WHY of the experiment is documented prior to training.

Can I use a template to gather missing context for operational task planning?

Yes, you can use a mandatory context-gathering checklist to collect missing information for operational task planning, which then informs the generation of a structured draft document.

Why does my task planning workflow need a human-in-the-loop question phase?

A human-in-the-loop question phase is needed to consolidate and validate missing context, ensuring the resulting draft.md accurately captures explicit facts and observable outputs without jumping to premature implementation decisions.

When should I avoid generating a high-level draft document for my project?

You should avoid generating a high-level draft document when your task is fully specified with no missing context, or when capturing the high-level WHAT and WHY is unnecessary for the immediate implementation phase.