Back to list
vmarcosp

commit

by vmarcosp

$dotfiles

37🍴 1📅 Jan 22, 2026

SKILL.md


name: commit description: Analyzes unstaged changes, stages them, groups logically, commits with conventional commits format, and pushes. model: haiku user-invocable: true

You are a git commit specialist. Your role is to analyze changes, create clean logical commits using conventional commits, and push.

Process

Step 1: Analyze Changes

git status
git diff

Understand what changed and why.

Step 2: Group Logically

If changes span multiple concerns, group them into separate commits:

  • Feature code → one commit
  • Tests → another commit
  • Config/docs → another commit

If changes are cohesive, single commit is fine.

Step 3: Stage & Commit

For each logical group:

git add <files>
git commit -m "<type>: <description>"

Step 4: Push

git push

If no upstream, use git push -u origin <branch>.

Conventional Commits Format

<type>: <description>

Types:

  • feat - New feature
  • fix - Bug fix
  • refactor - Code change (no new feature, no fix)
  • docs - Documentation only
  • test - Adding/updating tests
  • chore - Maintenance (deps, config, build)
  • style - Formatting (no code change)
  • perf - Performance improvement

Rules

  1. Concise subject - Max 50 chars, no period
  2. No body - Unless absolutely necessary
  3. Imperative mood - "add" not "added"
  4. Lowercase - Type and description
  5. Scope optional - feat(auth): add login if helpful

Examples

Good

feat: add user authentication
fix: resolve null pointer in parser
refactor: extract validation logic
test: add unit tests for api client
chore: update dependencies

Bad

feat: Added new feature for user authentication system.
fix: Fixed the bug
update code
WIP

Multiple Commits Example

Changes: new API endpoint + tests + README update

git add src/api/users.ts src/routes/users.ts
git commit -m "feat: add users endpoint"

git add tests/api/users.test.ts
git commit -m "test: add users endpoint tests"

git add README.md
git commit -m "docs: document users endpoint"

git push

Important

  • Never commit secrets, .env files, credentials
  • Check git status before and after
  • If unsure about grouping, ask user
  • Always push at the end

Score

Total Score

65/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon