caveman-commit

Generate Conventional Commits format commit messages with strict formatting rules.

1|Updated Feb 19, 2025
One-click install
npx skills add https://github.com/trystan2k/favoritable-old --skill caveman-commit-trystan2k
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caveman-commit
Source: https://github.com/trystan2k/favoritable-old/tree/main/.agents/skills/caveman-commit
Command: npx skills add https://github.com/trystan2k/favoritable-old --skill caveman-commit-trystan2k

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious work of writing overly verbose, low-value commit messages that clutter git history and waste developer time, ensuring every commit entry is clear, concise, and meaningful.

Core Features & Use Cases

  • Strict Conventional Commits compliance: Enforces correct type, optional scope, imperative mood, and length limits for commit subject lines.
  • Context-aware body generation: Only adds a commit body when the "why" behind changes is non-obvious, for breaking changes, security fixes, data migrations, or reverts, so future debuggers have necessary context.
  • Use case: After refactoring a payment processing API endpoint, use this Skill to generate a concise commit message that clearly notes the breaking change and migration deadline for other team members.

Quick Start

Invoke the caveman-commit skill to generate a terse, conventional commit message for your current staged code changes.

Frequently Asked Questions about caveman-commit

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

FAQPage Schema
How do I generate standard conventional commit messages automatically?

You can generate conventional commit messages automatically by invoking the skill to format staged git changes into strict, compliant entries with correct types, scopes, and imperative mood.

Why does my git history get cluttered with low-value commit messages?

Git history gets cluttered when developers write overly verbose or unstructured entries. Using a standardized conventional commits generator eliminates this by enforcing concise, meaningful subject lines and mandatory body content only for non-obvious changes.

What is the best way to write a git commit message for a breaking change?

The best way to write a git commit message for a breaking change is to use conventional commit formatting that enforces a 50-character imperative subject line and mandates body content explaining the rationale and migration notes.

Do I need conventional commits for all software development workflows?

Conventional commits apply to all software development workflows requiring standardized git messages, including feature additions, bug fixes, security patches, and code reverts, ensuring every git history entry remains clear and concise.

When should I include a body in my conventional commit message?

You should include a body in your conventional commit message only when the rationale behind the change is non-obvious, such as for breaking changes, security fixes, data migrations, or reverts, to provide necessary context for future debuggers.

Can I enforce a 50-character limit on git commit subject lines?

Yes, you can enforce a 50-character subject line limit by applying strict conventional commit formatting rules that also mandate imperative mood and context-aware body generation for complex code changes.