team-review

Review GitHub pull requests and branch diffs with educational feedback.

8|2|Updated May 3, 2026
One-click install
npx skills add https://github.com/ejoongseok/claude-settings --skill team-review-ejoongseok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team-review
Source: https://github.com/ejoongseok/claude-settings/tree/main/claude-code/skills/team-review
Command: npx skills add https://github.com/ejoongseok/claude-settings --skill team-review-ejoongseok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

팀 PR이나 브랜치 변경분을 교육적 관점에서 리뷰해, 단순 지적이 아니라 “왜 위험한지”와 “잘한 점”까지 함께 공유함으로써 코드 품질과 팀 성장을 동시에 돕습니다.

Core Features & Use Cases

  • 교육적 PR 리뷰 구조: 문제 지적(Must Fix), 학습형 개선 제안(Nice to Have), 컨벤션 체크, 종합 판단을 일관된 톤으로 제공합니다.
  • PR/브랜치 변경분 기반 분석: GitHub PR 번호 또는 브랜치명(기준 브랜치 대비)을 입력으로 받아 변경된 파일/맥락을 수집해 리뷰를 구성합니다.
  • 프로젝트 맥락 의존(선택): CLAUDE.md, 비즈니스 규칙(.local.claude/biz-rules.md), 모듈 문서(.local.claude/modules/{name}.md), 팀/사람 프로필을 읽어 설명 수준과 포인트를 조정합니다.

Quick Start

팀원 PR을 대상으로 교육적 톤으로 머지 가능 여부와 Must Fix를 포함한 리뷰를 남기려면 /team-review #180 을 입력하세요.

Frequently Asked Questions about team-review

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

FAQPage Schema
How do I give educational code reviews on GitHub pull requests that teach the team?

Educational code reviews on GitHub pull requests explain why code is risky and highlight what was done well, targeting business-logic bugs, boundary issues, and security concerns. This approach provides must-fix items, improvement suggestions, and a mergeability verdict to foster team learning.

What is the best way to analyze branch diffs for business logic validation and security concerns?

Analyzing branch diffs for business logic validation and security concerns involves collecting changed files and context from a base branch comparison. The process identifies technical quality violations and exception issues, outputting structured review feedback including convention checks and a mergeability verdict.

How do I set up project context documents for a team code review?

To set up project context for a team code review, provide optional domain documents such as CLAUDE.md, business rules in .local.claude/biz-rules.md, and module documentation. The review process reads these files to adjust feedback depth and target specific team learning points.

Can I use a branch name instead of a PR number to analyze changed files for technical quality violations?

Yes, you can use a branch name instead of a GitHub PR number to analyze changed files. The review process collects context by comparing the specified branch against a base branch, identifying technical quality violations and security concerns for team code review.

Does the team code review process check project convention rules alongside exception issues?

Yes, the team code review process checks project convention rules alongside exception issues. It outputs a structured review that includes must-fix items, nice-to-have improvements, convention checks, and a final mergeability verdict based on the analyzed branch diffs.