Skip to content

n0an/VivaDicta / .agents/skills/pr

Create a GitHub Pull Request in Claude Code with Claude and Codex review requests and built-in polling workflow

pr

You are given the following context: $ARGUMENTS

Task: Create a GitHub Pull Request in Claude Code

This skill is the Claude Code-specific PR workflow. In Codex, use $prcdx instead.

Based on the provided context, create a pull request following these steps:

  1. First, check the current git status and uncommitted changes
  2. If there are uncommitted changes, ask if they should be committed first
  3. Ensure the current branch is not main/master
  4. Push the current branch to remote if needed
  5. Create the pull request using gh pr create with:
    • A clear, descriptive title
    • A comprehensive description including:
      • Summary of changes
      • Testing performed
      • Any breaking changes or notes
  6. Return the PR URL when complete

IMPORTANT: Final Summary

ALWAYS end your response with a clear summary that includes:

  • What was done (branch created, commits made, etc.)
  • The PR URL (e.g., "PR #123: https://github.com/owner/repo/pull/123")
  • Whether Claude review was requested
  • Whether Codex review was requested
  • The PR is ready for review

Format the PR link prominently so it's easy to find.

If no arguments are provided, create a PR with auto-generated title and description based on the commit history.

Use appropriate flags like --draft if the PR is work in progress.

Post-PR: Request Review and Poll

After the PR is created, always do the following (skip only if the user explicitly says not to):

  1. Request reviews by posting two comments on the PR:
    gh pr comment <PR_NUMBER> --body "@claude please review this PR"
    gh pr comment <PR_NUMBER> --body "@codex please review this PR"
    
  2. Start polling for Claude and Codex review using /loop 2m to check PR comments, PR reviews, and inline review comments every 2 minutes:
    gh pr view <PR_NUMBER> --json comments,reviews,url
    gh api repos/<owner>/<repo>/issues/<PR_NUMBER>/comments
    gh api repos/<owner>/<repo>/pulls/<PR_NUMBER>/comments
    
  3. Do not stop polling just because Claude replied first. Codex review usually takes longer.
  4. Keep polling until you see a real Codex comment or review, not just "in progress" status, or until a reasonable bounded wait expires.
  5. Show the returned review feedback to the user and ask "WDYT?" to discuss the findings before acting on them. If Claude replied but Codex has not yet replied, say that Codex review is still pending and keep polling until the bounded wait is reached.

IMPORTANT: Review Inspection Hygiene

When checking review feedback, do not rely only on top-level PR reviews or summary comments.

  • Always inspect inline review comments / file-level threads too.
  • A generic top-level review body can still coexist with actionable inline comments.
  • Inline comments may be attached to an older reviewed commit on the same branch and still be worth evaluating.
  • Before dismissing a review as empty or boilerplate, check:
    • issue comments
    • PR reviews
    • pull request review comments / inline comments

Suggested extra check:

gh api repos/<owner>/<repo>/pulls/<PR_NUMBER>/comments

Handling Review Feedback

  • Real critical bugs (regressions, data loss, crashes, security issues): fix them immediately without asking.
  • Everything else (style, theoretical issues, nice-to-haves, non-critical improvements): present to the user with your assessment and ask before fixing.

Merge Requests

If the user explicitly says merge, do not wait for CI to finish.

  • Merge the PR immediately using a regular merge commit.
  • Do not block on pending checks unless the user explicitly asks to wait.
  • If you see ongoing GitHub Actions build jobs for that PR or branch, submit a cancel request after merging instead of leaving them running.
  • Do not wait for GitHub to confirm the cancellation. One cancel request is enough unless the user explicitly asks you to verify.
  • Right after the merge, switch the local repository back to main.

Post-Merge: Update What's New

After the PR is merged, update the running What's New file in the Obsidian vault:

  • File: Projects/VivaDicta/what's new/whats-new-running.md in the vault at /Users/antonnovoselov/Documents/Vault/
  • Skip if the PR is a one-liner simple fix, bug fix, refactor, or minor cleanup that users wouldn't notice.
  • Add a concise, user-facing bullet point when the PR introduces a new feature or notable improvement. Write it from the user's perspective (what they can now do), not technical details. This file feeds into App Store Connect "What's New" release notes.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 319kUpdated Claude CodeCodexVerifiedInstall