Agent skill

Atomic Git Commit

by congchuanling-dot in congchuanling-dot/Cohort

Creates atomic git commits with Conventional Commits messages, staging specific files and adding a short prose body only when a decision needs explaining.

MITAuto-check: notesDevelopment

Install Atomic Git Commit

skills CLI
$ npx skills add congchuanling-dot/Cohort --skill commit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install congchuanling-dot/Cohort commit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/congchuanling-dot/Cohort.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cohort/skills/commit .claude/skills/commit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
commit
GitHub stars
199
Token cost
~1k tokens
SKILL.md length
498 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Creates atomic git commits with Conventional Commits messages, staging specific files and adding a short prose body only when a decision needs explaining.

  • Works in 5 steps: Discover changes → Analyse the changes → Draft the commit message → …
  • Committing changes with a clean conventional message
  • SKILL.md covers Rules, Commit types, Process and Examples
  • Calls git

What it does

The skill makes the agent commit one logical change at a time, never mixing features with docs or refactors, and never staging with `git add .` or `git add -A`. It runs `git status` and `git diff`, asks which files to include when none are named, stops if the tree is clean and reads the staged files to pick a type: feat, fix, refactor, test, docs, chore or perf.

A three-question split test checks whether one change can be reverted without the other, whether the diff reads as one unit and whether the subject needs the word and, recommending a split when it does. Messages use `type(scope): description` with a subject of at most 72 characters in the imperative. A body is written only for non-obvious decisions, pitfalls avoided or patterns chosen, in at most two sentences of prose without lists, and the skill forbids AI attribution lines.

When your agent uses it

  • Committing changes with a clean conventional message
  • Deciding whether a messy working tree should be split into several commits
  • Staging only specific files for a commit

Example prompts

  • “Commit my changes to the auth module.”
  • “Commit just src/api/orders.ts and tests/orders.test.ts.”
  • “Look at my working tree and tell me whether this should be one commit or two.”

Requirements

  • A git repository with changes to commit
  • Pre-approved tools (allowed-tools): Bash, Read

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Discover changes
  2. Analyse the changes
  3. Draft the commit message
  4. Show the commit for approval
  5. Execute

What it can do on your machine

Read from SKILL.md and the folder at commit a0479a6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Atomic Git Commit loads about 1k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 498 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from congchuanling-dot/Cohort at commit a0479a6, republished under its MIT licence (© congchuanling-dot). 498 words, ~1,025 tokens.

Download SKILL.mdSave it as .claude/skills/commit/SKILL.md (or your agent's skills folder).
name
commit
description
Atomic git commit with conventional message. Use when the user says "commit", "save my changes", "commit this", or wants to create a git commit. Stages specific files, writes a conventional commit message with body explaining non-obvious decisions. Never uses git add -A.
allowed-tools
Bash, Read
user-invocable
true
argument-hint
[file1] [file2]

You are a senior engineer enforcing atomic, FAANG-level commit discipline.

Rules

  • Atomic — one logical change per commit, never mix features with docs or refactors
  • Never use git add . or git add -A — always stage specific files
  • Conventional Commits format: type(scope): short imperative description
  • Body required when there are non-obvious decisions — explain the why, not the what
  • No body needed when the subject line is self-explanatory
  • Subject line: max 72 characters, imperative mood ("add" not "added")
  • Body: prose only — no bullets, no numbered lists, no dashes
  • Body: max 2 sentences — if you need more, the commit is too big
  • Body: wrap at 72 characters per line
  • No AI attribution — no Co-Authored-By, no Claude mentions

Commit types

TypeWhen
featNew feature or test slice
fixBug fix
refactorCode change with no behaviour change
testAdding or updating tests only
docsREADME, comments, ADRs
choreConfig, dependencies, CI
perfPerformance improvement

Process

Step 1 — Discover changes

Run git status and git diff to understand what changed. List the changed files and ask the user which ones to include if $ARGUMENTS is empty. If $ARGUMENTS specifies files, stage only those.

If there are no changes (clean working tree), tell the user and stop.

Step 2 — Analyse the changes

Read the staged files to understand what changed, why, and what type applies.

Split test — ask these three questions:

  1. Can I revert one change without losing the other? (e.g. config vs applying config)
  2. Would the diff make sense to a reviewer as a single unit?
  3. Does the subject line need "and"? If yes, it's two commits.

If any answer points to a split, recommend it with the specific grouping (e.g. "config files in commit 1, formatted code in commit 2").

Show full SKILL.md (209 more words)Show less
Step 3 — Draft the commit message

Write subject line + body if needed.

Body is required when:

  • A non-obvious technical decision was made (e.g. returning Locator instead of string[])
  • A pattern was chosen over an alternative (e.g. guard assertion before removal)
  • A known pitfall was avoided (e.g. race condition, unfalsifiable test)

Body is NOT needed when:

  • The change is a straightforward count update, typo fix, or config change
  • The subject line fully explains the change

Body format — prose, not lists: Good: getErrorMessage() targets data-test="error" not data-test="error-button" — the button passes toBeVisible() but fails toContainText(). Bad: - Fixed error locator\n- Updated test assertions

Step 4 — Show the commit for approval

Display:

Files to stage:
  path/to/file1.ts
  path/to/file2.ts

Commit message:
---
type(scope): subject line

body explaining why (if needed)
---

Wait for user approval before running the commit.

Step 5 — Execute

Stage the specific files and commit with the approved message using a HEREDOC:

bash
git commit -m "$(cat <<'EOF'
type(scope): subject line

Body if needed.
EOF
)"

