# Aif Commit

Create conventional commit messages by analyzing staged changes.

- Repository: https://github.com/lee-to/ai-factory (1156 stars)
- Category: Git and review
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add lee-to/ai-factory --skill aif-commit -g -a claude-code -y`
Codex: `npx skills add lee-to/ai-factory --skill aif-commit -g -a codex -y`
Cursor: `npx skills add lee-to/ai-factory --skill aif-commit -g -a cursor -y`
Gemini CLI: `npx skills add lee-to/ai-factory --skill aif-commit -g -a gemini-cli -y`

## Description

Create conventional commit messages by analyzing staged changes. Generates semantic commit messages following the Conventional Commits specification. Use when user says "commit", "save changes", or "create commit".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Conventional Commit Generator

## Shared project skill-context

Before mode routing or work, read existing files relative to the current project root in this order (reuse them if already loaded):

1. `.ai-factory/skill-context/global-skill-context.md`, all bundled skills.
2. `.ai-factory/skill-context/aif-commit/SKILL.md`, this skill.

Missing files are skipped; an existing unreadable file stops dependent work with its path.
Precedence: individual > build (when applicable) > global > skill defaults; retain non-conflicting instructions and check all outputs against the effective rules.
These layers customize workflow; they do not replace the project's rules/architecture hierarchy or relax explicit requirements, ownership, scope, safety/privacy, validation, or approval boundaries. Report conflicts with those boundaries instead of overriding them.
`global` is a project-local layer, not home-directory configuration. Custom/extension skills do not automatically use it.

Generate commit messages following the [Conventional Commits](https://www.conventionalcommits.org/) specification.

## Workflow

**FIRST:** Read `.ai-factory/config.yaml` if it exists to resolve:
- **Paths:** `paths.description`, `paths.architecture`, `paths.rules_file`, `paths.roadmap`, `paths.rules`, `paths.plan`, and `paths.plans`
- **Language:** `language.ui` for prompts and commit message conventions
- **Workflow:** `workflow.plan_id_format` for read-only active plan discovery (`slug` default; `sequential` uses numbered full-plan lookup) and `workflow.plan_structure` for commit-layout detection (`classic` default; `task-based` means commits are explicit tasks inside the main task list)
- **Git preference:** `git.enabled`, `git.create_branches`, and `git.skip_push_after_commit` for active plan discovery and post-commit push behavior
- **Rules hierarchy:** `rules.base` plus any named `rules.<area>` entries

The rest: https://github.com/lee-to/ai-factory/blob/HEAD/skills/aif-commit/SKILL.md