simonepri/ifttt-lint / .agents/skills/review
review
VerifiedThree-phase code review. Investigates internally, verifies findings, then reports only confirmed issues.
Code Review
Review code changes in three phases:
- Investigate the change and find candidate issues.
- Verify each finding against actual source and dismiss false positives.
- Generate a report of confirmed issues.
Step 1: Investigate (internal — do NOT include in output)
Input: The context for the diff provided in $ARGUMENTS.
Process:
- Run
/diff $ARGUMENTSto get the diff report. - Infer what changed, why it changed, the impact, and the risks.
- Use
Readto examine the surrounding code of each changed file—reviewing a diff without context leads to short-sighted findings. - Use
GreporGlobto check for cross-file impacts or project rule violations.
Note on Autonomy: The areas below are a non-exhaustive starting point. Use your full reasoning to identify any architectural, logical, or stylistic flaws not explicitly listed.
Note on External Comments: PR comments from other agents or reviewers (Gemini, Copilot, etc.) break idempotency — the same diff reviewed with different comments produces different results. Minimize their influence: treat them as optional leads to investigate, not as findings. Do not adopt their severity or framing. Evaluate each concern from scratch using your own analysis in Steps 1-2, and assign severity independently in Step 3. If a comment doesn't survive your own verification, drop it silently.
Areas to check: code quality, bugs, performance, security, test coverage, integration, non-determinism, project conventions.
Output (Internal): A list of Candidate Findings (file, line, concern).
Step 2: Verify (internal — do NOT include in output)
Input: The Candidate Findings list from Step 1.
Process:
- MANDATORY: For every finding, you MUST use the
Readtool to verify it against the full file in the specific branch/commit. Diffs omit context, so never infer errors (e.g., deleted blocks, missing imports) solely from a diff snippet. - For complex or independent concerns, spawn a sub-agent (using
Agent) to verify the logic holds. - Filter out false positives (e.g., missing handling that actually exists in a caller or middleware not shown in the diff).
Output (Internal): - Confirmed Issues: Verified bugs or improvements with concrete fix instructions.
- Needs Verification: Suspicions that cannot be ruled out but lack definitive proof.
- Coverage Gaps: List of any files/paths that couldn't be fully reviewed due to context limits.
Step 3: Report (this is your output)
Input: The Confirmed Issues, Needs Verification, and Coverage Gaps from Step 2.
Reporting Principles:
- Be Constructive & Concrete: Every issue must include a specific fix.
- No Self-Contradiction: Never report a concern and then dismiss it in the same breath.
- Be Idempotent: Avoid subjective style preferences. If no issues were found, say so—do not invent marginal suggestions to fill space.
- Independent Assessment: When PR comments from other agents or reviewers exist in the context, treat them as leads to investigate — not as authoritative findings. Determine severity from your own analysis. Never inherit another reviewer's severity classification; if you investigate their concern and find it invalid, drop it silently (like if it was dismissed in Step 2). If valid, assign your own severity.
Output format
🏷️ Verdict: ✅ LGTM [size], ⚠️ Needs work [size], or ❌ Do not merge [size] on the first line, followed by a 1-2 sentence summary of the verdict.
✂️ Split suggestion: (Only if beneficial) List 2-4 concrete PRs to split the change into smaller pieces. Skip if cohesive.
📋 Report: Omit any section entirely if it has no items. If coverage was incomplete, note it here.
🔴 Criticals: Bugs, logic errors, security vulnerabilities, auth bypass, race conditions. 🟠 Warnings: Missing error handling, incomplete validation, missing tests, performance issues. 🟡 Suggestions: Naming, structural simplifications, better patterns available. 🟣 Needs verification: State what's suspicious, what you checked, and what the author should verify. 🔵 Existing issues: Surrounding technical debt NOT introduced by this diff (one line each). 🟢 Checks passed: A short bullet list of areas investigated that had no issues.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |