Skip to content

rsicarelli/fakt / .claude/skills/commit

commit

Verified

Creates project commits — Conventional Commits format, message quality (72 char subject, 80 char body), staged-change checks, and the AI co-author trailer. Use when committing changes, running /commit, creating commit messages, or reviewing commit message quality. Make sure to use this skill whenever a git commit is being created — it is the project's commit workflow and replaces the default one.

FileKindSize
SKILL.mdskill md3.4 KB
---
name: commit
description: Creates project commits — Conventional Commits format, message quality (72 char subject, 80 char body), staged-change checks, and the AI co-author trailer. Use when committing changes, running /commit, creating commit messages, or reviewing commit message quality. Make sure to use this skill whenever a git commit is being created — it is the project's commit workflow and replaces the default one.
allowed-tools: Read, Bash, Grep, Glob
---

# Commit

Creates commits that follow the project's Conventional Commits standard and credit AI co-authorship.

## Instructions

### 1. Intercept Commit Intent

Detect: "commit", "git commit", "commit changes", "push this", "done, commit it".
Activate immediately before any commit action.

### 2. Analyze Staged Changes

```bash
git diff --cached --name-only
git diff --cached

# Check for sensitive files (BLOCK if found)
git diff --cached --name-only | grep -E '\.(env|pem|key|credentials)$'
```

**Determine commit type from changes:**
- `feat` — New feature files
- `fix` — Bug fixes
- `docs` — Only docs/comments
- `refactor` — Restructure, same behavior
- `test` — Test additions/fixes
- `build` — Build system, dependencies
- `chore` — Maintenance

**Scopes** (pick from the paths changed; omit for cross-cutting changes):

| Scope | Paths |
|-------|-------|
| `compiler` | `compiler/`, `compiler-api/` |
| `codegen` | `codegen-runtime/` |
| `gradle` | `gradle-plugin/`, `build-logic/` |
| `annotations` | `annotations/` |
| `samples` | `samples/` |
| `claude` | `.claude/`, `CLAUDE.md` |
| `ci` | `.github/` |
| `deps` | dependency bumps (`chore(deps): ...`) |
| `release` | release tooling |

Documentation-only changes use the `docs` type (`docs(gradle): ...` when scoped to one module).

### 3. Validate Commit Message

**Required format:**
```
<type>[(scope)]: <description>

[optional body]

[optional footer]
```

**Validation rules:**
- [ ] Valid type: `feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert`
- [ ] Subject ≤72 characters
- [ ] No trailing period
- [ ] Imperative mood ("add" not "added")
- [ ] Blank line between subject and body
- [ ] Body lines wrapped at 80 characters

### 4. Add the AI Co-Author Trailer

When Claude wrote or co-wrote the change, end the message with a `Co-Authored-By` trailer after a blank line:

```
Co-Authored-By: Claude <model name> <noreply@anthropic.com>
```

If the session already supplies attribution lines for commits, use those verbatim instead. One trailer per commit; no other attribution text is needed.

### 5. Execute Commit

**Only after all validations pass:**

```bash
git commit -m "$(cat <<'EOF'
<validated commit message>
EOF
)"
```

**Verify:**
```bash
git log -1 --format="%H %s"
```

### 6. Handle Edge Cases

**Multiple logical changes** — recommend splitting:
```
1. refactor(codegen): extract default-value lookup to its own strategy
2. feat(codegen): add a default for kotlin.time.Duration
3. test(codegen): cover the Duration default
```

## Error Messages

**Invalid Type:**
```
COMMIT BLOCKED — Invalid Type
"update" is not valid. Use: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
```

**Subject Too Long:**
```
COMMIT BLOCKED — Subject exceeds 72 characters (currently: {n})
Suggested: "{shortened version}"
```

## Related Skills

- **`bdd-test-runner`** — Run tests before committing
- **`compilation`** — Validate code compiles before committing
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall