Skip to content
cccskills
FreePublished on GitHubEnglish overview

open-pr

Create a pull request that follows the project's template and title conventions. Check existing behavior and test coverage, document testing limits, and coordinate self-review or bot review with follow-up on reported issues.

OriginalShow the original description

Open a pull request with proper PR template, test coverage, and review workflow. Guides agents through creating a PR that follows repo conventions, ensures existing behaviors aren't broken, covers new behaviors with tests, and handles review via bot when local testing isn't possible. TRIGGER when user asks to "open a PR", "create a PR", "make a PR", "submit a PR", "open pull request", "push and create PR", or any variation of opening/submitting a pull request.

Works withGitHub

Run score Not tested

See how to install

Good for

  • Create a PR using the project's required template
  • Check regression tests and coverage for new behavior
  • Request bot review when local testing is limited
  • Address review feedback and check CI results

Overview

What it does

open-pr handles pull request creation from initial checks through review follow-up. It checks that changes are committed and pushed to the remote, reviews formatting checks across the repository, and checks existing tests for affected areas and tests for new behavior. It fills out the PR description while preserving the structure of .github/PULL_REQUEST_TEMPLATE.md, then creates the PR with a title in the required format.

When it helps

Use it when you want to follow a project's submission rules and organize both the changes and their testing status. When the environment supports sufficient testing, it proceeds with functional testing and self-review. When local verification is limited, it records which tests could not be run and follows the review bot's response.

Example requests

  • “Test these changes and create a PR using the repository template.”
  • “Open a PR targeting the specified branch and request a review.”

Notes

The skill uses Git and the GitHub CLI, gh. The default target branch is dev. Its review workflow uses the related skills /pr-test, /pr-review, and /pr-address. It waits up to 60 minutes for bot review and reports to the user if no response arrives. Merging requires human approval.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Document check

AI checked the SKILL.md for operations that need care and for setup requirements. The score comes only from actually running the skill (hands-on test).

SafetyAre sending data, deleting files, and running commands disclosed?
AGoodIt explicitly describes git push, PR submission, and commenting, and requires human approval before merging.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt uses Git, gh, and related review skills, but does not provide their installation or authentication procedures.

Not counted in the score. Rated by AI (OpenAI Codex) as of Oct 23, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (1)

  • SKILL.md5.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Open a Pull Request

Step 1: Pre-flight checks

Before opening the PR:

  1. Ensure all changes are committed
  2. Ensure the branch is pushed to the remote (git push -u origin <branch>)
  3. Run linters/formatters across the whole repo (not just changed files) and commit any fixes

Step 2: Test coverage

This is critical. Before opening the PR, verify:

Existing behavior is not broken

  • Identify which modules/components your changes touch
  • Run the existing test suites for those areas
  • If tests fail, fix them before opening the PR — do not open a PR with known regressions

New behavior has test coverage

  • Every new feature, endpoint, or behavior change needs tests
  • If you added a new block, add tests for that block
  • If you changed API behavior, add or update API tests
  • If you changed frontend behavior, verify it doesn't break existing flows

If you cannot run the full test suite locally, note which tests you ran and which you couldn't in the test plan.

Step 3: Create the PR using the repo template

Read the canonical PR template at .github/PULL_REQUEST_TEMPLATE.md and use it verbatim as your PR body:

  1. Read the template: cat .github/PULL_REQUEST_TEMPLATE.md
  2. Preserve the exact section titles and formatting, including:
    • ### Why / What / How
    • ### Changes 🏗️
    • ### Checklist 📋
  3. Replace HTML comment prompts (<!-- ... -->) with actual content; do not leave them in
  4. Do not pre-check boxes — leave all checkboxes as - [ ] until each step is actually completed
  5. Do not alter the template structure, rename sections, or remove any checklist items

PR title must use conventional commit format (e.g., feat(backend): add new block, fix(frontend): resolve routing bug, dx(skills): update PR workflow). See CLAUDE.md for the full list of scopes.

Use gh pr create with the base branch (defaults to dev if no [base-branch] was provided). Use --body-file to avoid shell interpretation of backticks and special characters:

BASE_BRANCH="${BASE_BRANCH:-dev}"
PR_BODY=$(mktemp)
cat > "$PR_BODY" << 'PREOF'
<filled-in template from .github/PULL_REQUEST_TEMPLATE.md>
PREOF
gh pr create --base "$BASE_BRANCH" --title "<type>(scope): short description" --body-file "$PR_BODY"
rm "$PR_BODY"

Step 4: Review workflow

