Skip to content
cccskills
FreePublished on GitHub

caveman-commit

Create short commit messages using Conventional Commits, a format that labels the type of change. Emphasize intent, keep the subject concise, and include explanatory text when breaking changes, security fixes, data migrations, or reversions require context.

OriginalShow the original description

Write a Conventional Commits message compressed to intent only. Use for "write a commit", "commit message", /commit or /caveman-commit.

See how to install

Good for

  • Writing a commit message for code changes
  • Standardizing commit message format
  • Documenting breaking changes and migration steps
  • Explaining security fixes or reverted commits

Files included (2)

  • SKILL.md2.3 KB
  • README.md1.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Write commit messages terse and exact. Conventional Commits format. No fluff. Why over what.

Rules

Subject line:

  • <type>(<scope>): <imperative summary> — <scope> optional
  • Types: feat, fix, refactor, perf, docs, test, chore, build, ci, style, revert
  • Imperative mood: "add", "fix", "remove" — not "added", "adds", "adding"
  • ≤50 chars when possible, hard cap 72
  • No trailing period
  • Match project convention for capitalization after the colon

Body (only if needed):

  • Skip entirely when subject is self-explanatory
  • Add body only for: non-obvious why, breaking changes, migration notes, linked issues
  • Wrap at 72 chars
  • Bullets - not *
  • Reference issues/PRs at end: Closes #42, Refs #17

What NEVER goes in:

  • "This commit does X", "I", "we", "now", "currently" — the diff says what
  • "As requested by..." — use Co-authored-by trailer
  • "Generated with Claude Code" or any AI attribution — unless the user's own rule requires an Assisted-by/AI-attribution trailer, then add it as a trailer
  • Emoji (unless project convention requires)
  • Restating the file name when scope already says it

Examples

Diff: new endpoint for user profile with body explaining the why

  • ❌ "feat: add a new endpoint to get user profile information from the database"
  • ✅
    feat(api): add GET /users/:id/profile
    
    Mobile client needs profile data without the full user payload
    to reduce LTE bandwidth on cold-launch screens.
    
    Closes #128
    

Diff: breaking API change

  • ✅
    feat(api)!: rename /v1/orders to /v1/checkout
    
    BREAKING CHANGE: clients on /v1/orders must migrate to /v1/checkout
    before 2026-06-01. Old route returns 410 after that date.
    

Auto-Clarity

Always include body for: breaking changes, security fixes, data migrations, anything reverting a prior commit. Never compress these into subject-only — future debuggers need the context.

Boundaries

Only generates the commit message. Does not run git commit, does not stage files, does not amend. Output the message as a code block ready to paste. "stop caveman-commit" or "normal mode": revert to verbose commit style.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

cavecrew

FreeSummary

Delegate code lookup, small edits, and diff reviews to three specialized subagents. Their compact, structured results help conserve the main agent's context, with guidance on when to delegate and when to keep work in the main conversation.

  • Locating definitions and callers
  • Making a focused edit across one or two files
  • Reviewing a diff for bugs
JuliusBrussee/caveman113.6KUpdated Oct 18, 2026

caveman

FreeSummary

Make agent replies shorter and easier to scan by putting answers first and removing filler. Preserves technical details, exact commands, numbers, and essential conditions while keeping the user's chosen language.

  • Reading concise replies in a terminal
  • Getting conclusions before explanations
  • Reducing wording while keeping technical details
JuliusBrussee/caveman113.6KUpdated Oct 18, 2026

caveman-compress

FreeSummary

Compress memory files and task lists into shorter wording to reduce input tokens. Keeps code and document structure intact, saves a readable backup separately, and sends the text to the configured model provider.

  • Shortening CLAUDE.md to reduce input tokens
  • Compressing task lists and preference files
  • Keeping readable backups of compressed files
JuliusBrussee/caveman113.6KUpdated Oct 18, 2026

caveman-discover

FreeSummary

Find LLM workflows in a codebase and label them by the job they perform, so Caveman Cloud can separate spending by workflow. Present a labeling proposal for approval, apply focused code changes, and check an affected execution path.

  • Breaking down LLM spending by job
  • Inventorying LLM use in APIs, scheduled jobs, and scripts
  • Separating evaluation spending from other workflows
JuliusBrussee/caveman113.6KUpdated Oct 18, 2026

Review Caveman Cloud spending, latency, errors, and potential improvements using current reports and traces, or individual execution records. Produce findings tied to time windows and trace IDs, while keeping measured costs, estimated opportunities, and verified savings separate.

  • Understanding which workflows drive LLM spending
  • Investigating slow responses and errors
  • Reviewing measured costs and verified savings separately
JuliusBrussee/caveman113.6KUpdated Oct 18, 2026

caveman-explore

FreeSummary

Locate relevant code in an unfamiliar repository or after a direct search fails. This read-only explorer returns a short list of file paths, verified line ranges, and relevance notes for another agent to use.

  • Find starting points in an unfamiliar codebase
  • Locate logic spread across multiple files
  • Investigate after a direct search fails
JuliusBrussee/caveman113.6KUpdated Oct 18, 2026

See all skills by JuliusBrussee

Report a problem with this skill