mirror of https://github.com/JuliusBrussee/caveman.git synced 2026-08-11 13:21:09 +02:00

Files

T

History

Julius BrusseeandClaude Opus 4.7 ed706fa098 docs: add per-skill READMEs for skills/

Add a human-facing README.md to each skill directory so users browsing
skills/ can quickly see what each skill does, how to invoke it, and an
example output. Mirrors the per-skill README pattern used by upstream
skill libraries (vercel-labs/skills, claude-code-sdk).

SKILL.md remains the LLM-facing system prompt; README.md is the human
front door.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-10 13:20:13 +02:00

README.md

docs: add per-skill READMEs for skills/

2026-05-10 13:20:13 +02:00

SKILL.md

Add mode-tracker hook and update install/docs

2026-04-09 21:09:56 +02:00

README.md

caveman-review

One-line PR comments. Location, problem, fix. No throat-clearing.

What it does

Generates code review comments in L<line>: <severity> <problem>. <fix>. format. One line per finding. Severity emoji: 🔴 bug, 🟡 risk, 🔵 nit, ❓ question. Drops "I noticed that...", hedging, and restating what the diff already shows. Keeps exact line numbers, backticked symbols, and concrete fixes.

Auto-clarity: drops terse mode for CVE-class security findings, architectural disagreements, and onboarding contexts where the author needs the why. Resumes terse for the rest.

Output only — does not approve, request changes, or run linters.

How to invoke

/caveman-review

Also triggers on "review this PR", "code review", "review the diff".

Example output

L42: 🔴 bug: user can be null after .find(). Add guard before .email.
L88-140: 🔵 nit: 50-line fn does 4 things. Extract validate/normalize/persist.
L23: 🟡 risk: no retry on 429. Wrap in withBackoff(3).
L107: ❓ q: why drop the cache here? Reads on next request will miss.

README.md

caveman-review

What it does

How to invoke

Example output

See also