If you have a workspace that allows testing (docker, running backend, etc.)

  • Run /pr-test to do E2E manual testing of the PR using docker compose, agent-browser, and API calls. This is the most thorough way to validate your changes before review.
  • After testing, run /pr-review to self-review the PR for correctness, security, code quality, and testing gaps before requesting human review.

If you do NOT have a workspace that allows testing

This is common for agents running in worktrees without a full stack. In this case:

  1. Run /pr-review locally to catch obvious issues before pushing
  2. Comment /review on the PR after creating it to trigger the review bot
  3. Poll for the review rather than blindly waiting — check for new review comments every 30 seconds using gh api repos/Significant-Gravitas/AutoGPT/pulls/{N}/reviews --paginate and the GraphQL inline threads query. The bot typically responds within 30 minutes, but polling lets the agent react as soon as it arrives.
  4. Do NOT proceed or merge until the bot review comes back — but bound the wait at 60 minutes from the /review comment, the same budget /pr-address and /pr-polish use. If nothing has arrived by then, stop waiting and tell the user the requested review never came. Never block indefinitely on a bot.
  5. Address any issues the bot raises — use /pr-address which has a full polling loop with CI + comment tracking
# After creating the PR:
PR_NUMBER=$(gh pr view --json number -q .number)
gh pr comment "$PR_NUMBER" --body "/review"
# Then use /pr-address to poll for and address the review when it arrives

Step 5: Address review feedback

Once the review bot or human reviewers leave comments:

  • Run /pr-address to address review comments. It will loop until CI is green and all comments are resolved.
  • Do not merge without human approval.

Related skills

SkillWhen to use
/pr-testE2E testing with docker compose, agent-browser, API calls — use when you have a running workspace
/pr-reviewReview for correctness, security, code quality — use before requesting human review
/pr-addressAddress reviewer comments and loop until CI green — use after reviews come in; it can also post the /review trigger itself if the PR has no review yet

Step 6: Post-creation

After the PR is created and review is triggered:

  • Share the PR URL with the user
  • If waiting on the review bot, let the user know the expected wait time (~30 min)
  • Do not merge without human approval

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

orchestrate

FreeSummary

Coordinate multiple Claude Code agents in separate Git worktrees and tmux windows. Assign tasks, inspect progress, help stalled agents resume, and verify PR checks and review feedback before treating work as complete.

  • Assign separate development tasks to multiple agents
  • Check agent progress and available worktrees
  • Help stalled or crashed agent sessions resume
Significant-Gravitas/AutoGPT187.7KUpdated Oct 23, 2026

perf-compare

FreeSummary

Compare performance across releases, environments, or time windows using Sentry data. Report request counts, latency percentiles, and failure rates, with statistical checks that distinguish faster or slower behavior from noise and flag insufficient data.

  • Compare performance before and after a release
  • Compare a preview deployment with a control
  • Check other operations for performance regressions
Significant-Gravitas/AutoGPT187.7KUpdated Oct 23, 2026

pr-address

FreeSummary

Work through PR review feedback by fixing code, pushing commits, replying to reviewers, and resolving addressed threads. Monitor automated checks, merge conflicts, and new comments until checks pass and the review work is complete.

  • Fix code based on PR review feedback
  • Reply to human and bot reviewers
  • Investigate failed CI checks after a push
Significant-Gravitas/AutoGPT187.7KUpdated Oct 23, 2026

pr-polish

FreeSummary

Prepare a pull request for merging by repeatedly reviewing changes and addressing feedback. Verify resolved discussions, passing automated checks, and mergeability, then check twice for late comments after the checks finish.

  • Preparing a pull request for merging
  • Repeating review and fixes until no new issues remain
  • Following up on delayed review bot feedback
Significant-Gravitas/AutoGPT187.7KUpdated Oct 23, 2026

pr-review

FreeSummary

Review a pull request, a proposed code change, for correctness, security, design, and test coverage. Check its explanation and existing feedback, then post findings on relevant code lines with severity labels.

  • Checking a pull request before merging
  • Reviewing security risks in code changes
  • Finding missing edge-case tests
Significant-Gravitas/AutoGPT187.7KUpdated Oct 23, 2026

pr-test

FreeSummary

Test a PR or branch through a running application using browser actions and API calls. Compare expected behavior with actual state changes, include failure cases, and post a report with before-and-after screenshots to the PR.

  • Test a PR through browser actions and API calls
  • Compare UI, API, and database state changes
  • Check invalid input and other failure cases
Significant-Gravitas/AutoGPT187.7KUpdated Oct 23, 2026

See all skills by Significant-Gravitas

Report a problem with this skill