Code Review Skill
Rules
Read-Only Operations
This skill only allows read-only GitHub operations. Write operations require explicit user instruction outside this skill.
For gh api: GET requests only. No -X POST/PUT/PATCH/DELETE or -f/-F flags.
Citation Required
Every issue raised MUST reference official documentation with URL or doc name. Do not raise issues without documentation support.
Workflow
- Get PR overview -
gh pr view <number> - Review diff -
gh pr diff <number> - Impact analysis - Search callers of modified functions
- Check CI -
gh pr checks <number> - Output findings - Use format below
For detailed commands: See references/gh-commands.md
Impact Analysis (REQUIRED)
When functions/methods/interfaces are modified:
- Identify modified functions from diff
- Search all callers:
rg "functionName" --type <lang> - Verify caller compatibility
- Report breaking changes
Check for: signature changes, return type changes, renamed functions, modified APIs.
Output Format
## Review Summary
### Issues Found
#### [File: path/to/file.ext, Line: XX]
**Issue**: [Description]
**Reference**: [Official documentation URL]
**Suggestion**: [How to fix]
### Impact Analysis
- [Affected callers and compatibility status]
### Recommendation
- [ ] Approve / [ ] Request Changes / [ ] Comment Only
Checklist
- [ ] Changes align with purpose
- [ ] Logic correct, edge cases handled
- [ ] All callers of modified functions identified
- [ ] No breaking changes to public APIs
- [ ] Security: input validation, no hardcoded secrets
- [ ] Tests added/updated, CI passing