# Semantic Commit

> Generate semantic commit messages from staged changes. Use when committing code to produce consistent, well-structured commit messages following conventional commit format.

- **Type:** Skill
- **Install:** `agentstack add skill-jonmagic-skills-semantic-commit`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jonmagic](https://agentstack.voostack.com/s/jonmagic)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** ISC
- **Upstream author:** [jonmagic](https://github.com/jonmagic)
- **Source:** https://github.com/jonmagic/skills/tree/main/skills/semantic-commit

## Install

```sh
agentstack add skill-jonmagic-skills-semantic-commit
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Semantic Commit

Generate commit messages following the conventional commit format: `(): `

## Format

```
(): 

```

- **type**: Required. Category of change.
- **scope**: Optional. Omit if unclear or not valuable.
- **subject**: Present tense, no period, under 72 chars.
- **body**: Optional. Explain what/why, not how. Wrap at 72 chars.

## Types

| Type | Use for |
|------|---------|
| `feat` | New user-facing feature |
| `fix` | Bug fix |
| `docs` | Documentation only |
| `style` | Formatting, whitespace (no logic change) |
| `refactor` | Code change that doesn't fix or add |
| `test` | Adding or updating tests |
| `chore` | Build, CI, dependencies |

## Rules

1. Subject line under 72 characters
2. Present tense ("add" not "added")
3. No period at end of subject
4. Blank line between subject and body
5. Body explains what/why, wrapped at 72 chars
6. Single-line OK for trivial changes
7. Non-trivial changes should include body

## Examples

**Trivial:**
```
docs: fix typo in readme
```

**Simple with scope:**
```
feat(auth): add password reset flow
```

**With body:**
```
fix(api): handle empty response from upstream

Add null check before parsing response body. Previously, empty
responses from the payments service caused JSON parse errors.
```

## Workflow

1. Review staged changes with `git diff --cached`
2. Identify the primary type and optional scope
3. Write subject summarizing the change
4. Add body for non-trivial changes explaining what/why
5. Commit using HEREDOC format for proper formatting

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jonmagic](https://github.com/jonmagic)
- **Source:** [jonmagic/skills](https://github.com/jonmagic/skills)
- **License:** ISC

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jonmagic-skills-semantic-commit
- Seller: https://agentstack.voostack.com/s/jonmagic
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.