commit

Commits staged changes with enforced emoji and type conventions after running project formatters.

3|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/bravros/bravros --skill commit-bravros
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: commit
Source: https://github.com/bravros/bravros/tree/main/plugins/core/skills/commit
Command: npx skills add https://github.com/bravros/bravros --skill commit-bravros

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose consistency when developers hand-write commit messages with mixed formats, accidentally stage secrets, or forget to run formatters before committing. This Skill enforces a single emoji+type commit convention through the bravros CLI so every commit is formatted, validated, and free of sensitive files. ## Core Features & Use Cases - Convention-enforced commits: Uses bravros commit with a fixed set of emoji+type pairs (✨ feat, πŸ› fix, ♻️ refactor, and 18 more) validated by a commit-msg hook. - Automatic formatting: Runs the project formatter (pint, prettier, ruff, gofmt, or cargo fmt) before committing. - Safety guardrails: Requires explicit file naming, blocks staging of .env files and credentials, and rejects AI signatures like Co-Authored-By: Claude. - Use Case: After fixing a login bug, ask the agent to commit only auth/login.go and auth/login_test.go; it formats the code, then creates a commit like πŸ› fix(auth): reject expired refresh tokens without pushing. ## Quick Start Ask the agent to commit the current changes for the files you name, for example: commit the staged fix in src/auth.go using the commit skill.

Frequently Asked Questions about commit

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

FAQPage Schema
How do I write a conventional commit message with emoji and type?β–Ό

Use the format `<emoji> <type>[(scope)]: <subject>`, for example `πŸ› fix(auth): reject expired tokens`. Keep the subject under 50 characters, in present tense and lowercase, and put extra detail in the commit body.

How do I commit changes without pushing them in git?β–Ό

Run `bravros commit "<emoji> <type>: <subject>" <files...>` with the specific files to include. The command formats and commits only; pushing is handled separately by the push or ship workflows.

What emoji and type pairs are allowed in commit messages?β–Ό

The accepted pairs include ✨ feat, πŸ› fix, πŸ“š docs, πŸ’„ style, ♻️ refactor, ⚑ perf, πŸ§ͺ test, πŸ”§ build, 🧹 chore, πŸ”’ security, πŸ—ƒοΈ migration, πŸ“¦ deps, πŸš€ deploy, πŸ€– ci, πŸ”₯ remove, 🩹 hotfix, πŸ”€ merge, πŸ” debug, πŸ”™ revert, and 🌐 i18n.

Why was my commit rejected by the commit-msg hook?β–Ό

Rejections happen when the message lacks a valid emoji+type pair, the subject exceeds the length limit, or it contains AI signatures like `Co-Authored-By: Claude`. Remove the signature and match one of the 21 accepted pairs.

Can I commit directly on the main branch?β–Ό

It depends on the repository policy. Run `bravros config get police.direct_main`; if it prints `true`, committing on main is normal, otherwise the repo is PR-gated and you should create a branch first.

Why should I avoid git add with wildcards before committing?β–Ό

Blanket staging can sweep in `.env` files, credentials, or API keys, which must never be committed. Name each file explicitly in the commit command so only intended changes are staged.