Agent skill

Git Workflow

by vstorm-co in vstorm-co/pydantic-deepagents

Git operations: commits, branches, PRs, and conflict resolution

MITAuto-check: notesDevelopment

Install Git Workflow

skills CLI
$ npx skills add vstorm-co/pydantic-deepagents --skill git-workflow -a claude-code

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

GitHub CLI
$ gh skill install vstorm-co/pydantic-deepagents git-workflow --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/vstorm-co/pydantic-deepagents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/cli/skills/git-workflow .claude/skills/git-workflow && 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-workflow
GitHub stars
1.1k
Token cost
~269 tokens
SKILL.md length
129 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Git operations: commits, branches, PRs, and conflict resolution

  • Works in 4 steps: Create feature branch from main: git… → Make changes in small, focused commits → Push and create PR → …
  • Tasks that involve Git workflow
  • SKILL.md covers Commit Messages, Branch Workflow, Conflict Resolution and Safety Rules
  • Calls git

What it does

Git Workflow is an agent skill from vstorm-co/pydantic-deepagents. Git operations: commits, branches, PRs, and conflict resolution

Its SKILL.md is about 270 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. It works with Git. The repository describes itself as: Open-source, self-hosted Claude Code - a terminal AI assistant and the Python framework behind it. Tool-calling, sandboxed execution, multi-agent teams, skills, checkpoints… The licence is MIT.

When your agent uses it

  • Tasks that involve Git workflow

Example prompts

  • “/git-workflow”

Workflow steps

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

  1. Create feature branch from main: git checkout -b feat/description
  2. Make changes in small, focused commits
  3. Push and create PR
  4. After review, squash-merge to main

What it can do on your machine

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

    No URLs in SKILL.md. Its commands use git, 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 Workflow loads about 269 tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 129 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:41
    - Never commit secrets, credentials, or .env files

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 vstorm-co/pydantic-deepagents at commit 650b592, republished under its MIT licence (© vstorm-co). 129 words, ~269 tokens.

Download SKILL.mdSave it as .claude/skills/git-workflow/SKILL.md (or your agent's skills folder).
name
git-workflow
description
Git operations: commits, branches, PRs, and conflict resolution
tags
git, workflow
version
1.0.0

Git Workflow

Commit Messages

Format: <type>: <description>

Types: feat, fix, refactor, test, docs, style, chore

  • Description starts with lowercase verb
  • Max 72 characters for first line
  • Add body for complex changes

Branch Workflow

  1. Create feature branch from main: git checkout -b feat/description
  2. Make changes in small, focused commits
  3. Push and create PR
  4. After review, squash-merge to main

Conflict Resolution

  1. git fetch origin
  2. git rebase origin/main (or merge if team prefers)
  3. For each conflict:
    • Read both versions carefully
    • Understand the intent of each change
    • Resolve preserving both intents
    • Test after resolving
  4. git rebase --continue

Safety Rules

  • Never force-push to main/master
  • Never commit secrets, credentials, or .env files
  • Always check git diff before committing
  • Use git stash before switching branches with uncommitted changes

© vstorm-co, MIT. 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 apps/cli/skills/git-workflow of vstorm-co/pydantic-deepagents.

Open the folder on GitHubat commit 650b592

Compare with similar skills

Git Workflow 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 Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Git Workflow this skillvstorm-co/pydantic-deepagents1.1k—~269Automated safety check: NotesMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Migrate Internal Package into GhostTryGhost/Ghost55k—~3.8kAutomated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    55k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Git Merge Conflict Resolver

    tailcallhq/forgecode

    Resolves Git merge conflicts with a plan-first workflow that keeps both sides' intent, regenerates lock files and backs up deleted-but-modified files.

    7.6k GitHub starsUsed in 1 repo~4.5k tokens
    DevelopmentAuto-check passed

More from vstorm-co/pydantic-deepagents

All 14 skills in this repo
  • Data Formats

    vstorm-co/pydantic-deepagents

    Working with diverse data formats: binary, text, structured, and custom

    1.1k GitHub stars~714 tokensUpdated 2 days ago
    Auto-check passed
  • Diagram Design

    vstorm-co/pydantic-deepagents

    Best practices for creating research diagrams with Excalidraw MCP tools

    1.1k GitHub stars~884 tokensUpdated 2 days ago
    Auto-check passed
  • Research Methodology

    vstorm-co/pydantic-deepagents

    Best practices for systematic research, source evaluation, and evidence gathering

    1.1k GitHub stars~577 tokensUpdated 2 days ago
    Auto-check passed
  • Systematic Debugging

    vstorm-co/pydantic-deepagents

    Systematic approach to diagnosing and fixing errors. An agent skill from vstorm-co/pydantic-deepagents.

    1.1k GitHub stars~732 tokensUpdated 2 days ago
    Auto-check passed
  • Verification Strategy

    vstorm-co/pydantic-deepagents

    Thorough verification of completed work before declaring done

    1.1k GitHub stars~736 tokensUpdated 2 days ago
    Auto-check passed
  • Environment Discovery

    vstorm-co/pydantic-deepagents

    Systematic exploration of unknown environments before starting work

    1.1k GitHub stars~419 tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Git Workflow

What does Git Workflow do?

Git operations: commits, branches, PRs, and conflict resolution. Git Workflow is an agent skill from vstorm-co/pydantic-deepagents.

When should I use Git Workflow?

Git Workflow fits situations like: tasks that involve Git workflow.

How do I install Git Workflow in Claude Code?

Run `npx skills add vstorm-co/pydantic-deepagents --skill git-workflow -a claude-code`. Or copy the skill folder (apps/cli/skills/git-workflow in vstorm-co/pydantic-deepagents) into .claude/skills/git-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Git Workflow in Codex?

Run `npx skills add vstorm-co/pydantic-deepagents --skill git-workflow -a codex`. Or copy the skill folder (apps/cli/skills/git-workflow in vstorm-co/pydantic-deepagents) into .agents/skills/git-workflow in your project. Codex loads it when a task matches its description.

Can I use Git Workflow 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 vstorm-co/pydantic-deepagents --skill git-workflow -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-workflow, .gemini/skills/git-workflow, .github/skills/git-workflow and .opencode/skills/git-workflow in your project.

What does Git Workflow need to run?

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

Does Git Workflow 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 Workflow safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Git Workflow use?

Git Workflow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Git Workflow use?

About 269 tokens (SKILL.md is roughly 1.1k 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 Workflow?

Skills that share tags, products or a category with Git Workflow: Finishing a Development Branch (obra/superpowers, 296k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Migrate Internal Package into Ghost (TryGhost/Ghost, 55k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Git Workflow?

vstorm-co (a GitHub organization) maintains it in vstorm-co/pydantic-deepagents, which has 1,077 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 6, 2026.

Source: vstorm-co/pydantic-deepagents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.