ralph

Parse PRD markdown files and create Linear projects with issues.

12|1|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/ismailytics/ralph-with-claude-code-and-linear --skill ralph-ismailytics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/ismailytics/ralph-with-claude-code-and-linear/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/ismailytics/ralph-with-claude-code-and-linear --skill ralph-ismailytics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert existing PRDs into Linear projects and issues to enable Ralph's autonomous workflow by turning planning documents into actionable Linear work items.

Core Features & Use Cases

  • Parse a PRD markdown file to extract Title/Name, Description/Overview, Goals, User Stories, Non-Goals, and Technical Considerations
  • Create a Linear project from the PRD content after selecting a Linear team
  • Generate Linear issues for each user story with priorities and acceptance criteria
  • Save a .ralph-project configuration and branch information

Quick Start

Provide a PRD markdown file to Ralph PRD to Linear Converter and run it to generate a Linear project, issues, and a .ralph-project file.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I convert a PRD markdown file into Linear issues and projects?

To convert a PRD markdown file into Linear issues, you can use a tool that parses the document to extract user stories, goals, and technical considerations, then automatically generates a Linear project with prioritized issues and acceptance criteria.

What is the best way to automate Linear project creation from a product requirements document?

Automating Linear project creation from a product requirements document involves parsing the markdown file for structured sections like Title, Goals, and User Stories, then mapping these directly to a new Linear project and its corresponding issues.

Can I generate Linear issues with acceptance criteria directly from markdown?

Yes, you can generate Linear issues with acceptance criteria directly from markdown by parsing the user stories defined in your PRD and automatically assigning priorities and acceptance criteria to each created issue.

Do I need a specific PRD format to create Linear issues automatically?

You need a markdown PRD format containing structured sections such as Title, Description, Goals, User Stories, Non-Goals, and Technical Considerations to successfully parse the file and automatically create your Linear issues.

How does saving a .ralph-project configuration file help with Linear project management?

Saving a .ralph-project configuration file stores your branch information and parsed PRD data, allowing autonomous workflows to resume iterations on your Linear project and generated issues without needing to reprocess the original markdown.