# Review Pr

> Review a pull request against project standards

- Skill: `arklexai/review-pr-2` (Agent Skill)
- Install (CLI): `npx get-skill add arklexai/review-pr-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arklexai/review-pr-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: arklexai (https://skillmd.com/u/arklexai)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/arklexai/review-pr-2

---


# Review PR

Review a PR for functional correctness and project conventions. Focus on logic, architecture, and behavior. Formatting issues are caught by CI (ruff, pre-commit) and do not need manual review.

## Steps

### 1. Load PR context

```bash
gh pr view $ARGUMENTS --json title,body,files,additions,deletions
gh pr diff $ARGUMENTS
```

### 2. Validate PR title and description

- Title matches Conventional Commits regex, under 72 chars
- Description sections meet word minimums (Summary 5w, Description 10w, Tests 10w)
- These are also CI-enforced, so flag only if CI somehow missed them

### 3. Review functional changes

Focus on:
- Logic correctness: does the code do what the PR claims?
- Edge cases: are error paths handled?
- API changes: are they backwards compatible or properly marked as breaking?
- Security: no hardcoded secrets, no unsanitized input in dangerous contexts
- Performance: any obvious inefficiencies?

### 5. Check scope

- Single concern per PR
- Flag unrelated changes bundled together

### 6. Check test coverage

- New behavior should have tests
- Coverage minimum is 45%. Flag large additions without tests.

## Output

```
## Summary
One-sentence assessment.

## Findings
- List issues grouped by severity (blocking, suggestion, nit)

## Checklist
- [ ] Title matches Conventional Commits
- [ ] Description sections meet word minimums
- [ ] Functional correctness verified
- [ ] Tests cover new/changed code
- [ ] No secrets in diff
```

End with: APPROVED, CHANGES REQUESTED, or NEEDS DISCUSSION.

