CherryHQ/cherry-studio / .agents/skills/gh-pr-review
gh-pr-review
UnverifiedAutomated Cherry Studio review for local branches, PRs, commits, files, architecture docs, and repository skills. Use for code or documentation reviews that need project-specific naming, main/renderer/shared placement and dependency rules, IpcApi and DataApi boundaries, lifecycle/service ownership, renderer hooks, React/UI conventions, and tests. Review depth adapts to diff size and runtime subagent capability (single-agent or multi-agent reviewer-verifier). Report-only by default; code fixes and GitHub submission each require explicit invocation-time authorization (`fix` / `submit`). Normal-review prompts and safe interruption behavior follow the interaction contract below. To diagnose gaps in the skill after a review session, run `/gh-pr-review diag`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.4 KB |
| agents/openai.yaml | config | 247 B |
| references/checklist-evolution.md | markdown | 4.7 KB |
| references/cherry-review-guidance.md | markdown | 40.0 KB |
| references/code-checklist.md | markdown | 10.3 KB |
| references/consumer-review.md | markdown | 7.4 KB |
| references/diagnosis.md | markdown | 2.6 KB |
| references/doc-checklist.md | markdown | 3.8 KB |
| references/judgment-matrix.md | markdown | 6.8 KB |
| references/local-review.md | markdown | 6.2 KB |
| references/pr-review.md | markdown | 19.7 KB |
| references/teams-review.md | markdown | 19.0 KB |
references/doc-checklist.md
View on GitHub# Document Review Checklist
Review in priority order: A (highest impact) → B → C. The reviewer prompt specifies
which levels to check. Project rules loaded in context override this checklist.
---
## A. Accuracy
Issues where the document contains incorrect, contradictory, or incomplete information.
### A1. Code-Document Accuracy
- Described behaviors match actual code implementation
- Parameter names, types, default values consistent with code
- Return values and error conditions accurately documented
- Described algorithms / processing steps consistent with implementation
- Version numbers, format identifiers, constants correct
- Value ranges and constraints accurate
- Enum values and meanings consistent with code definitions
- IpcApi route/event names, schemas, handlers, and payload types agree; legacy
`IpcChannel` references are identified as migration-only where applicable
### A2. Internal Consistency
- Different sections describing the same concept agree with each other
- Constraints and rules consistent across the document (no contradictions like
"must be >= 0" in one section with a negative default in another)
- Same rule appearing in multiple places identical in meaning
### A3. Completeness
- All public APIs / features documented
- Newly added features or parameters reflected in the document
- Removed or deprecated features marked accordingly
- Edge cases and limitations documented
- All conditional branches exhaustively covered (no undocumented "else" cases)
- Sequential steps complete with no missing intermediate steps
- Undefined behaviors identified (input combinations with no documented result)
### A4. Reference Validity
> Do not attempt to verify URL reachability.
- Internal cross-references point to existing sections or files
- External links / URLs well-formed and not obviously outdated
- Referenced file paths, tool names, command examples actually exist
---
## B. Clarity & Structure
Improvements to readability, unambiguity, and organization.
### B1. Ambiguity Detection
- No descriptions interpretable in multiple ways
- Conditional statements precise ("should" vs "must", "may" vs "will")
- Boundary conditions clearly stated (inclusive vs exclusive, "at least" vs "exactly")
### B2. Simplification
> Only flag when the same information is stated more than once in different sections.
- Redundant paragraphs or sections repeating the same information consolidated
### B3. Logical Flow
- Information presented in logical order
- Related topics grouped together
- Forward references minimized
### B4. Examples & Illustrations
- Existing examples correct and consistent with described behavior
### B5. Terminology Consistency
- Terms used consistently throughout the document
- Terms match codebase usage (class names, function names, enum values)
- Abbreviations defined on first use
---
## C. Formatting & Style
Polish and stylistic consistency.
### C1. Formatting Consistency
- Headings, lists, tables formatted consistently
- Code snippets properly formatted and syntax-highlighted
### C2. Grammar & Wording
- No grammatical errors or awkward phrasing
- Writing style consistent throughout
- Tone appropriate for target audience
### C3. Section Organization
- Sections appropriately sized (not too long or too short)
- Table of contents (if present) consistent with actual sections
- Deprecated or obsolete sections cleaned up
---
## Exclusion List
> Project rules override this exclusion list.
1. Pure formatting preferences not affecting readability
2. Stylistic rewrites that don't improve clarity or accuracy
3. Suggestions based on assumed future requirements, not current content
4. Suggestions to add content beyond the document's stated scope
5. Removing default or verbose attributes from examples — examples in specs and
tutorials are intentionally detailed to demonstrate available options
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |