home / skills / microck / ordinary-claude-skills / prp-core-runner

prp-core-runner skill

safe

This skill orchestrates the full PRP workflow from idea to pull request, streamlining branch creation, PRP generation, implementation, commit, and PR.

npx playbooks add skill microck/ordinary-claude-skills --skill prp-core-runner

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

2.8 KB

---
name: prp-core-runner
description: Orchestrate complete PRP workflow from feature request to pull request. Run create branch, create PRP, execute implementation, commit changes, and create PR in sequence. Use when implementing features using PRP methodology or when user requests full PRP workflow.
---

# PRP Core Workflow Runner

## Instructions

When the user requests to implement a feature using the PRP workflow or wants end-to-end automation from idea to PR, use the SlashCommand tool to invoke `/prp-core-run-all` with the user's feature description as the argument.

**Step-by-step execution:**

1. **Invoke the workflow**: Use SlashCommand tool with `/prp-core-run-all {feature-description}`
2. **Monitor progress**: The workflow will execute 5 steps in sequence:
   - Create a conventional git branch
   - Generate comprehensive PRP document
   - Execute the PRP implementation
   - Create atomic git commit
   - Create pull request
3. **Handle failures**: If any step fails:
   - Report which step failed and why
   - Do NOT proceed to subsequent steps
   - Provide actionable guidance for fixing the issue
4. **Report completion**: When all steps succeed, confirm the workflow completed and provide the PR URL

**Error Handling:**

- Stop execution immediately if any validation fails
- Report the specific error clearly
- Guide the user on how to resolve the issue
- Do not attempt to auto-fix complex validation failures

## Examples

**Example 1: Autonomous invocation**
```
User: "Can you implement user authentication using JWT with the PRP workflow?"
Assistant: I'll use the prp-core-runner skill to execute the complete PRP workflow for implementing JWT authentication.
[Invokes: /prp-core-run-all Implement user authentication using JWT]
```

**Example 2: Feature request**
```
User: "I need to add a search API with Elasticsearch integration using PRP"
Assistant: I'll run the full PRP workflow to implement the search API with Elasticsearch.
[Invokes: /prp-core-run-all Add search API with Elasticsearch integration]
```

**Example 3: Refactoring with PRP**
```
User: "Use the PRP methodology to refactor the database layer for better performance"
Assistant: I'll execute the PRP workflow for refactoring the database layer.
[Invokes: /prp-core-run-all Refactor database layer for better performance]
```

## When to Use

Use this skill when:
- User explicitly requests to "implement a feature using PRP"
- User asks to "run the full PRP workflow"
- User wants end-to-end automation from feature idea to pull request
- User mentions both "PRP" and a feature to implement
- User requests a complete workflow including branch, implementation, and PR

Do NOT use this skill when:
- User only wants to run a single PRP command (e.g., just create a PRP)
- User is asking about PRP methodology (provide information instead)
- User wants to implement something without mentioning PRP workflow

Overview

This skill orchestrates the complete PRP workflow from feature request to a created pull request. It runs branch creation, PRP document generation, implementation execution, commit creation, and PR opening in a single automated sequence. Use it to convert a feature idea into an auditable, atomic pull request quickly.

How this skill works

Invoke the workflow with a single command including the feature description. The runner executes five ordered steps: create a conventional git branch, generate a comprehensive PRP document, run the PRP implementation, create an atomic commit, and open a pull request. If any step fails the process stops, reports the failure and gives actionable guidance instead of proceeding. On success the skill returns confirmation and the pull request URL.

When to use it

You explicitly ask to implement a feature using the PRP workflow.
You want end-to-end automation from idea to pull request.
You request the full PRP workflow (branch, PRP, implementation, commit, PR).
You mention PRP together with a concrete feature to implement.
You need a reproducible, auditable development workflow for a new change.

Best practices

Provide a clear, concise feature description that includes goals and acceptance criteria.
Mention any relevant files, modules, or tests to target to help accurate implementation.
Run small, focused feature requests to ensure atomic commits and easy reviews.
Review failure messages promptly and apply the suggested fixes before re-running the workflow.
Keep CI and repo permissions configured so the runner can create branches and pull requests.

Example use cases

Implement JWT-based user authentication using PRP end-to-end.
Add a search API with Elasticsearch integration and receive a ready PR.
Refactor the database access layer for performance with an atomic commit and PR.
Create a feature flag implementation across backend and tests, automated into a PR.
Turn a user story into code, tests, and a pull request with minimal manual steps.

FAQ

What happens if one step fails?

The workflow stops immediately, reports which step failed and why, and provides actionable guidance to fix the issue before retrying.

Can I run only a single step instead of the full workflow?

No. This runner is designed for the complete PRP sequence; request individual PRP commands separately if you only need one step.