Agent-Skills.md

Agent Skills: GitHub PR Review Fix

Fetch unresolved GitHub PR review threads, normalize them, fix them end-to-end, verify the results, and re-check until the PR is clean or blocked. Use when the user wants GitHub PR comments resolved with minimal verified fixes. Do not use for local review files, Codex reviews, or Zen reviews; review-remediation owns those.

UncategorizedID: bjornmelin/dev-skills/gh-pr-review-fix

Repository

bjornmelin/dev-skills
BjornMelin
2

Install this agent skill to your local

pnpm dlx add-skill https://github.com/BjornMelin/dev-skills/tree/HEAD/skills/gh-pr-review-fix

Skill Files

Browse the full folder contents for gh-pr-review-fix.

Download Skill

Loading file tree…

skills/gh-pr-review-fix/SKILL.md

Skill Metadata

Name
gh-pr-review-fix
Description
Fetch unresolved GitHub PR review threads, normalize them, fix them end-to-end, verify the results, and re-check until the PR is clean or blocked. Use when the user wants GitHub PR comments resolved with minimal verified fixes. Do not use for local review files, Codex reviews, or Zen reviews; review-remediation owns those.

GitHub PR Review Fix

Use this skill as the sole GitHub PR review remediation workflow.

Autonomous Invocation

If the user explicitly invokes $gh-pr-review-fix with no extra detail:

  1. Read the repo AGENTS.md.
  2. Infer the target repo and PR with scripts/prepare_pr_bundle.py.
  3. Fetch a normalized unresolved-thread bundle.
  4. Prioritize valid findings by file and severity.
  5. Apply the minimal fixes that fully resolve the findings.
  6. Run repo-native verification.
  7. Create one scoped conventional commit and push if checks pass.
  8. Re-fetch unresolved threads and continue until zero remain or the workflow is blocked.

Stop and ask only when the repo/PR cannot be inferred, GitHub auth is unavailable, the worktree is too ambiguous to safely stage, or repo policy conflicts with automatic remediation.

Workflow

  1. Read the repo AGENTS.md.
  2. Prepare the target bundle:
    • python3 scripts/prepare_pr_bundle.py --out <json>
    • or pass --repo, --pr, or --url when the target is known
  3. Render the review summary:
    • /home/bjorn/.codex/skill-support/bin/review-pack render --input <json> --format md
  4. Work file-by-file:
    • resolve correctness and safety findings first
    • prefer reviewer suggestion blocks when they are valid
    • keep changes minimal and scoped
  5. Verify with repo-native checks before considering a finding done.
  6. Use $commit only if you need help staging a mixed tree; otherwise keep this workflow self-contained.
  7. Re-run scripts/prepare_pr_bundle.py after each pass to confirm what remains unresolved.
  8. If the task becomes passive or continuous monitoring rather than active remediation, switch to $babysit-pr.

Use When

  • The user asks to fix GitHub PR review comments end-to-end.
  • The current task is centered on unresolved review threads in a PR.

Do Not Use When

  • The input is a local review file, Codex review, Zen review, or manual notes.
  • The task is passive PR monitoring.
  • The task is only CI remediation with no review-thread context.

Direct Tool Policy

  • Use GitHub CLI or GitHub connector/API as the source of truth for PR metadata and review threads.
  • Use Context7 for current API docs when the fix touches changing library APIs.
  • Use Exa or web.run only when a review fix needs current external confirmation.
  • Do not route through context7-research or web-research-stack.

Outputs

  • normalized PR review bundle
  • short prioritized remediation summary
  • verified fixes
  • commit and push summary when a commit is created
  • terminal status: completed, blocked, or needs-user

Resources

  • scripts/prepare_pr_bundle.py