at-commit

Generates Conventional Commits messages from staged git changes and commits after user confirmation.

180|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/kairyou/agent-tools --skill at-commit-kairyou
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: at-commit
Source: https://github.com/kairyou/agent-tools/tree/main/skills/workflow/at-commit
Command: npx skills add https://github.com/kairyou/agent-tools --skill at-commit-kairyou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing clear, consistent commit messages is tedious and often skipped, leading to vague history like "update files". This Skill inspects your staged changes and drafts a standards-compliant Conventional Commits message, so your git history stays meaningful without manual effort. ## Core Features & Use Cases - Diff-Based Message Generation: Reads git diff --staged and produces a single-line type(scope): description title that reflects confirmed code facts, not guessed intent. - Multi-Language Support: Selects the description language via a priority chain (explicit request, repo config, global config, invocation language, recent commit history) while keeping Conventional Commits tokens in English. - Confirmation-First Workflow: Presents one or more candidate messages as a numbered list and only runs git commit after you pick or confirm; never pushes unless explicitly asked. - Use Case: After staging a bug fix across several files, invoke the skill to get a message like fix(auth): reject expired refresh tokens, reply "1" to commit, and optionally persist your preferred language to .agent-tools/config.jsonc. ## Quick Start Stage your changes with git add, then ask the agent to generate a commit message for my staged changes and confirm before committing.

Frequently Asked Questions about at-commit

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

FAQPage Schema
How do I generate a Conventional Commits message from staged changes?▼

Stage your changes with git add, then invoke the skill. It runs git diff --staged, drafts one or more candidate titles in type(scope): description format, and commits only after you pick a number or confirm.

How do I generate commit messages in Chinese or another language?▼

Pass the language when invoking, such as /at-commit zh-CN, or set at-commit.language in .agent-tools/config.jsonc or ~/.agent-tools/config.jsonc. Conventional Commits tokens like feat and fix stay in English.

Does the skill commit or push automatically without confirmation?▼

No. It always shows the generated message first and runs git commit only after you reply with a number, "commit", or "ok". It never runs git push unless you explicitly ask.

What happens if I run it with no staged changes?▼

The skill checks git diff --staged first. If the diff is empty, it tells you to run git add first and stops without generating a message.

How are breaking changes handled in commit messages?▼

Breaking changes are marked inline as type(scope)!: description on a single line. The skill does not use a BREAKING CHANGE footer, since all messages are title-only.

What if my staged changes contain unrelated edits?▼

The skill proposes separate split messages for each coherent unit plus one conservative summary message, letting you choose between splitting the commit or using the summary.