Git Conventions: Guidelines for commit messages, branch naming, and version control practices

GPL-3.0Auto-check passedDevelopment

Install Git Conventions

skills CLI
$ npx skills add deadlock-mod-manager/deadlock-mod-manager --skill git-conventions -a claude-code

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

GitHub CLI
$ gh skill install deadlock-mod-manager/deadlock-mod-manager git-conventions --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/deadlock-mod-manager/deadlock-mod-manager.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/git-conventions .claude/skills/git-conventions && 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-conventions
GitHub stars
574
Token cost
~1.4k tokens
SKILL.md length
476 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
GPL-3.0

At a glance

Git Conventions: Guidelines for commit messages, branch naming, and version control practices

  • Tasks that involve Git workflow
  • SKILL.md covers Commit Message Format, Examples, Branch Naming Conventions and Gathering Git Context, plus 1 more section
  • Calls git
  • Tasks that involve Commit messages

What it does

Git Conventions is an agent skill from deadlock-mod-manager/deadlock-mod-manager. Git Conventions: Guidelines for commit messages, branch naming, and version control practices

Its SKILL.md is about 1.4k 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 Git workflow and Commit messages. It works with Git. The repository describes itself as: A mod manager for the Valve game Deadlock. The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Git workflow
  • Tasks that involve Commit messages

Example prompts

  • “/git-conventions”

What it can do on your machine

Read from SKILL.md and the folder at commit 45c273c. 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

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

  • Network

    Links to these hosts (documentation or services it may open):

    • conventionalcommits.org
    • semver.org
    • keepachangelog.com

    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 Conventions loads about 1.4k tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 476 words of instructions outside code blocks.

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

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 deadlock-mod-manager/deadlock-mod-manager at commit 45c273c, republished under its GPL-3.0 licence (© deadlock-mod-manager). 476 words, ~1,392 tokens.

