implement-plan-and-open-pr

Implements an existing plan end-to-end and opens a verified pull request.

3|Updated Feb 15, 2025
One-click install
npx skills add https://github.com/mark-torres10/ai_tools --skill implement-plan-and-open-pr-mark-torres10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implement-plan-and-open-pr
Source: https://github.com/mark-torres10/ai_tools/tree/main/skills/implement-plan-and-open-pr
Command: npx skills add https://github.com/mark-torres10/ai_tools --skill implement-plan-and-open-pr-mark-torres10

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a written implementation plan into a finished, verified pull request involves many error-prone steps: executing each plan step, running verification, writing the PR description, updating the changelog, and collecting review feedback. This Skill orchestrates that entire workflow so a plan ships as one complete PR with a returned URL. ## Core Features & Use Cases - Plan-to-PR execution: Reads a plan from docs/plans/..., implements each step in order via the /implement-from-spec skill, and commits per step without squashing. - Verification and compliance: Enforces CODING_RULES.md and UNIT_TESTING_STANDARDS.md, runs the plan's verification commands, and captures UI before/after screenshots when required. - PR authoring and review: Uses write-pr-description for the PR body, updates CHANGELOG.md via write-changelog, and spawns three review subagents (comprehensive-code-review, comprehensive-writing-cleanup, review-for-simplicity) before returning the PR URL. - Use Case: You have an approved plan at docs/plans/add-caching/plan.md with three step files. Invoke this Skill to implement all steps, run the test suite, open the PR, and receive the PR link with a verification summary. ## Quick Start Implement the plan at docs/plans/add-caching/plan.md end-to-end and open a pull request with the result.

Frequently Asked Questions about implement-plan-and-open-pr

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

FAQPage Schema
How do I implement a plan and open a pull request automatically?

Provide the exact plan file path and explicitly request the full implementation plus PR workflow. The Skill implements each plan step in order, runs verification, writes the PR description, pushes the branch, opens the PR, and returns the URL.

When should I not use this plan-to-PR workflow?

Do not use it for planning only, when the plan is ambiguous or incomplete, or when the git worktree has conflicting unrelated changes in files the plan must touch. In those cases it stops and asks rather than guessing.

Does it work with multi-step plans in docs/plans?

Yes. If the plan has several steps/*.md files, each step is implemented in plan order via the implement-from-spec skill, with one commit per step. The PR is only opened after every step's checklist passes.

What verification happens before the pull request is opened?

The plan's verification commands are run and must pass, or failures must be clearly pre-existing and unrelated. The final diff is reviewed against the plan, coding rules and testing standards are enforced, and UI screenshots are captured when required.

Why did the skill stop instead of opening the PR?

It stops when multiple plausible plan files exist, verification steps are missing, credentials or services are unavailable, conflicting edits block required files, or authentication or branch protection prevents PR creation. It reports the exact blocker and next action.