skills/deprecated/fix-coderabbit-review/SKILL.md
End-to-end remediation workflow for PR review feedback by PR number. Use when Codex must export CodeRabbit issues for a PR, fix every issue completely, commit all fixes in a single commit, and resolve GitHub review threads afterward. Don't use for general PR reviews unrelated to CodeRabbit, draft PRs without review threads, or merge-strategy decisions.
npx skillsauth add pedronauck/skills fix-coderabbit-reviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Execute PR review remediation in a strict sequence: export issues, fix all issues, commit once, resolve threads.
Core principle: evaluate each review item technically before changing code. Do not apply suggestions blindly.
GITHUB_TOKEN in environment.gh authenticated for the target repository.Run commands from repository root.
Use bundled exporter script:
PR_NUMBER=<pr-number>
uv run .claude/skills/fix-coderabbit-review/scripts/pr_review.py "$PR_NUMBER" --hide-resolved
Read generated files in:
ai-docs/reviews-pr-<PR_NUMBER>/_summary.mdai-docs/reviews-pr-<PR_NUMBER>/issues/*.mdIf _summary.md shows unresolved issues, continue until all are addressed in code.
Review each unresolved issue file before implementation.
For each issue:
VALID: suggestion is correct and should be implemented.INVALID: suggestion is incorrect or not actionable for this codebase.Rules:
INVALID, document rationale and assumptions in the issue file, and continue execution.INVALID, document technical rationale directly in the issue file and do not force a bad change.Process all unresolved issue files under ai-docs/reviews-pr-<PR_NUMBER>/issues/.
After finishing all issue fixes, run full verification before commit:
pnpm run lint
pnpm run typecheck
pnpm run test
Create exactly one remediation commit containing all related code, test, and issue-tracking changes.
git add -A
git commit -m "fix(repo): resolve PR #<PR_NUMBER> review issues"
Do not split fixes across multiple commits.
After the single commit is created, resolve exported issue threads.
Determine the issue range from issue files (example: 001 to 018) and run:
uv run .claude/skills/fix-coderabbit-review/scripts/resolve_pr_issues.py \
--pr-dir ai-docs/reviews-pr-<PR_NUMBER> \
--from <first-issue-number> \
--to <last-issue-number>
Re-open ai-docs/reviews-pr-<PR_NUMBER>/_summary.md and confirm unresolved count is 0.
If thread resolution fails for specific IDs, keep those issues marked unresolved and report exact failures instead of claiming completion.
Deliver:
VALID or INVALID) recorded during triage.ai-docs/reviews-pr-<PR_NUMBER>/issues/*.md statuses.ai-docs/reviews-pr-<PR_NUMBER>/_summary.md counts/checklist.development
Deep review of branch diffs, working trees, or GitHub PRs at any size. Use when the user asks for CodeRabbit-grade review, an incremental re-review after new pushes, publication of findings to a PR, a cross-LLM peer-review verdict round, or conformance review against spec artifacts. Don't use for applying fixes, reviewing specs or PRDs as documents, or quick single-file feedback.
tools
Orchestrate Claude and Codex worker TUIs from a controller agent through herdr panes and the herdr socket CLI. Use when delegating bounded tasks to herdr worker panes, running user-activated plan-first delegations (Claude Code plan mode, Codex Plan mode), waiting on native agent status (idle, working, blocked, done), or verifying worker reports. Workers launch as interactive TUIs via herdr agent start — never through headless runners (compozy exec, claude -p, codex exec). Not for cmux workspaces (see cmux-orchestration) and not for end-user herdr control.
tools
TanStack Query, Router, and Form patterns for React. Use when writing useQuery/queryOptions, mutations, caching, file-based routes, search params, loaders, or TanStack Form validation. Don't use for TanStack Start, TanStack DB/collections, Zustand client state, or non-TanStack routing.
development
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.