caveman-review

Generate one-line code review comments for PR diffs with line references.

3|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/prefactordev/typescript-sdk --skill caveman-review-prefactordev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caveman-review
Source: https://github.com/prefactordev/typescript-sdk/tree/main/.agents/skills/caveman-review
Command: npx skills add https://github.com/prefactordev/typescript-sdk --skill caveman-review-prefactordev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ultra-compressed code review comments reduce noise from PR feedback while preserving the actionable signal.

Core Features & Use Cases

  • Generate terse, actionable one-line comments for each finding.
  • Enforce a consistent format: L<line>: <problem>. <fix>, or <file>:L<line>: ...
  • Support optional severity prefixes (🔴 bug:, 🟡 risk:, 🔵 nit:, ❓ q:).
  • Auto-triggers when reviewing pull requests.

Quick Start

Review a diff and output concise one-line comments for each finding.

Frequently Asked Questions about caveman-review

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

FAQPage Schema
How do I generate concise code review comments for a pull request diff?

To generate concise code review comments, you provide a PR diff to be analyzed, resulting in ultra-brief, actionable one-line comments for each finding. This approach reduces noise while preserving the exact line references and specific fixes needed.

What format is used for automated PR review comments?

Automated PR review comments use a consistent format of L<line>: <problem>. <fix>, or <file>:L<line>: ... for multi-file diffs. This enforces exact problem descriptions and concrete fixes, supporting optional severity prefixes like bug, risk, nit, or q.

Can I review multi-file diffs without losing exact line references?

Yes, you can review multi-file diffs without losing exact line references. The review process preserves the original context and supports the <file>:L<line> format, ensuring deterministic outputs with accurate line tracking across all changed files.

How do I add severity levels to automated linting comments?

You can add severity levels to automated linting comments by applying optional severity prefixes such as bug, risk, nit, or q. This categorizes the one-line comments generated for each finding in the PR diff, highlighting the urgency or type of issue.

What is the best way to reduce noise from PR code review feedback?

The best way to reduce noise from PR code review feedback is to use ultra-compressed, one-line comments that enforce a strict problem-and-fix format. This ensures every comment is actionable and deterministic, eliminating unnecessary explanations.

Does the review automation auto-trigger when reviewing pull requests?

Yes, the review automation auto-triggers when reviewing pull requests. It streamlines the process by automatically analyzing the provided diff and generating terse, actionable one-line comments for each finding without manual activation.