caveman-review

Solid

Ultra-compressed code review comments. Cuts noise from PR feedback while preserving the actionable signal. Each comment is one line: location, problem, fix. Use when user says "review this PR", "code review", "review the diff", "/review", or invokes /caveman-review. Auto-triggers when reviewing pull requests.

AI & Automation 485 stars 58 forks Updated today MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
89
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

Write code review comments terse and actionable. One line per finding. Location, problem, fix. No throat-clearing. ## Rules **Format:** `L<line>: <problem>. <fix>.` โ€” or `<file>:L<line>: ...` when reviewing multi-file diffs. **Severity prefix (optional, when mixed):** - `๐Ÿ”ด bug:` โ€” broken behavior, will cause incident - `๐ŸŸก risk:` โ€” works but fragile (race, missing null check, swallowed error) - `๐Ÿ”ต nit:` โ€” style, naming, micro-optim. Author can ignore - `โ“ q:` โ€” genuine question, not a suggestion **Drop:** - "I noticed that...", "It seems like...", "You might want to consider..." - "This is just a suggestion but..." โ€” use `nit:` instead - "Great work!", "Looks good overall but..." โ€” say it once at the top, not per comment - Restating what the line does โ€” the reviewer can read the diff - Hedging ("perhaps", "maybe", "I think") โ€” if unsure use `q:` **Keep:** - Exact line numbers - Exact symbol/function/variable names in backticks - Concrete fix, not "consider refactoring this" - The *why* if the fix isn't obvious from the problem statement ## Examples โŒ "I noticed that on line 42 you're not checking if the user object is null before accessing the email property. This could potentially cause a crash if the user is not found in the database. You might want to add a null check here." โœ… `L42: ๐Ÿ”ด bug: user can be null after .find(). Add guard before .email.` โŒ "It looks like this function is doing a lot of things and might benefit from being broken up into smaller function...

Details

Author
stevesolun
Repository
stevesolun/ctx
Created
2 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content โ€” not just same category