ralph-github-create-issues

Convert PRD markdown files into linked GitHub parent and sub-issues.

69|11|Updated Dec 30, 2025

Search Tags:#automation #planning #github #issues #prd #workflows

Ready to run

npx skills add https://github.com/richtabor/agent-skills --skill ralph-github-create-issues

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ralph-github-create-issues
Source: https://github.com/richtabor/agent-skills/tree/main/skills/ralph-github-create-issues
Command: npx skills add https://github.com/richtabor/agent-skills --skill ralph-github-create-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill automates turning a PRD markdown document into a structured set of GitHub Issues (a parent issue with sub-issues) to drive Ralph workflow execution.

Core Features & Use Cases

Scans common PRD locations (.claude/plans, plans, prds) to locate the PRD source.
Creates a parent issue and linked sub-issues for individual stories, preserving dependencies and traceability.
Supports preflight checks and clear output to guide users through the process.

Quick Start

Run the ralph-github-create-issues workflow to convert a PRD file into a parent issue with linked sub-issues on GitHub.

Frequently Asked Questions about ralph-github-create-issues

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

FAQPage Schema

How do I convert a PRD markdown file into GitHub issues?▼

To convert a PRD into GitHub issues, this skill scans common markdown locations like .claude/plans or prds, then automatically creates a parent issue with linked sub-issues to preserve dependencies and traceability.

Do I need the gh CLI installed to create GitHub issues from PRDs?▼

Yes, you need the gh CLI installed and configured with repository access. The skill requires gh CLI access to run preflight checks and create the parent and sub-issues on GitHub.

What is the best way to link dependencies between GitHub issues from a plan?▼

The best way to link dependencies is transforming a PRD into a parent issue with sub-issues. This skill automatically links dependencies between issues while enforcing preflight checks during creation.

Where does the workflow look for PRD files to generate GitHub issues?▼

The workflow looks for PRD files in common locations within your repository, specifically scanning the .claude/plans, plans, and prds directories to locate the markdown source file.

Can I use this to automate creating a parent issue with sub-issues for my stories?▼

Yes, you can automate creating a parent issue with sub-issues for individual stories. The skill parses your properly formatted PRD/plan files and outputs the created issues and their relationships.