reviewing-code

Review code diffs and changed files for bugs, security issues, and missing tests.

Updated Dec 31, 2025
One-click install
npx skills add https://github.com/tomgun/agentic-framework --skill reviewing-code-tomgun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-code
Source: https://github.com/tomgun/agentic-framework/tree/main/.agentic/lib/agents/claude/skills/reviewing-code
Command: npx skills add https://github.com/tomgun/agentic-framework --skill reviewing-code-tomgun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates systematic code review workflows to surface bugs, security risks, performance issues, missing tests, and documentation drift while keeping large diffs out of the main context for token efficiency.

Core Features & Use Cases

  • Scope detection: Extracts PR numbers, branch context, staged/unstaged changes, or explicit file lists to determine what to review.
  • Plan alignment: Looks up associated plan files (F-XXXX patterns) and compares implementation against stated deliverables when available.
  • Subagent orchestration: Spawns a fresh-context subagent to run diffs and file reads, preserving the main context and enforcing a structured checklist-driven review protocol.
  • Structured output: Requires the subagent to return a standardized findings report (Review Summary, Must Fix, Should Fix, Consider, Verdict) for direct presentation to users.
  • Use case: Run on a pull request to get a prioritized, checklist-based report highlighting security, correctness, tests, and required documentation updates.

Quick Start

Ask the agent to "/review PR #42" or "review current changes" and it will detect scope, check for a plan file, spawn a subagent to run the appropriate git/gh diff commands, and present the subagent's structured findings.

Frequently Asked Questions about reviewing-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate code review for a pull request?

You can automate code review by asking the agent to review a specific PR number or current changes. It detects the scope, runs git/gh diff commands, and returns a structured findings report covering bugs, security risks, and missing tests.

What is structured AI code review and how does it work?

Structured AI code review systematically analyzes diffs and changed files to find bugs, security risks, and style violations. It enforces a checklist-driven protocol and returns a standardized report with prioritized Must Fix, Should Fix, and Consider findings.

Can I review staged or unstaged working tree changes without a pull request?

Yes, you can review staged, unstaged, or specific files directly without a pull request. The Skill detects your current git context, reads the diffs, and generates a structured checklist-driven findings report for your working tree changes.

Does this code review tool check for missing tests and documentation drift?

Yes, the code review process explicitly checks for missing tests and documentation drift. It analyzes changed files against a checklist to surface these issues alongside bugs, security risks, and style violations in the final report.

What is the best way to review large diffs without exceeding token limits?

Review large diffs efficiently by spawning a fresh-context subagent to run git/gh diff commands and file reads. This keeps large diffs out of the main context for token efficiency while returning a strict structured findings report.

Can I align my code review with an existing feature plan file?

Yes, the code review can align with an existing feature plan file. It looks up associated plan files using F-XXXX patterns and compares the implementation against stated deliverables when generating the findings report.