review-pr
- Repo stars 43
- Author updated Live
- Author repo Agent365-devTools
- Domain
- Writing
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @microsoft · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Required · Anthropic
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- Python
- Permissions
-
- Read-only
- Write / modify
- Env read
- Network behavior
- External requests
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: review-pr
description: Generate structured PR review comments using Claude Code agents and post them to GitHub. No API…
category: writing
runtime: Python
---
# review-pr output preview
## PART A: Task fit
- Use case: Generate structured PR review comments using Claude Code agents and post them to GitHub. No API key required - uses Claude Code's existing authentication. Generate and post AI-powered PR review comments to GitHub following engineering best practices. requires Anthropic API key; runs on Python. Works with Claude Code, Cursor, Cline and 23 more..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Usage / What this skill does / Engineering Review Principles” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Generate structured PR review comments using Claude Code agents and post them to GitHub. No API key required - uses Claude Code's existing authentication. Generate and post AI-powered PR review comments to GitHub following engineering best practices. requires Anthropic API key; runs on Python. Works with Claude Code, Cursor, Cline and 23 more.”.
- **02** When the source has headings, the agent prioritizes “Usage / What this skill does / Engineering Review Principles” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files, read environment variables; may access external network resources; requires Anthropic API keys.
## Running Rules
- read files, write/modify files, read environment variables; may access external network resources; requires Anthropic API keys.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source mentions slash commands such as `/review-pr`; use them first when your agent supports command triggers.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files, read environment variables.
Start with a small task and check whether the result follows “Usage / What this skill does / Engineering Review Principles”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: review-pr
description: Generate structured PR review comments using Claude Code agents and post them to GitHub. No API…
category: writing
source: microsoft/Agent365-devTools
---
# review-pr
## When to use
- Generate structured PR review comments using Claude Code agents and post them to GitHub. No API key required - uses Cl…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Usage / What this skill does / Engineering Review Principles” and keep inference separate from source facts.
- read files, write/modify files, read environment variables; may access external network resources; requires Anthropic API keys.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "review-pr" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Usage / What this skill does / Engineering Review Principles
rules -> SKILL.md triggers / order / output contract
runtime -> Python | read files, write/modify files, read environment variables | may access external network resources
guardrails -> requires Anthropic API keys + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} PR Review Skill
Generate and post AI-powered PR review comments to GitHub following engineering best practices.
Usage
/review-pr <pr-number> # Generate review (step 1)
/review-pr <pr-number> --post # Post review to GitHub (step 2)
Examples:
/review-pr 180- Generate review and save to YAML file/review-pr 180 --post- Post the reviewed YAML to GitHub
What this skill does
Step 1: Generate (/review-pr <number>)
- Fetches PR details from GitHub using the gh CLI
- Performs architectural review (NEW!): Questions design decisions, checks for scope creep, validates use cases
- Analyzes changes for security, testing, design patterns, and code quality issues
- Differentiates contexts: CLI code vs GitHub Actions code (different standards)
- Creates actionable feedback: Specific refactoring suggestions based on file names and patterns
- Generates structured review comments in an editable YAML file
- Shows preview of all generated comments
Step 2: Post (/review-pr <number> --post)
- Reads the YAML file you reviewed/edited
- Posts to GitHub: Submits all enabled comments to the PR
- Automatic fallback: If GitHub API posting fails (e.g., Enterprise Managed User restrictions), automatically generates a markdown file with formatted comments for manual copy/paste
Engineering Review Principles
This skill enforces the following principles:
Architectural Review (NEW!)
- Design Decision Validation: Questions "why" before reviewing "how"
- Scope Creep Detection: Flags expansions beyond Agent365 deployment/management
- Use Case Validation: Requires concrete scenarios for new features
- Overlap Detection: Identifies duplication with existing tools (Azure CLI, Portal)
- YAGNI Enforcement: Questions features without documented need
Architecture & Patterns
- .NET architect patterns: Reviews follow .NET best practices
- Azure CLI alignment: Ensures consistency with az cli patterns and conventions
- Cross-platform compatibility: Validates Windows, Linux, and macOS compatibility (for CLI code)
Design Patterns
- KISS (Keep It Simple, Stupid): Prefers simple, straightforward solutions
- DRY (Don't Repeat Yourself): Identifies code duplication
- SOLID principles: Especially Single Responsibility Principle
- YAGNI (You Aren't Gonna Need It): Avoids over-engineering
- One class per file: Enforces clean code organization
Code Quality
- No large files: Flags files over 500 additions
- Function reuse: Encourages reusing functions across commands
- No special characters: Avoids emojis in logs/output (Windows compatibility)
- Self-documenting code: Prefers clear code over excessive comments
- Minimal changes: Makes only necessary changes to solve the problem
Testing Standards
- Framework: xUnit, FluentAssertions, NSubstitute for .NET; pytest/unittest for Python
- Quality over quantity: Focus on critical paths and edge cases
- CLI reliability: CLI code without tests is BLOCKING
- GitHub Actions tests: Strongly recommended (HIGH severity) but not blocking
- Mock external dependencies: Proper mocking patterns
Security
- No hardcoded secrets: Use environment variables or Azure Key Vault
- Credential management: Follow az cli patterns for CLI code; use GitHub Secrets for Actions
Context Awareness
The skill differentiates between:
- CLI code (strict requirements): Cross-platform, reliable, must have tests
- GitHub Actions code (GitHub-specific): Linux-only is acceptable, tests strongly recommended
Review Comments Output
Generated comments are saved to:
C:\Users\<username>\AppData\Local\Temp\pr-reviews\pr-<number>-review.yaml
You can edit this file to:
- Disable comments by setting
enabled: false - Modify comment text
- Adjust severity levels (blocking, high, medium, low, info)
- Add or remove comments
Implementation
The skill uses Claude Code directly for semantic code analysis (inspired by Agent365-dotnet). No separate API key required!
Generate mode (default):
- Claude Code reads
.claude/agents/pr-code-reviewer.mdfor review process guidelines - Claude Code reads
.github/copilot-instructions.mdfor coding standards - Claude Code fetches PR details:
gh pr view <number> --json ... - Claude Code analyzes actual code changes:
gh pr diff <number> - Claude Code performs semantic analysis using its own capabilities
- Claude Code identifies specific issues with line numbers and code references
- Claude Code writes YAML file to
C:\Users\<username>\AppData\Local\Temp\pr-reviews\pr-<number>-review.yaml
Post mode (with --post flag):
- Python script reads the YAML file
- Python script posts comments to GitHub using
gh pr comment - If posting fails (API permissions), automatically generates markdown file for manual copy/paste
Key Advantages:
- ✅ No
ANTHROPIC_API_KEYrequired - uses Claude Code's existing authentication - ✅ Better semantic analysis - Claude Code has full context and conversation history
- ✅ Simpler Python script - only handles posting logic (~240 lines vs ~1500 lines)
- ✅ Easier to maintain and debug
Workflow
Generate review:
/review-pr 180- Fetches PR details from GitHub
- Analyzes code and generates review comments
- Saves to YAML file (shows path in output)
Review and edit: Open the YAML file
- Review all generated comments
- Edit comment text if needed
- Disable comments by setting
enabled: false - Add your own comments if desired
Post to GitHub:
/review-pr 180 --post- Reads the YAML file
- Posts all enabled comments to the PR
- If API posting fails, automatically generates a markdown file for manual copy/paste
Requirements
- GitHub CLI (
gh) installed and authenticated - Python 3.x (only for --post mode)
- PyYAML library:
pip install pyyaml(only for --post mode) - Repository must be a GitHub repository
- GitHub API permissions to post reviews (Enterprise Managed Users may have restrictions)
See Also
- README.md - Detailed documentation
- review-pr.py - Implementation script
Decide Fit First
Design Intent
How To Use It
Boundaries And Review