Skip to main content
ClaudeWave
Skill79 repo starsupdated yesterday

smart-commit

Smart Commit provides a structured workflow for generating high-quality commits following Conventional Commits conventions. It includes pre-commit quality checks covering scope isolation and code standards, a standardized message format with type categorization (feat, fix, docs, test, refactor, style, chore, perf), and a verification checklist ensuring commits are atomic, properly formatted, and free of sensitive information. Use this skill when preparing changes for version control to maintain consistent commit history and enable automated changelog generation.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/claude-world/director-mode-lite /tmp/smart-commit && cp -r /tmp/smart-commit/skills/smart-commit ~/.claude/skills/smart-commit
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Smart Commit

Create a high-quality commit for current changes.

## Pre-Commit Checklist

### Scope Check
- [ ] Solves one problem only
- [ ] No unrelated changes
- [ ] No debug code
- [ ] No temporary files

### Quality Check
- [ ] All tests pass
- [ ] Code is formatted
- [ ] No linting errors
- [ ] Documentation updated

---

## Commit Message Format

```
<type>(<scope>): <description>

<body>

<footer>
```

### Type (Required)
| Type | Use When |
|------|----------|
| `feat` | New feature (user-visible) |
| `fix` | Bug fix |
| `docs` | Documentation only |
| `test` | Adding/updating tests |
| `refactor` | Code restructure (no behavior change) |
| `style` | Formatting (no logic change) |
| `chore` | Maintenance, dependencies |
| `perf` | Performance improvement |

### Scope (Optional)
Module, component, or file affected:
- `feat(auth): add login endpoint`
- `fix(api): handle null response`
- `docs(readme): update installation steps`

### Description (Required)
- 50 characters or less
- Present tense, imperative mood
- Lowercase first letter
- No period at end
- Describe WHAT, not HOW

---

## Examples

### Feature
```
feat(user): add email verification

Implement email verification flow for new user registration.
Users must verify email before accessing protected features.

Closes #42
```

### Bug Fix
```
fix(api): handle null response in user endpoint

Previously threw uncaught exception when user not found.
Now returns 404 with proper error message.

Fixes #67
```

---

## Commit Checklist

Before committing:
- [ ] Follows Conventional Commits format
- [ ] Subject clearly describes the change
- [ ] One commit = one logical change
- [ ] No sensitive information (.env, credentials)
- [ ] All tests pass