milestone-to-tasks

Convert a GitHub milestone into tasks.json and progress.md files.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/dgowrie/claude-workflows --skill milestone-to-tasks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: milestone-to-tasks
Source: https://github.com/dgowrie/claude-workflows/tree/main/skills/milestone-to-tasks
Command: npx skills add https://github.com/dgowrie/claude-workflows --skill milestone-to-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert a GitHub milestone into a structured tasks.json and seeded progress.md under .claude/milestones/<slug>/, creating a machine-readable work graph for Ralph-style loops and downstream workers.

Core Features & Use Cases

  • Resolve a milestone across a repository and slug it for file paths.
  • Fetch issues, infer priority and dependencies, and generate a tasks graph with statuses.
  • Seed a deterministic progress log and prepare artifacts for downstream workers like /work-next-task.

Quick Start

Provide a milestone number or URL to generate .claude/milestones/<slug>/tasks.json and progress.md.

Frequently Asked Questions about milestone-to-tasks

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

FAQPage Schema
How do I convert GitHub milestones into actionable tasks?

To convert GitHub milestones into actionable tasks, this Skill fetches milestone issues, infers priority and dependencies, and generates a structured tasks.json file along with a seeded progress.md log for downstream consumption.

What is a Ralph-style loop and how does it use a tasks graph?

A Ralph-style loop is a machine-readable work queue powered by a tasks graph and progress log. This Skill creates the necessary tasks.json and progress.md artifacts to initiate and drive that automated workflow loop.

How do I generate a tasks.json file from GitHub issues?

You can generate a tasks.json file from GitHub issues by providing a milestone number or URL. The Skill resolves the milestone, fetches the issues, and writes the structured task graph directly to your .claude/milestones directory.

Can I automate GitHub workflows by seeding a progress.md file?

Yes, you can automate GitHub workflows by seeding a deterministic progress.md file. This Skill creates the log alongside a tasks.json file to provide a machine-readable state for downstream workers to track progress.

Do I need any dependencies to turn a GitHub milestone into a task graph?

No dependencies are required to turn a GitHub milestone into a task graph. The Skill operates independently to fetch milestone data, infer priorities, and write the tasks.json and progress.md artifacts.