MCPInstall

pr-implement

Implement a scoped OSS PR.

Installs
743
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/boshu2/agentops --skill pr-implement
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads pr-implement automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

PR Implement Skill

Fork-based implementation for open source contributions with mandatory isolation check.

Overview

Execute a contribution plan with fork isolation. Ensures PRs are clean and focused by running isolation checks before and during implementation.

Input: Plan artifact from $plan (after $pr-research) or repo URL

When to Use:

  • Implementing a planned OSS contribution
  • Need isolation enforcement for clean PRs
  • After completing $pr-research and $plan

When NOT to Use:

  • Internal project work (use $implement)
  • Haven't planned yet (run $pr-research then $plan first)

Workflow

-1. Prior Work Check      -> BLOCKING: Check for competing PRs
0.  Input Discovery       -> Find plan artifact or repo
1.  Fork Setup            -> Ensure fork exists and is current
2.  Worktree Creation     -> Create isolated worktree
3.  Isolation Pre-Check   -> BLOCK if mixed concerns
4.  Implementation        -> Execute plan
5.  Isolation Post-Check  -> BLOCK if scope creep
6.  Commit Preparation    -> Stage with proper commit type
7.  Handoff               -> Ready for $pr-prep

Phase -1: Prior Work Check (BLOCKING)

# Search for open PRs on this topic
gh pr list -R <owner/repo> --state open --search "<topic>" --limit 10

# Check target issue status
gh issue view <issue-number> -R <repo> --json state,assignees
FindingAction
Open PR existsCoordinate or wait
Issue assignedCoordinate or find alternative
No competing workProceed

Phase 3: Isolation Pre-Check (BLOCKING)

# Commit type analysis
git log --oneline main..HEAD | sed 's/^[^ ]* //' | grep -oE '^[a-z]+(\([^)]+\))?:' | sort -u

# File theme analysis
git diff --name-only main..HEAD | cut -d'/' -f1-2 | sort -u
CheckPass Criteria
Single commit type0 or 1 prefix
Thematic filesAll match plan scope
Branch freshBased on recent main

DO NOT PROCEED IF PRE-CHECK FAILS.


Phase 4: Implementation

Guidelines

GuidelineWhy
Single concernEach commit = one logical change
Match conventionsFollow project style exactly
Test incrementallyRun tests after each change

Commit Convention

git commit -m "type(scope): brief description

Longer explanation if needed.

Related: #issue-number"

Phase 5: Isolation Post-Check (BLOCKING)

# Commit type analysis
git log --oneline main..HEAD | sed 's/^[^ ]* //' | grep -oE '^[a-z]+(\([^)]+\))?:' | sort -u

# Summary stats
git diff --stat main..HEAD
CheckPass Criteria
Single commit typeAll commits share same prefix
Thematic filesAll files relate to PR scope
Atomic scopeCan explain in one sentence

Phase 7: Handoff

Implementation complete. Isolation checks passed.

Branch: origin/$BRANCH_NAME
Commits: N commits, +X/-Y lines

Next step: $pr-prep

Anti-Patterns

DON'TDO INSTEAD
Skip isolation pre-checkRun Phase 3 FIRST
Skip isolation post-checkRun Phase 5 before push
Mix concerns in commitsOne type prefix per PR
Implement without planRun $pr-research then $plan first

Examples

Implement From Contribution Plan

User says: "Implement this external PR plan with isolation checks."

What happens:

  1. Run pre-checks for branch and scope isolation.
  2. Implement only in planned files/areas.
  3. Run post-checks and prepare handoff for PR prep.

Enforce Single-Concern Commit Set

User says: "Make sure this branch is still single-purpose before I prep the PR."

What happens:

  1. Inspect commit/file patterns against stated scope.
  2. Flag mixed concerns and suggest extraction steps.
  3. Produce a clean handoff to $pr-prep.

Troubleshooting

ProblemCauseSolution
Isolation check failsUnrelated changes on branchMove unrelated edits to separate branch/PR
Commits mix concernsImplementation drifted from planRe-split commits by concern and revalidate
Scope keeps expandingWeak boundaries in planRe-anchor to Out of Scope and stop additional changes
Hard to hand offMissing summary/test contextAdd concise change summary and verification notes

Reference Documents

  • references/pr-implement.feature — Executable spec: execute plan on fork branch, mandatory isolation before+during, scoped/focused PR (soc-qk4b)

FAQ

What does the pr-implement skill do?

Implement a scoped OSS PR.

How do I install pr-implement?

Run npx skills add https://github.com/boshu2/agentops --skill pr-implement in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/pr-implement/ (personal) or .claude/skills/pr-implement/ (project).

Which AI agents can use pr-implement?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is pr-implement safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains pr-implement?

It is published by boshu2 in boshu2/agentops. It has 743 recorded installs.

More from boshu2/agentops

View all →

council

boshu2/agentops

Compare independent opinions from several models or contexts without inflating agreement. Use when: wanting a second opinion or debate, or summarizing several reviewers' results.

3K installs

doc

boshu2/agentops

Write source-checked docs, READMEs, change descriptions and handoffs. Use when: documenting a change, leaving or resuming a handoff, or drafting a questionnaire for someone else.

research

boshu2/agentops

Answer one cited question on code, history, claims or patterns. Use when: asked how it works, why it changed, if a claim or done/shipped report holds, or a pattern warrants a rule.

plan

boshu2/agentops

Shape a request into one end-to-end slice with observable behavior; review write scope and reversible decisions. Use when: planning, breaking down or scoping a change.

swarm

boshu2/agentops

Dispatch explicit disjoint packets exactly once through a caller-selected executor. Triggers: "swarm", "dispatch disjoint packets", "parallel explicit tasks".

1.5K installs

rpi

boshu2/agentops

Drive one accepted change through implementation and checks to done, with one fresh review only where a mistake is costly. Use when: asked to run or orchestrate work through RPI.

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.