spec-to-tasks

Parse SPEC.md files into structured tasks.json for Ralph Loop execution.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/hheydaroff/common-agent-skills --skill spec-to-tasks-hheydaroff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-to-tasks
Source: https://github.com/hheydaroff/common-agent-skills/tree/main/skills/spec-to-tasks
Command: npx skills add https://github.com/hheydaroff/common-agent-skills --skill spec-to-tasks-hheydaroff

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the conversion of human-readable specifications into structured, machine-readable task formats, enabling automated project workflows.

Core Features & Use Cases

  • SPEC Parsing: Reads and validates SPEC.md files containing feature descriptions and acceptance criteria.
  • Task Extraction: Identifies atomic tasks, dependencies, and phases to organize workflow steps.
  • Output Generation: Produces a ready-to-run tasks.json file for Ralph Loop automation in software development pipelines.
  • Use Case: Automate project task planning by converting a detailed spec document into executable task sequences with dependencies and verification steps.

Quick Start

Use the script to convert your SPEC.md into tasks.json by running: uv run spec_to_tasks.py [spec_path] [output_path].

Frequently Asked Questions about spec-to-tasks

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

FAQPage Schema
How do I convert a SPEC.md file into executable task sequences for agile development?

Yes, you can automate project task planning by running the spec_to_tasks.py script. It extracts atomic tasks and dependencies from your feature specifications to produce a ready-to-run JSON configuration for Ralph Loop execution.

What is the best way to extract dependencies and phases from feature specifications?

The best way to extract dependencies and phases from feature specifications is using an automated parser. This Skill identifies atomic tasks, dependencies, and phases within Markdown tables and task blocks to organize workflow steps systematically.

How do I generate a tasks.json file from Markdown acceptance criteria for Ralph Loop automation?

You generate a tasks.json file by running: uv run spec_to_tasks.py [spec_path] [output_path]. The script reads and validates your SPEC.md acceptance criteria, outputting a ready-to-run configuration for Ralph Loop automation in software development pipelines.

Do I need specific formatting in my SPEC.md files to successfully parse feature descriptions?

Yes, your SPEC.md files require specific formatting. The parser expects structured Markdown tables, task blocks, and acceptance criteria to successfully extract feature descriptions, identify atomic tasks, and map dependency chains for output generation.

Can I use this spec parser to create structured task lists for software development pipelines without external dependencies?

Yes, you can use this spec parser without external dependencies. It independently reads and validates SPEC.md files to generate structured task lists, requiring only the uv run command to execute the spec_to_tasks.py script for output generation.