mcpField
G
git-conventions

git-conventions

github.com/klausborgesDevelopment1111 installsUpdated 2w ago
Repository

About git-conventions

git-conventions is a repository skill that defines conventions for remotes, commit and PR titles, worktrees, and writing. It is intended to keep Git practices and repository history consistent.

Key features

  1. 01Host-based remote naming
  2. 02Commit and PR title format
  3. 03Worktree location guidance
  4. 04Repository writing style

Use cases

  1. 01Setting up repository remotes
  2. 02Writing commit or PR titles
  3. 03Choosing a worktree location

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/klausborges/workflow-skills --skill git-conventions

After installing, type/git-conventionsin Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlskill.toml

Details

From the project README

Git Conventions

Remotes

  • Name remotes by host: github for GitHub, forge for the personal Forgejo instance. Never origin.
  • Set up both remotes when possible; the second acts as a backup mirror.
  • Each repo picks one primary remote at setup. The primary owns CI and pull requests, and is what "origin" means in conversation. Default primary: github.

Commits and PR titles

First line is type(scope): description, scope optional. Types: feat, fix, docs, ci, build, chore, refactor, test, perf, revert.

Worktrees

Worktrees are optional. Manual ones live at <repo>/.worktrees/<branch> with slashes flattened to dashes, and the directory stays gitignored. Native harness worktree homes (for example Claude Code's .claude/worktrees/) are equally fine. Keep project folders free of bare worktree siblings.

Writing style

  • Plain sentences with periods and commas; sentence-case headings.
  • Write for the repo's durable history: describe the change itself, never plans, milestones, or phases. Branch names may keep stack prefixes like m2/prng since branches are deleted at merge.
  • Skip emdashes and decorative emoji.

Comments

Markdown supported