Report the commit hash after success. Ask if the user wants to push.

If the commit fails (e.g. pre-commit hook), report the error. Do NOT retry with --no-verify. Fix the underlying issue and create a new commit.

Examples

Simple commit:

/commit src/utils/format.ts

-> Stages only that file, drafts fix(utils): correct date format parsing

No arguments:

/commit

-> Runs git status, shows changed files, asks user which to include

With scope hint:

/commit all test files

-> Finds changed .spec.ts files, stages them, drafts test(cart): add checkout validation specs

© congchuanling-dot, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .cohort/skills/commit of congchuanling-dot/Cohort.

Open the folder on GitHubat commit a0479a6

Compare with similar skills

Atomic Git Commit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Atomic Git Commit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Atomic Git Commit this skillcongchuanling-dot/Cohort199—~1kAutomated safety check: NotesMIT
ToolJet Multi-Repo CommitToolJet/ToolJet41k—~1.3kAutomated safety check: PassAGPL-3.0
Git Workflow and Versioningaddyosmani/agent-skills102k2 repos~3.5kAutomated safety check: NotesMIT
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Saleor Commit Workflowsaleor/saleor23k—~575Automated safety check: PassBSD-3-Clause
Emoji Commit ConventionsbaptisteArno/typebot.io11k—~424Automated safety check: PassCustom licence

Similar skills

  • Commits changes across ToolJet's root repo and its server/ee and frontend/ee submodules, writing messages from the diffs and updating submodule pointers in order.

    41k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    102k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes
  • React Router Pull Request Creator

    remix-run/react-router

    Packages finished React Router work into a draft pull request: branch, commit, push, a written PR body and the right GitHub labels.

    57k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Commits changes in the Saleor codebase and works through pre-commit hook failures from ruff, mypy, the GraphQL schema check and the migrations check.

    23k GitHub stars~575 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Emoji Commit Conventions

    baptisteArno/typebot.io

    Sets the repository's convention for commit messages and pull request titles: one emoji prefix for the main intent, a concise title and clean follow-up commits.

    11k GitHub stars~424 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated yesterday
    DevelopmentAuto-check: notes

More from congchuanling-dot/Cohort

  • Python Script Runner

    congchuanling-dot/Cohort

    Runs a Python script with checks first: confirms the interpreter version, compiles it for syntax errors, verifies imports, then explains any traceback in plain language.

    199 GitHub stars~577 tokensUpdated 1 mo ago
    Auto-check: notes

Works with

Categories

Questions about Atomic Git Commit

What does Atomic Git Commit do?

Creates atomic git commits with Conventional Commits messages, staging specific files and adding a short prose body only when a decision needs explaining. ` or `git add -A`. It runs `git status` and `git diff`, asks which files to include when none are named, stops if the tree is clean and reads the staged files to pick a type: feat, fix, refactor, test, docs, chore or perf.

When should I use Atomic Git Commit?

Atomic Git Commit fits situations like: committing changes with a clean conventional message; deciding whether a messy working tree should be split into several commits; staging only specific files for a commit.

How do I install Atomic Git Commit in Claude Code?

Run `npx skills add congchuanling-dot/Cohort --skill commit -a claude-code`. Or copy the skill folder (.cohort/skills/commit in congchuanling-dot/Cohort) into .claude/skills/commit in your project. Claude Code loads it when a task matches its description.

How do I install Atomic Git Commit in Codex?

Run `npx skills add congchuanling-dot/Cohort --skill commit -a codex`. Or copy the skill folder (.cohort/skills/commit in congchuanling-dot/Cohort) into .agents/skills/commit in your project. Codex loads it when a task matches its description.

Can I use Atomic Git Commit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add congchuanling-dot/Cohort --skill commit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/commit, .gemini/skills/commit, .github/skills/commit and .opencode/skills/commit in your project.

What does Atomic Git Commit need to run?

Going by SKILL.md and its folder, Atomic Git Commit needs the command-line tools its instructions call (git). Our summary lists: A git repository with changes to commit. Its frontmatter pre-approves these tools: Bash, Read.

Does Atomic Git Commit access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Atomic Git Commit safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Atomic Git Commit use?

Atomic Git Commit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Atomic Git Commit use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Atomic Git Commit?

Skills that share tags, products or a category with Atomic Git Commit: ToolJet Multi-Repo Commit (ToolJet/ToolJet, 41k stars), Git Workflow and Versioning (addyosmani/agent-skills, 102k stars), React Router Pull Request Creator (remix-run/react-router, 57k stars) and Saleor Commit Workflow (saleor/saleor, 23k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Atomic Git Commit?

congchuanling-dot (a GitHub user) maintains it in congchuanling-dot/Cohort, which has 199 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on August 15, 2026.

Source: congchuanling-dot/Cohort on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.