Agent skill

Git Workflow

Softmaple Git branching, commits, pre-commit hooks, and pull requests.

Apache-2.0Auto-check passedDevelopment

Install Git Workflow

skills CLI

$ npx skills add softmaple/softmaple --skill git-workflow -a claude-code

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

GitHub CLI

$ gh skill install softmaple/softmaple 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/softmaple/softmaple.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/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/

Paste into Claude Code

Install the "git-workflow" agent skill from https://github.com/softmaple/softmaple/tree/next/.agents/skills/git-workflow into .claude/skills/git-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "git-workflow", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/softmaple/softmaple/tree/next/.agents/skills/git-workflow

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add softmaple/softmaple --skill git-workflow -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install softmaple/softmaple git-workflow --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softmaple/softmaple.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/git-workflow .agents/skills/git-workflow && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "git-workflow" agent skill from https://github.com/softmaple/softmaple/tree/next/.agents/skills/git-workflow into .agents/skills/git-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "git-workflow", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add softmaple/softmaple --skill git-workflow -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install softmaple/softmaple git-workflow --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softmaple/softmaple.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/git-workflow .cursor/skills/git-workflow && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "git-workflow" agent skill from https://github.com/softmaple/softmaple/tree/next/.agents/skills/git-workflow into .cursor/skills/git-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "git-workflow", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/softmaple/softmaple.git --path .agents/skills/git-workflow

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add softmaple/softmaple --skill git-workflow -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install softmaple/softmaple git-workflow --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softmaple/softmaple.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/git-workflow .gemini/skills/git-workflow && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "git-workflow" agent skill from https://github.com/softmaple/softmaple/tree/next/.agents/skills/git-workflow into .gemini/skills/git-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "git-workflow", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install softmaple/softmaple git-workflow

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add softmaple/softmaple --skill git-workflow -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/softmaple/softmaple.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/git-workflow .github/skills/git-workflow && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "git-workflow" agent skill from https://github.com/softmaple/softmaple/tree/next/.agents/skills/git-workflow into .github/skills/git-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "git-workflow", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add softmaple/softmaple --skill git-workflow -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install softmaple/softmaple git-workflow --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softmaple/softmaple.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/git-workflow .opencode/skills/git-workflow && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "git-workflow" agent skill from https://github.com/softmaple/softmaple/tree/next/.agents/skills/git-workflow into .opencode/skills/git-workflow/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "git-workflow", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: git-workflow
GitHub stars: 159
Token cost: ~814 tokens
SKILL.md length: 253 words
Files: 2
Skills in repo: 3
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Softmaple Git branching, commits, pre-commit hooks, and pull requests.

Works in 3 steps: Never commit directly to next. Create a… → Never use --no-verify. Fix hook… → Always request user approval before…
Creating branches
SKILL.md covers Critical rules, When to use which path, Branch workflow and Commit workflow, plus 3 more sections
Calls git and pnpm

What it does

Git Workflow is an agent skill from softmaple/softmaple. Softmaple Git branching, commits, pre-commit hooks, and pull requests. Use when creating branches, committing, pushing, opening or updating PRs, fixing pre-commit hook failures, returning to the next branch, or when the user mentions git workflow, --no-verify, branch naming, or commit messages.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `evals.json`).

It sits in Development, covering Git workflow, Pull requests and Commit messages. It works with Git, React, Next.js and LaTeX. The repository describes itself as: A Paper Typesetting Editor. The licence is Apache-2.0.

When your agent uses it

Creating branches
Fixing pre-commit hook failures
Returning to the next branch
The user mentions git workflow

Example prompts

“/git-workflow”

Workflow steps

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

Never commit directly to next. Create a feature branch first.
Never use --no-verify. Fix hook failures; do not bypass them.
Always request user approval before commits/pushes.

What it can do on your machine

Read from SKILL.md and the folder at commit 9963f9d. 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
- pnpm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git and pnpm, 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 814 tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 253 words of instructions outside code blocks.

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

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 softmaple/softmaple at commit 9963f9d, republished under its Apache-2.0 licence (© softmaple). 253 words, ~814 tokens.

Download SKILL.mdSave it as .claude/skills/git-workflow/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: git-workflow
description: Softmaple Git branching, commits, pre-commit hooks, and pull requests. Use when creating branches, committing, pushing, opening or updating PRs, fixing pre-commit hook failures, returning to the next branch, or when the user mentions git workflow, --no-verify, branch naming, or commit messages.
license: Complete terms in LICENSE.txt

Git Workflow

Softmaple Git conventions. Default branch is next. Follow the critical rules exactly (low freedom).

Critical rules

Never commit directly to next. Create a feature branch first.
Never use --no-verify. Fix hook failures; do not bypass them.
Always request user approval before commits/pushes.

When to use which path

text

Git task?
├─ Starting work on next? → Branch workflow
├─ Committing changes? → Commit workflow
├─ Pre-commit hooks failed? → Hook failure loop
├─ Opening/updating a PR? → Pull requests
└─ Switching back to next? → Return to next

Branch workflow

Copy and track:

text

Branch Progress:
- [ ] Check current branch
- [ ] Create feature branch if on next or detached HEAD
- [ ] Make changes on the feature branch only

git branch --show-current
If the result is empty (detached HEAD) or next: create a feature branch with git checkout -b type/description-$(date +%s) before any edits. Do not edit while detached or on next.
Work only on that feature branch

