git-conventions

English | 한국어

An Agent Skill that enforces consistent Git commit messages, PR templates, and AI review analysis across projects.

Works with Claude Code, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, Amp, and 40+ agents.

Installation

Option 1: Skills CLI (All Agents)

npx skills add chanmuzi/git-conventions

The interactive installer will guide you through:

1. Select skills to install — use space to toggle each skill
   • commit — Create a git commit following project conventions
   • pr — Create a pull request following project conventions
   • issue — Create a GitHub issue with templates and auto-labeling
   • review — Review AI-generated PR review comments
2. Which agents do you want to install to? — select your agents (e.g. Codex, Cursor, Gemini CLI, GitHub Copilot, …)
3. Installation scope — Project (current repo only) or Global (available across all projects)
4. Installation method — Symlink (recommended) or Copy
5. Confirm and done

To install all skills at once without prompts:

npx skills add chanmuzi/git-conventions --skill commit --skill pr --skill issue --skill review -g

Option 2: Claude Code Plugin

# Add marketplace
/plugin marketplace add chanmuzi/git-conventions

# Install plugin
/plugin install git-conventions@git-conventions

Update

Recommended: Enable auto-update to receive new features and fixes automatically.
See platform-specific instructions below.

Skills CLI

# Check for available updates
npx skills check

# Update all installed skills
npx skills update

If you installed with Symlink (recommended), a single update applies to all agents at once. Copy installs require updating each copy individually.

Skills CLI does not auto-update. Run npx skills check periodically, or after major releases announced in the changelog.

Claude Code Plugin

# Update the plugin
/plugin update git-conventions@git-conventions

Or enable auto-update for hands-free upgrades (recommended):

/plugin → Marketplaces tab → select marketplace → Enable auto-update

Skills

Skill prefix by agent: Claude Code uses / (e.g., /commit), Codex CLI uses $ (e.g., $commit).

/commit — Create a Git Commit

Analyzes your staged/unstaged changes and proposes a commit message following the conventional commit format.

/commit

Commit message format:

{type}: {description}
{type}({scope}): {description}

Types: feat, fix, refactor, style, docs, test, perf, chore, hotfix

/pr — Create a Pull Request

Creates a PR with a structured template. Automatically detects whether to use the Individual PR template or the Release PR template.

/pr              # Individual PR (Feat, Fix, Refactor, etc.)
/pr release      # Release PR (dev → main integration)

PR title format:

{Type}: {description}               # Individual (e.g., Feat: add new feature)
Release: dev → main 통합 (vX.Y.Z)  # Release

/issue — Create a GitHub Issue

Creates a structured issue with the appropriate template and auto-assigns type/priority labels.

/issue             # General issue (type inferred from context)
/issue bug         # Bug report
/issue feature     # Feature request

Templates: Bug Report, Feature Request, General
Auto-labeling: type: bug, type: feature, type: enhancement, priority: critical/high/medium/low, etc.

/review — Review AI PR Comments

Collects AI-generated review comments (CodeRabbit, Copilot, etc.) from a PR, analyzes their validity against the actual code, and discusses findings with you.

/review          # Review current branch's PR
/review 42       # Review PR #42

Language Behavior

All commands write output (commit messages, PR titles/body) in the language configured in your project's CLAUDE.md. If no language is set, the user's conversational language is used.

Technical terms are kept in their original form to preserve clarity — no forced translations.

Conventions at a Glance

Integration with CLAUDE.md

Add the following to your global ~/.claude/CLAUDE.md to reference these conventions:

## Git Conventions
- Commit: `{type}: {description}` (lowercase prefix: feat, fix, refactor, style, docs, test, perf, chore, hotfix)
- Branch: `{type}/{english-kebab-case}` (feat/, fix/, refactor/, docs/, hotfix/)
- PR title: `{Type}: {description}` (capitalized prefix: Feat, Fix, Refactor, Perf, etc.)
- Release PR: `Release: dev → main 통합 (vX.Y.Z)`
- Use `/commit`, `/pr`, `/pr release`, `/issue`, `/review` commands for full workflows

License

MIT