Download SKILL.mdSave it as .claude/skills/git-conventions/SKILL.md (or your agent's skills folder).
name
git-conventions
description
Git Conventions: Guidelines for commit messages, branch naming, and version control practices

Git Commit and Version Control Conventions

Commit Message Format

This project follows the Conventional Commits specification for commit messages. This format enables automatic changelog generation, version bumping, and better collaboration.

Structure
text
<type>(<scope>): <subject>

[optional body]

[optional footer(s)]
Type

The type must be one of the following:

  • feat - A new feature for the user
  • fix - A bug fix
  • docs - Documentation only changes
  • style - Changes that don't affect the meaning of code (white-space, formatting, etc.)
  • refactor - Code change that neither fixes a bug nor adds a feature
  • perf - Code change that improves performance
  • test - Adding missing tests or correcting existing tests
  • build - Changes that affect the build system or external dependencies
  • ci - Changes to CI configuration files and scripts
  • chore - Other changes that don't modify src or test files
  • revert - Reverts a previous commit
Scope

The scope should be the name of the package or area affected. For this monorepo:

Apps:

  • api - Backend API service
  • bot - Discord bot
  • desktop - Desktop application
  • lockdex - Lockdex service
  • www - Web application
  • mirror-service - Mirror service

Packages:

  • common - Common utilities
  • database - Database schema and client
  • logging - Logging package
  • shared - Shared utilities
  • vpk-parser - VPK parser

Other:

  • deps - Dependency updates
  • repo - Repository-wide changes
  • release - Release-related changes
Subject

The subject contains a succinct description of the change:

  • Use the imperative, present tense: "change" not "changed" nor "changes"
  • Don't capitalize the first letter
  • No period (.) at the end
  • Keep it under 72 characters
Body (Optional)

The body should include the motivation for the change and contrast this with previous behavior.

  • Use the imperative, present tense
  • Wrap at 72 characters
  • Separate from subject with a blank line

The footer should contain information about Breaking Changes and reference issues that this commit closes.

Breaking Changes should start with BREAKING CHANGE: followed by a description.

Closes references should be on a separate line and use the format: Closes #123, #456

Show full SKILL.md (175 more words)Show less

Examples

Feature Addition
text
feat(desktop): add mod conflict detection

Implement visual indicators for mod conflicts and add conflict
resolution suggestions to the UI.

Closes #142
Bug Fix
text
fix(api): handle edge case in pagination

Fix incorrect offset calculation when page size exceeds total items.
This prevents API errors when requesting pages beyond available data.
Breaking Change
text
feat(api)!: remove deprecated v1 endpoints

BREAKING CHANGE: The /v1/mods endpoint has been removed. All clients
must migrate to the /v2/mods endpoint which provides better filtering
and pagination support.

Migration guide available at docs/migration/v1-to-v2.md
Dependency Update
text
chore(deps): update @tauri-apps/api to v2.1.0
Documentation
text
docs(readme): add installation instructions for Linux
Multiple Scopes
text
refactor(desktop,shared): extract mod validation logic to shared package
Simple Fix
text
fix(www): correct button alignment on mobile

Branch Naming Conventions

Branch Format
text
<type>/<ticket-or-description>
Types
  • feature/ - New features
  • bugfix/ - Bug fixes
  • hotfix/ - Critical fixes that need immediate deployment
  • refactor/ - Code refactoring
  • chore/ - Maintenance tasks
  • docs/ - Documentation updates
Branch Naming Rules
  • Use kebab-case for descriptions
  • Include ticket/issue numbers when applicable
  • Keep names descriptive but concise
  • Use lowercase letters
Branch Examples
bash
# With ticket number
feature/KR-123-add-mod-collections
bugfix/KR-456-fix-download-crash
hotfix/KR-789-security-patch

# Without ticket number
feature/dark-mode-toggle
bugfix/pagination-edge-case
refactor/extract-validation-logic
chore/update-dependencies
docs/add-api-examples

Gathering Git Context

Run this single command to gather all necessary information:

bash
echo "=== BRANCH ===" && git rev-parse --abbrev-ref HEAD && echo "=== STAGED FILES ===" && git diff --staged --stat && echo "=== STAGED CHANGES ===" && git diff --staged

This provides:

  • Current branch name
  • Staged files summary → determine scope (which workspace/package)
  • Actual changes → determine commit type and write description
Changesets Integration

This project uses changesets for version management. See 090-changesets.mdc for details on when and how to create changesets alongside commits.

Current branch (agents)

When running /commit or creating commits for the user, use the checked-out branch as-is. Do not create, switch to, or require a feature branch only because the current branch is main or master, unless the user explicitly asks for a different branch.

References

© deadlock-mod-manager, 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 .agents/skills/git-conventions of deadlock-mod-manager/deadlock-mod-manager.

Open the folder on GitHubat commit 45c273c

Compare with similar skills

Git Conventions 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 Conventions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Git Conventions this skilldeadlock-mod-manager/deadlock-mod-manager574—~1.4kAutomated safety check: PassGPL-3.0
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
Saleor Commit Workflowsaleor/saleor23k—~575Automated safety check: PassBSD-3-Clause
Emoji Commit ConventionsbaptisteArno/typebot.io11k—~424Automated safety check: PassCustom licence

Similar skills

  • 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 yesterday
    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 today
    DevelopmentAuto-check passed
  • Emoji Commit Conventions

    baptisteArno/typebot.io

    Sets the repository's convention for commit messages and pull request titles: one emoji prefix for the main intent, a concise title and clean follow-up commits.

    11k GitHub stars~424 tokensUpdated today
    DevelopmentAuto-check passed
  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated today
    DevelopmentAuto-check: notes

More from deadlock-mod-manager/deadlock-mod-manager

All 25 skills in this repo
  • Skill Creator

    deadlock-mod-manager/deadlock-mod-manager

    Create new agent skills following the Agent Skills specification.

    574 GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed
  • Create Auth Skill

    deadlock-mod-manager/deadlock-mod-manager

    Scaffold and implement authentication in TypeScript/JavaScript apps using Better Auth.

    574 GitHub starsUsed in 4 repos~3.4k tokens
    Auto-check passed
  • Opensrc

    deadlock-mod-manager/deadlock-mod-manager

    Fetch source code for npm, PyPI, or crates.io packages and GitHub/GitLab repos to provide AI agents with implementation context beyond types and docs.

    574 GitHub stars~910 tokensUpdated today
    Auto-check passed
  • Security Review

    deadlock-mod-manager/deadlock-mod-manager

    Security code review for Tauri/Rust/TypeScript desktop apps and Hono/oRPC APIs.

    574 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Babysit

    deadlock-mod-manager/deadlock-mod-manager

    Stay on one pull request until it is merge-ready, fixing the highest-priority blocker and telling the user when it is green.

    574 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Changeset

    deadlock-mod-manager/deadlock-mod-manager

    Generate a changeset file describing the current PR's changes.

    574 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Git Conventions

What does Git Conventions do?

Git Conventions: Guidelines for commit messages, branch naming, and version control practices. Git Conventions is an agent skill from deadlock-mod-manager/deadlock-mod-manager.

When should I use Git Conventions?

Git Conventions fits situations like: tasks that involve Git workflow; tasks that involve Commit messages.

How do I install Git Conventions in Claude Code?

Run `npx skills add deadlock-mod-manager/deadlock-mod-manager --skill git-conventions -a claude-code`. Or copy the skill folder (.agents/skills/git-conventions in deadlock-mod-manager/deadlock-mod-manager) into .claude/skills/git-conventions in your project. Claude Code loads it when a task matches its description.

How do I install Git Conventions in Codex?

Run `npx skills add deadlock-mod-manager/deadlock-mod-manager --skill git-conventions -a codex`. Or copy the skill folder (.agents/skills/git-conventions in deadlock-mod-manager/deadlock-mod-manager) into .agents/skills/git-conventions in your project. Codex loads it when a task matches its description.

Can I use Git Conventions 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 deadlock-mod-manager/deadlock-mod-manager --skill git-conventions -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-conventions, .gemini/skills/git-conventions, .github/skills/git-conventions and .opencode/skills/git-conventions in your project.

What does Git Conventions need to run?

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

Does Git Conventions access the network?

SKILL.md names 3 domains. As links in the text: conventionalcommits.org, semver.org and keepachangelog.com. This is read from the text; nothing was executed.

Is Git Conventions 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 Conventions use?

Git Conventions 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 Conventions use?

About 1.4k tokens (SKILL.md is roughly 5.6k 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 Conventions?

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

Who maintains Git Conventions?

deadlock-mod-manager (a GitHub organization) maintains it in deadlock-mod-manager/deadlock-mod-manager, which has 574 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 8, 2026.

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