n0an/VivaDicta / .agents/skills/pr
pr
VerifiedCreate 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:
- First, check the current git status and uncommitted changes
- If there are uncommitted changes, ask if they should be committed first
- Ensure the current branch is not main/master
- Push the current branch to remote if needed
- Create the pull request using
gh pr createwith:- A clear, descriptive title
- A comprehensive description including:
- Summary of changes
- Testing performed
- Any breaking changes or notes
- 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):
- 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" - Start polling for Claude and Codex review using
/loop 2mto 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 - Do not stop polling just because Claude replied first. Codex review usually takes longer.
- Keep polling until you see a real Codex comment or review, not just "in progress" status, or until a reasonable bounded wait expires.
- 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.mdin 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 468k | Updated | Claude CodeCodex | Verified | Install |
| 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: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |