How do I refine a generated specification?

You can add feedback directly into the tags within the spec file and run the /spec command again; the skill will process your comments and update the task list accordingly.

Can I use this for an existing project, or is it only for new ones?

It is designed for both. The skill includes a context section specifically for researching existing codebase patterns and integration points to ensure new tasks are consistent with your current architecture.

What is the primary purpose of the Spec Generation skill?

It creates a structured 'blueprint' for development tasks, ensuring that Claude has a clear, machine-parseable roadmap to follow when implementing new features or projects.

Why does this skill use XML-like tags inside Markdown?

This hybrid format allows the specification to be easily read and edited by humans in any text editor while providing strict markers that Claude can use for automated processing and task 'pouring'.

Spec Generation for Choo Choo Ralph

Name: Spec Generation for Choo Choo Ralph
Author: mj-meyer

bymj-meyer

•

Productivity & Workflow

Generates structured, machine-parseable workflow specifications for Claude Code development loops.

The Spec Generation skill provides a standardized framework for breaking down complex software projects into actionable, verifiable tasks within the Choo Choo Ralph ecosystem. By utilizing a hybrid format of YAML frontmatter and XML-like Markdown tags, it enables Claude to create human-readable specifications that capture codebase context, integration points, and success criteria. This skill is essential for developers looking to maintain architectural consistency and automate the transition from high-level requirements to granular implementation steps.

Key Features

019 GitHub stars

02Context-aware research of existing codebase patterns and integration points

03Scalable architecture supporting both single features and full-scale applications

04Standardized YAML frontmatter for automated project metadata tracking

05Integrated test step definitions to ensure high-level feature verification

06Iterative refinement workflow using built-in review tags for human feedback

Use Cases

01Documenting implementation paths for complex features in existing codebases

02Standardizing team-wide workflows for AI-assisted software development

03Generating a comprehensive task breakdown for greenfield software projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mj-meyer/choo-choo-ralph spec-generation

For use in Claude.ai and ChatGPT

Download Skill