lispking / git-skills

Listed

A powerful Claude Code Git assistant skill that provides intelligent branch management, commit message conventions, workflow assistance, and code review guidance.

mainToolSkill View source

Installation

npx -y @deepseek-ai/dsh plugin --profile web add github:lispking/git-skills

This installation command is an unverified starting point generated from the GitHub repository address.

README

Maintainer-authored documentation snapshot.

View on GitHub ↗
Commit dd6a5a2Synced Aug 18, 2026

🌿 Git Skills

A powerful Claude Code Git assistant skill that provides intelligent branch management, commit message conventions, workflow assistance, and code review guidance.

Features

FeatureDescription
🌱 Smart Branch ManagementAuto-suggest branch naming conventions, quick create/switch/cleanup branches
✍️ Expert Commit AssistantGenerate detailed, professional commit messages following Conventional Commits
🔄 PR Workflow AssistantPR creation checklist, auto-sync main branch, conflict resolution guidance
🔍 Code Review AssistantCheck change scope, sensitive data, commit message quality
📊 Git StatisticsContribution stats, commit history, line change metrics

Installation

In Claude Code, run:

/plugin marketplace add lispking/git-skills
/plugin install git-skills

Usage

Auto-trigger

Git Skills activates automatically when these operations are detected:

  • git commit - Smart commit suggestions
  • git push - Pre-push checks
  • git checkout -b - Branch naming suggestions
  • git merge / git rebase - Conflict resolution guidance

Command Invocation

Tell Claude what you want to do:

Help me commit these changes
Create a feature branch for user authentication
Sync my branch with main
Show recent commit statistics

Commit Convention

Commit Types

TypeDescriptionExample
featNew featurefeat: implement JWT-based user authentication
fixBug fixfix: resolve race condition in concurrent database writes
docsDocumentationdocs: add comprehensive API usage examples
styleCode stylestyle: enforce consistent import ordering across modules
refactorRefactoringrefactor: decouple business logic from presentation layer
testTeststest: add integration tests for payment gateway
choreBuild/toolschore: migrate build pipeline from CircleCI to GitHub Actions
perfPerformanceperf: implement connection pooling for database queries
ciCI/CDci: add automated security scanning to pipeline

Commit Format

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

<body paragraph 1: what changed and why>

<body paragraph 2: implementation details, considerations>

<footer>

Expert-level requirements:

  • Subject: specific, imperative mood, max 50 chars, no period
  • Body: mandatory multi-paragraph for all non-trivial changes
    • Paragraph 1: explain WHAT changed and WHY (motivation)
    • Paragraph 2: key implementation details, trade-offs, breaking changes
    • Use blank lines to separate paragraphs
  • Include: problem context, approach rationale, side effects, breaking changes
  • Footer: issue references, breaking change notices
  • NO Co-Authored-By: signatures
  • NO AI-generated signatures
  • NO single-sentence commit messages

Branch Naming Convention

feature/123-user-auth      # New features
bugfix/456-fix-login       # Bug fixes
hotfix/urgent-patch        # Critical fixes
refactor/api-cleanup       # Code refactoring
docs/readme-update         # Documentation
test/auth-tests            # Test-related

Configuration

Create .gitskills.json in project root:

{
  "commit": {
    "types": ["feat", "fix", "docs", "style", "refactor", "test", "chore"],
    "scopes": ["api", "ui", "auth", "db"],
    "requireScope": false,
    "requireBody": true
  },
  "branch": {
    "mainBranch": "main",
    "namingPattern": "{type}/{ticket-id}-{description}"
  }
}

Project Structure

git-skills/
├── .claude-plugin/
│   ├── plugin.json       # Plugin config (supports /plugin install)
│   └── marketplace.json  # Marketplace display config
├── skills/
│   └── git/
│       └── SKILL.md      # Skill core documentation (official spec)
├── .gitskills.json       # Configuration example
└── README.md             # User documentation

License

MIT License

Contributing

Issues and PRs welcome!

Project files and signals

Shown items are public repository signals detected in the directory snapshot.

Plugin manifestDetected

Repository information

License
MIT
Last updated
Apr 6, 2026, 11:59 PM

Install deliberately

Review source code, permissions, lifecycle hooks, dependencies and network access. Test untrusted plugins in an isolated environment.