plan / code-pr

Create a planning document for pull requests against external repositories.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Collectively-Gary/GaryOS --skill plan-code-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan / code-pr
Source: https://github.com/Collectively-Gary/GaryOS/tree/main/data/skills/plan/code-pr
Command: npx skills add https://github.com/Collectively-Gary/GaryOS --skill plan-code-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents failed or off-convention pull requests by forcing a disciplined, repo-aware planning process before code changes are proposed.

Core Features & Use Cases

  • Repo-first context loading: Reads the action trail, signals, and walks context references, then requires a one-time clone-and-skim of the target repository’s README.md and CONTRIBUTING.md when the repo hasn’t been visited before.
  • Approach-discipline enforcement: Ensures the plan includes required clone/branch steps and a specific gh pr create command, selecting exactly one approach at each decision point (no “or” alternatives).
  • Bound test planning: Requires the test assertions to match the exact values or behavior committed to in the Approach, so downstream verification is consistent.
  • Scope control: Forces explicit out-of-scope boundaries to avoid scope creep.

Quick Start

Ask your agent to generate a code-pr playbook plan that clones the target repo, follows its contribution conventions for branching, and prepares an auditable gh pr create command with a deterministic approach and aligned test expectations.

Frequently Asked Questions about plan / code-pr

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

FAQPage Schema
How do I plan a pull request for an unfamiliar GitHub repository?

To plan a pull request for an unfamiliar GitHub repository, you must clone and skim the target repo's README and CONTRIBUTING files first. This ensures your proposed code changes follow documented conventions before you execute any branch or `gh pr create` commands.

What is a deterministic approach for creating a GitHub pull request plan?

A deterministic approach for a GitHub pull request plan requires selecting exactly one implementation method at each decision point without offering alternatives. This discipline prevents ambiguous execution and ensures test assertions bind directly to the chosen approach.

How do I ensure my test plan matches my pull request approach?

To ensure your test plan matches your pull request approach, bind test assertions to the exact values or behaviors committed to in the selected approach. This prevents scope creep and aligns downstream verification with the planned code changes.

How do I prevent scope creep when contributing to external repositories?

You prevent scope creep when contributing to external repositories by explicitly defining out-of-scope boundaries in your planning document. This enforces strict scope control and keeps your pull request focused on the original issue or PR comment.

Why do my pull requests fail against external repo conventions?

Pull requests fail against external repo conventions when you skip context loading and propose code changes that ignore documented contribution guidelines. Enforcing a repo-aware planning process before submitting prevents these off-convention pull requests.

Do I need to read CONTRIBUTING.md before opening a GitHub pull request?

Yes, you need to read CONTRIBUTING.md before opening a GitHub pull request to an unfamiliar target repository. Mandated context loading ensures your branch names, commit messages, and `gh pr create` invocations match the repo's specific guidelines.