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.