code-task-generator

Generate structured .code-task.md templates from descriptions or PDD plans.

3.1k|286|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill code-task-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-task-generator
Source: https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/code-task-generator
Command: npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill code-task-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of structured .code-task.md files from natural-language descriptions or PDD plans, reducing friction between ideation and implementation.

Core Features & Use Cases

  • Auto-detect input mode: accepts plain descriptions or PDD plans and selects the appropriate task-generation flow.
  • Code Task Formatting: outputs files following the Code Task Format, including YAML frontmatter and the structured task body.
  • PDD-driven workflows: supports stepwise task breakdown (step01, step02, etc.) and links to design/references for traceability.
  • Plan-to-Implementation Link: ensures each task includes a Given-When-Then acceptance criteria and an implementation plan.
  • Designer-friendly outputs: templates compatible with Ralph integration and CI pipelines.

Quick Start

Provide a concise description or path to a PDD plan to generate a full set of code-task files. For example: "Generate tasks from the description: 'Create a function to validate user input and unit-test coverage'." Or, "Generate tasks from plan.md at specs/user-authentication/plan.md and create step01..."

Frequently Asked Questions about code-task-generator

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

FAQPage Schema
How do I generate structured code tasks from plain text descriptions?

Generating structured code tasks from plain text descriptions involves automating natural-language inputs into ready-to-run .code-task.md templates. This process outputs files with YAML frontmatter, structured task bodies, and Given-When-Then acceptance criteria to guide implementation.

How do I convert a PDD plan into stepwise markdown task files?

Converting a PDD plan into stepwise markdown task files requires providing a path to your plan to trigger step-by-step task breakdown. This generates linked step01, step02 files with design references and unit-test coverage, ensuring full traceability from plan to implementation.

What is the Code Task Format and when do I need it for spec-driven development?

The Code Task Format is a structured markdown template with YAML frontmatter used for spec-driven development. You need it to bridge ideation and implementation by enforcing acceptance criteria, implementation plans, and design references within your task files.

Can I use code-task-generator outputs with CI pipelines and Ralph integration?

Yes, you can use code-task-generator outputs with CI pipelines and Ralph integration. The generated designer-friendly templates follow a standardized format that ensures compatibility with automated workflows and downstream pipeline processes.

Does the automated task generation include unit-test coverage specifications?

Automated task generation explicitly includes unit-test coverage specifications within its outputs. It enforces Given-When-Then acceptance criteria and implementation plans to ensure development tasks have verifiable test coverage requirements directly embedded.

What is the best way to break down complex features into implementable code tasks?

The best way to break down complex features into implementable code tasks is using PDD-driven workflows for stepwise task breakdown. This approach auto-detects input modes and generates linked step files with design references and structured acceptance criteria.