Branch name format: type/description-$(date +%s)

Examples:

bash

feature/add-user-auth-1737154800
fix/duplicate-event-handling-1737154800
refactor/cleanup-event-graph-1737154800
docs/update-readme-1737154800

Types: feature, fix, refactor, docs, chore, test, ci, build, perf, style

Commit workflow

Copy and track:

text

Commit Progress:
- [ ] Confirm not on next
- [ ] pnpm --filter <package> typecheck (as needed)
- [ ] pnpm --filter <package> test (as needed)
- [ ] pnpm lint / pnpm format (as needed)
- [ ] Request user approval to commit/push
- [ ] Stage and commit (no --no-verify)
- [ ] If hooks fail → Hook failure loop
- [ ] Push after approval

Commit message format

type(scope): summary

Types: fix, feat, build, chore, ci, docs, style, refactor, perf, test
Scopes: apps/web, packages/<name>, or omit for root

Examples:

text

feat(packages/eg-walker): add incremental CRDT integration
fix(apps/web): resolve duplicate event crash
docs: update functional programming guidelines

Pre-commit hooks

Hooks run Biome formatting, ESLint, and type checking. They must pass. Never bypass with --no-verify.

Hook failure loop

Read the hook error output
Fix the issues (start with pnpm format, then address lint/type errors)
Stage the fixes
Retry the commit without --no-verify
Repeat until hooks pass

Return to next

When leaving a feature branch for next:

bash

git checkout next
git pull
pnpm i

Keeps the branch and dependencies in sync with remote.

Pull requests

Include:

Summary of the change
Test commands run (or note if none)
Screenshots for UI changes

Push the feature branch and open a PR into next. Do not merge your own work unless asked.

Files

SKILL.md and 1 other file in .agents/skills/git-workflow of softmaple/softmaple.

SKILL.md
evals.json

Open the folder on GitHubat commit 9963f9d

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
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Git Workflow this skillsoftmaple/softmaple	159	—	~814	Automated safety check: Pass	Apache-2.0	today
Git Workflow and Versioningaddyosmani/agent-skills	102k	2 repos	~3.5k	Automated safety check: Notes	MIT	4 days ago
React Router Pull Request Creatorremix-run/react-router	57k	—	~2.5k	Automated safety check: Pass	MIT	today
Emoji Commit ConventionsbaptisteArno/typebot.io	11k	—	~424	Automated safety check: Pass	Custom licence	yesterday
Draft Pull Request Creatorwordpress-mobile/WordPress-Android	3.2k	—	~881	Automated safety check: Notes	GPL-2.0	today
Adk Gitgoogle/adk-python	22k	—	~1.3k	Automated safety check: Pass	Apache-2.0	today

Similar skills

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.
102k 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 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 yesterday
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
Adk Git
google/adk-python
Official
Writes commit messages and pull request descriptions for the adk-python repository: Conventional Commits types and scopes, subject lines that say why a change was made, and the linked-issue and…
22k GitHub stars~1.3k tokensUpdated today
DevelopmentAuto-check passed
Git PR Flow
wgzhao/Addax
Standard branch, commit, and pull-request workflow for this repo.
1.4k GitHub stars~216 tokensUpdated today
DevelopmentAuto-check passed

Questions about Git Workflow

What does Git Workflow do?

Softmaple Git branching, commits, pre-commit hooks, and pull requests. Git Workflow is an agent skill from softmaple/softmaple. Softmaple Git branching, commits, pre-commit hooks, and pull requests.

When should I use Git Workflow?

Git Workflow fits situations like: creating branches; fixing pre-commit hook failures; returning to the next branch; the user mentions git workflow.

How do I install Git Workflow in Claude Code?

Run `npx skills add softmaple/softmaple --skill git-workflow -a claude-code`. Or copy the skill folder (.agents/skills/git-workflow in softmaple/softmaple) 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 softmaple/softmaple --skill git-workflow -a codex`. Or copy the skill folder (.agents/skills/git-workflow in softmaple/softmaple) 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 softmaple/softmaple --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 and pnpm).

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 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 Workflow use?

Git Workflow is published under the Apache-2.0 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 814 tokens (SKILL.md is roughly 3.3k 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: Git Workflow and Versioning (addyosmani/agent-skills, 102k stars), React Router Pull Request Creator (remix-run/react-router, 57k stars), Emoji Commit Conventions (baptisteArno/typebot.io, 11k stars) and Draft Pull Request Creator (wordpress-mobile/WordPress-Android, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Git Workflow?

softmaple (a GitHub organization) maintains it in softmaple/softmaple, which has 159 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

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

Git Workflow

Install Git Workflow

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Git Workflow

Critical rules

When to use which path

Branch workflow

Commit workflow

Commit message format

Pre-commit hooks

Hook failure loop

Return to next

Pull requests

Files

Compare with similar skills

Similar skills

Git Workflow and Versioning

React Router Pull Request Creator

Emoji Commit Conventions

Draft Pull Request Creator

Adk Git

Git PR Flow

More from softmaple/softmaple

Javascript Testing Expert

Motion

Questions about Git Workflow

Install Git Workflow

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Git Workflow

Critical rules

When to use which path

Branch workflow

Commit workflow

Commit message format

Pre-commit hooks

Hook failure loop

Return to next

Pull requests

Files

Compare with similar skills

Similar skills

More from softmaple/softmaple

Related

Questions about Git Workflow