Agent skill

Git Conventional Commits

by vishiri in vishiri/fantasia-archive

Splits working tree changes into logical Git commits with conventional messages (feat, fix, test, chore, refactor, style, docs).

GPL-3.0Auto-check passedDevelopment

Install Git Conventional Commits

skills CLI
$ npx skills add vishiri/fantasia-archive --skill git-conventional-commits -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vishiri/fantasia-archive git-conventional-commits --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vishiri/fantasia-archive.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/git-conventional-commits .claude/skills/git-conventional-commits && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
git-conventional-commits
GitHub stars
409
Token cost
~730 tokens
SKILL.md length
252 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
GPL-3.0

At a glance

Splits working tree changes into logical Git commits with conventional messages (feat, fix, test, chore, refactor, style, docs).

  • Works in 7 steps: Inspect: git status, git diff, git diff… → Full quality gate: yarn testbatch:verify… → Storybook gate: changed… → …
  • The user asks to commit
  • SKILL.md covers Allowed types, Workflow (default when user…, Rules and Final cleanup override, plus 2 more sections
  • Calls git and yarn

What it does

Git Conventional Commits is an agent skill from vishiri/fantasia-archive. Splits working tree changes into logical Git commits with conventional messages (feat, fix, test, chore, refactor, style, docs). Proposes commits one at a time and waits for explicit user approval before each git commit. Use when the user asks to commit, split commits, stage by topic, or use conventional / semantic commit messages.

Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Commit messages. It works with Git. The repository describes itself as: A world-builder's best friend! The licence is GPL-3.0.

When your agent uses it

  • The user asks to commit
  • Use conventional / semantic commit messages

Example prompts

  • “Use the git-conventional-commits skill to split working tree changes into logical Git commits with conventional messages (feat, fix, test, chore…”
  • “/git-conventional-commits”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Inspect: git status, git diff, git diff --staged
  2. Full quality gate: yarn testbatch:verify one terminal (testing-terminal-isolation.mdc). Dev scoped gate during edits does not substitute…
  3. Storybook gate: changed src/components/** — stories/mocks. Skip changelog-only repair
  4. Changelog gate: update changeLog.md before commit; prefer same commit as product work — fantasia-changelog-en-us
  5. Plan: ordered commits — type + subject + paths
  6. Approval loop (when user asked per-commit approval): present next commit → wait explicit OK → git add those paths only → git commit
  7. Single commit / no step-by-step: valid type: message after gates

What it can do on your machine

Read from SKILL.md and the folder at commit 26d4648. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • yarn

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and yarn, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Git Conventional Commits loads about 730 tokens when it runs. Until then it costs about 90 tokens; SKILL.md has 252 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~730

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vishiri/fantasia-archive at commit 26d4648, republished under its GPL-3.0 licence (© vishiri). 252 words, ~730 tokens.

Download SKILL.mdSave it as .claude/skills/git-conventional-commits/SKILL.md (or your agent's skills folder).
name
git-conventional-commits
description
Splits working tree changes into logical Git commits with conventional messages (feat, fix, test, chore, refactor, style, docs). Proposes commits one at a time and waits for explicit user approval before each git commit. Use when the user asks to commit, split commits, stage by topic, or use conventional / semantic commit messages.

Conventional commits — logical splits and approval loop

Allowed types

Exactly one: feat | fix | test | chore | refactor | style | docs.

TypeUse for
featNew user-visible behavior
fixBug fixes
testTests only
choreDeps, CI, tooling, housekeeping
refactorRestructure, same behavior
styleFormat/lint autofix, no logic
docsREADME, AGENTS, rules/skills, doc comments

Format: type: imperative subject — lowercase type, space after colon, ~72 chars, no trailing period.

Local enforcement: .husky/commit-msg → yarn lint:commit. git commit --no-verify only when must bypass hooks.

Workflow (default when user wants multiple commits)

  1. Inspect: git status, git diff, git diff --staged
  2. Full quality gate: yarn testbatch:verify one terminal (testing-terminal-isolation.mdc). Dev scoped gate during edits does not substitute. Changelog-only exception: only i18n/*/documents/changeLog.md + full gate already passed after substantive edits
  3. Storybook gate: changed src/components/** — stories/mocks. Skip changelog-only repair
  4. Changelog gate: update changeLog.md before commit; prefer same commit as product work — fantasia-changelog-en-us
  5. Plan: ordered commits — type + subject + paths
  6. Approval loop (when user asked per-commit approval): present next commit → wait explicit OK → git add those paths only → git commit
  7. Single commit / no step-by-step: valid type: message after gates

Rules

  • Never commit without approval when user requested per-commit approval
  • Never mix unrelated concerns in one commit
  • Prefer small reviewable chunks
  • refactor for production moves; chore for repo/meta
  • No skipping changelog for substantive work
  • No skipping Storybook for src/components/** product commits

Final cleanup override

Final cleanup → fantasia-final-cleanup: verify, changelog, logical commits, push — may commit without per-commit approval unless user interrupts.

Types

Shared types → types/. See types-folder.mdc.

© vishiri, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .cursor/skills/git-conventional-commits of vishiri/fantasia-archive.

Open the folder on GitHubat commit 26d4648

Compare with similar skills

Git Conventional Commits next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Git Conventional Commits compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Git Conventional Commits this skillvishiri/fantasia-archive409—~730Automated safety check: PassGPL-3.0
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
ToolJet Multi-Repo CommitToolJet/ToolJet41k—~1.3kAutomated safety check: PassAGPL-3.0
Git Workflow and Versioningaddyosmani/agent-skills103k2 repos~3.5kAutomated safety check: NotesMIT
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT

Similar skills

  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Commits changes across ToolJet's root repo and its server/ee and frontend/ee submodules, writing messages from the diffs and updating submodule pointers in order.

    41k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    103k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes
  • React Router Pull Request Creator

    remix-run/react-router

    Packages finished React Router work into a draft pull request: branch, commit, push, a written PR body and the right GitHub labels.

    57k GitHub stars~2.5k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Commits changes in the Saleor codebase and works through pre-commit hook failures from ruff, mypy, the GraphQL schema check and the migrations check.

    23k GitHub stars~575 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from vishiri/fantasia-archive

All 35 skills in this repo
  • Caveman Commit

    vishiri/fantasia-archive

    Ultra-compressed commit message generator. An agent skill from vishiri/fantasia-archive.

    409 GitHub starsUsed in 13 repos~642 tokens
    Auto-check passed
  • Caveman Review

    vishiri/fantasia-archive

    Ultra-compressed code review comments. An agent skill from vishiri/fantasia-archive.

    409 GitHub starsUsed in 12 repos~674 tokens
    Auto-check passed
  • Caveman Compress

    vishiri/fantasia-archive

    Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens.

    409 GitHub starsUsed in 9 repos~1.1k tokens
    Auto-check: notes
  • Cavecrew

    vishiri/fantasia-archive

    Decision guide for delegating to caveman-style subagents. An agent skill from vishiri/fantasia-archive.

    409 GitHub starsUsed in 7 repos~1k tokens
    Auto-check passed
  • Caveman Help

    vishiri/fantasia-archive

    Quick-reference card for all caveman modes, skills, and commands.

    409 GitHub starsUsed in 6 repos~572 tokens
    Auto-check passed
  • Fantasia Context Menu Dividers

    vishiri/fantasia-archive

    Context menu divider policy: full primary-bright group separators vs low-opacity separatorAlt between consecutive items in the same group.

    409 GitHub stars~741 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Git Conventional Commits

What does Git Conventional Commits do?

Splits working tree changes into logical Git commits with conventional messages (feat, fix, test, chore, refactor, style, docs). Git Conventional Commits is an agent skill from vishiri/fantasia-archive. Splits working tree changes into logical Git commits with conventional messages (feat, fix, test, chore, refactor, style, docs).

When should I use Git Conventional Commits?

Git Conventional Commits fits situations like: the user asks to commit; use conventional / semantic commit messages.

How do I install Git Conventional Commits in Claude Code?

Run `npx skills add vishiri/fantasia-archive --skill git-conventional-commits -a claude-code`. Or copy the skill folder (.cursor/skills/git-conventional-commits in vishiri/fantasia-archive) into .claude/skills/git-conventional-commits in your project. Claude Code loads it when a task matches its description.

How do I install Git Conventional Commits in Codex?

Run `npx skills add vishiri/fantasia-archive --skill git-conventional-commits -a codex`. Or copy the skill folder (.cursor/skills/git-conventional-commits in vishiri/fantasia-archive) into .agents/skills/git-conventional-commits in your project. Codex loads it when a task matches its description.

Can I use Git Conventional Commits in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vishiri/fantasia-archive --skill git-conventional-commits -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/git-conventional-commits, .gemini/skills/git-conventional-commits, .github/skills/git-conventional-commits and .opencode/skills/git-conventional-commits in your project.

What does Git Conventional Commits need to run?

Going by SKILL.md and its folder, Git Conventional Commits needs the command-line tools its instructions call (git and yarn).

Does Git Conventional Commits access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Git Conventional Commits safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Git Conventional Commits use?

Git Conventional Commits is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Git Conventional Commits use?

About 730 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Git Conventional Commits?

Skills that share tags, products or a category with Git Conventional Commits: React Router Release Notes Prep (remix-run/react-router, 57k stars), ToolJet Multi-Repo Commit (ToolJet/ToolJet, 41k stars), Git Workflow and Versioning (addyosmani/agent-skills, 103k stars) and React Router Pull Request Creator (remix-run/react-router, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Git Conventional Commits?

vishiri (a GitHub user) maintains it in vishiri/fantasia-archive, which has 409 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 7, 2026.

Source: vishiri/fantasia-archive on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.