# Commit Messages

> Commit Messages is an Agent Skill for development published in the super-productivity/super-productivity repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Write a commit message for this repo. Use when committing, crafting a commit message, or squashing. Enforces the Angular conventional-commit format and the test-scope rule.

- Skill name: `commit-messages`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/super-productivity/super-productivity/blob/HEAD/.agents/skills/commit-messages/SKILL.md
- Repository: super-productivity/super-productivity (20,639 GitHub stars when collected)

## SKILL.md

# Commit messages

Angular conventional-commit format: `type(scope): description`.

**Types:** `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`.

**Examples:**

- `feat(tasks): add recurring task support`
- `fix(sync): handle network timeout`

**Rules:**

- Description is imperative, lower-case, no trailing period.
- **Never** `fix(test):` or `fix(e2e):` — changes to tests use the `test:` type (e.g. `test(sync): cover vector-clock pruning`).
- Scope is the touched feature/area (`tasks`, `sync`, `ui`, `plugins`, …); omit it only when the change is genuinely repo-wide.

---

Source: https://www.openparable.com/skill/development/commit-messages (OpenParable). Cite the canonical URL above.
