version: "1.0.1" name: pr-implement description: 'Implement a scoped OSS PR.' practices: [continuous-delivery, xp, pragmatic-programmer] skill_api_version: 1 context: window: fork intent: mode: task sections: exclude: [HISTORY] intel_scope: topic license: MIT compatibility: Requires git, gh CLI metadata: author: AI Platform Team version: "1.0.0" tier: contribute internal: false allowed-tools: Read, Write, Edit, Bash, Grep, Glob output_contract: "code changes on fork branch"

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 $pr-plan or repo URL

When to Use:

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

When NOT to Use:

• Internal project work (use $implement)
• Haven't planned yet (run $pr-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

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

DO NOT PROCEED IF PRE-CHECK FAILS.

Phase 4: Implementation

Guidelines

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

Phase 7: Handoff

Implementation complete. Isolation checks passed.
 
Branch: origin/$BRANCH_NAME
Commits: N commits, +X/-Y lines
 
Next step: $pr-prep

Anti-Patterns

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