review

Reviews GitHub pull requests using a six-phase framework and generates a detailed Japanese report.

88|4|Updated Oct 14, 2018
One-click install
npx skills add https://github.com/skanehira/dotfiles --skill review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review
Source: https://github.com/skanehira/dotfiles/tree/main/claude/skills/review
Command: npx skills add https://github.com/skanehira/dotfiles --skill review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill standardizes and deepens the code review process, ensuring that GitHub Pull Requests and local code changes undergo thorough scrutiny across multiple dimensions. It helps catch quality, design, security, and operational issues early, saving significant time and effort in the long run.

Core Features & Use Cases

  • Six-Phase Review Framework: Systematically evaluates code based on quality, design & architecture, security, testing, operations, and documentation, leaving no stone unturned.
  • GitHub PR Integration with Worktrees: Automatically fetches and sets up isolated Git worktrees for seamless and focused review of pull requests, minimizing context switching.
  • Context-Aware Analysis: Explicitly asks for user-provided context (design docs, guidelines) and automatically analyzes existing code to ensure consistency with established patterns.
  • Detailed Japanese Report: Generates a comprehensive review_result.md in Japanese, complete with an executive summary, detailed findings per phase, and prioritized recommendations (Critical, Important, Suggestion).
  • Use Case: A critical new feature is implemented, and a teammate submits a pull request for review. Use this Skill by providing the PR URL. It will set up the code, ask for relevant context, perform a deep six-phase analysis, and deliver a detailed review_result.md report, highlighting security vulnerabilities, architectural concerns, and areas for improvement, all without you having to manually navigate the codebase.

Quick Start

Review the GitHub pull request at https://github.com/myorg/myrepo/pull/123 focusing on security and design principles. Generate the review_result.md report.

Frequently Asked Questions about review

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

FAQPage Schema
How do I review a GitHub pull request systematically across quality, security, and design?

Code reviews should evaluate pull requests across multiple dimensions: quality, design & architecture, security, testing, operations, and documentation. This Skill automates that six-phase review framework, fetching the PR into an isolated Git worktree, analyzing code against best practices, and generating a detailed report with prioritized findings and remediation steps.

Can I automate code reviews for GitHub PRs without manually checking out branches?

Yes. This Skill automatically sets up isolated Git worktrees from a GitHub PR URL, eliminating manual branch checkout and context switching. You provide the PR link, optional context like design docs, and it performs the full analysis and produces a structured review report.

What should a code review check for beyond logic errors?

Comprehensive code reviews should cover security vulnerabilities, architectural consistency, testing adequacy, operational readiness, and documentation completeness. This Skill applies a six-phase framework that systematically evaluates all these dimensions, delivering findings organized by severity and actionable recommendations.

How do I ensure code changes follow project guidelines and best practices?

Provide your project's guidelines and design docs as context; this Skill analyzes code for consistency with established patterns, flags deviations, and highlights areas needing improvement. It generates a comprehensive report with security, design, and quality findings against your standards.

What does a structured code review report include?

A structured review report contains an executive summary, detailed findings organized by review phase (quality, design, security, testing, operations, documentation), prioritized recommendations (Critical, Important, Suggestion), and a remediation plan with actionable next steps.

Can this review process work with local code changes, or only GitHub PRs?

This Skill handles both GitHub PRs and local code changes. For PRs, it fetches and sets up worktrees automatically; for local changes, you provide the code directly. The same six-phase review framework applies to both, delivering consistent, comprehensive analysis.