Claude Code Plugins

Community-maintained marketplace

Feedback

git-workflow

@vereis/nix-config
36
0

MANDATORY for creating branches, commits, or pull requests - defines commit message formats, branching conventions, and PR best practices. ALWAYS consult this skill before ANY mutating git operation.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name git-workflow
description MANDATORY for creating branches, commits, or pull requests - defines commit message formats, branching conventions, and PR best practices. ALWAYS consult this skill before ANY mutating git operation.

Mandatory

MANDATORY: ALWAYS consult this skill before ANY git operation (branch, commit, PR). CRITICAL: Use /code:check/commit/pr commands, NEVER run git commands directly. NO EXCEPTIONS: Skipping this skill = broken workflow = wasted time and broken CI.

Subagent Context

IF YOU ARE A SUBAGENT: You are already executing within a subagent context and spawning additional subagents will not work. Do not attempt to spawn subagents from this skill. Instead, follow the git workflow process directly and return results to the primary agent who will handle any necessary subagent delegation.

Core Principles

  1. Atomic commits - Each commit represents single logical change
  2. Clear messages - Commit messages explain purpose, not implementation
  3. Consistent format - Use standardized prefixes and structure
  4. Test before commit - All commits MUST pass tests
  5. Lint before commit - All commits MUST pass linting
  6. Subagent delegation - ALWAYS use /code:check/commit/pr commands

Structure

This skill provides git workflow knowledge across focused files:

  • branching.md - Branch naming conventions, creation workflow
  • commits.md - Commit message formats, rules, workflow
  • pr-practices.md - Pull request creation, quality checks, templates

Reference these files based on your task:

  • Starting work → Read branching.md
  • Making commits → Read commits.md
  • Creating PRs → Read pr-practices.md

Workflow Summary

Quick Reference:

Before ANY coding:

  1. Consult branching.md - Create appropriately named branch
  2. Update ticket status to "In Progress" (if applicable)

Before EVERY commit:

  1. Consult commits.md - Understand format and workflow
  2. Run /code:check (tests)
  3. Run /code:check (lint)
  4. Use /code:commit (NEVER git commit directly)

Before creating PR:

  1. Consult pr-practices.md - Understand requirements
  2. Run ALL quality checks via discovery skill. Read $HOME/.config/opencode/skills/discovery/ci.md for CI command discovery
  3. Verify all commits follow format
  4. Use /code:pr (NEVER gh pr create directly)

Anti-Rationalization

THESE EXCUSES NEVER APPLY

"I know the git workflow, don't need to consult the skill" WRONG: ALWAYS consult to ensure compliance

"This is a quick fix, I'll skip quality checks" WRONG: EVERY commit needs tests/lint

"I can run git commands faster directly" WRONG: Subagents are MANDATORY

"Branch name doesn't matter" WRONG: Consistent naming is REQUIRED

"I'll clean up commits later" WRONG: Make clean commits from the start

NO EXCEPTIONS

Compliance Checklist

MANDATORY CHECKLIST:

☐ Consulted relevant git-workflow file (branching/commits/pr-practices) ☐ Created branch with correct naming (if starting work) ☐ Ran /code:check for tests (if committing) ☐ Ran /code:check for lint (if committing) ☐ Used /code:commit (if committing) ☐ Used /code:pr (if creating PR) ☐ Did NOT run git/gh commands directly ☐ Followed atomic workflow pattern

IF ANY UNCHECKED THEN EVERYTHING FAILS