Agent skill

Piv Commit

by coleam00 in coleam00/skills

Creates a new git commit for all uncommitted changes with an atomic, conventionally-tagged message.

MITAuto-check passedDevelopment

Install Piv Commit

skills CLI
$ npx skills add coleam00/skills --skill piv-commit -a claude-code

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

GitHub CLI
$ gh skill install coleam00/skills piv-commit --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/coleam00/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/piv-commit .claude/skills/piv-commit && 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
piv-commit
GitHub stars
670
Token cost
~412 tokens
SKILL.md length
208 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Creates a new git commit for all uncommitted changes with an atomic, conventionally-tagged message.

  • Works in 5 steps: Read this project's conventions. If… → Run git status && git diff HEAD && git… → Add the untracked and changed files. → …
  • Work is complete and ready to be committed
  • SKILL.md covers Process and Output
  • Calls git

What it does

Piv Commit is an agent skill from coleam00/skills. Creates a new git commit for all uncommitted changes with an atomic, conventionally-tagged message. Use when work is complete and ready to be committed.

Its SKILL.md is about 410 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 Commit messages. It works with Git. The repository describes itself as: The agent skills I actually use to build software with coding agents. The PIV loop, planning, worktrees, and the meta-skills for building your own AI Layer. The licence is MIT.

When your agent uses it

  • Work is complete and ready to be committed
  • Tasks that involve Commit messages

Example prompts

  • “Use the piv-commit skill to create a new git commit for all uncommitted changes with an atomic, conventionally-tagged message”
  • “/piv-commit”

Workflow steps

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

  1. Read this project's conventions. If .claude/references/conventions.md exists, read its ## commit
  2. Run git status && git diff HEAD && git status --porcelain to see what files are uncommitted.
  3. Add the untracked and changed files.
  4. Write an atomic commit message with an appropriate, descriptive summary.
  5. Add a tag such as feat, fix, docs, refactor, test, chore, etc. that reflects our work.

What it can do on your machine

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

Piv Commit loads about 412 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 208 words of instructions outside code blocks.

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

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 coleam00/skills at commit dfaa910, republished under its MIT licence (© coleam00). 208 words, ~412 tokens.

Download SKILL.mdSave it as .claude/skills/piv-commit/SKILL.md (or your agent's skills folder).
name
piv-commit
description
Creates a new git commit for all uncommitted changes with an atomic, conventionally-tagged message. Use when work is complete and ready to be committed.

Commit: Create a New Commit

Create a new commit for all of our uncommitted changes.

Process

  1. Read this project's conventions. If .claude/references/conventions.md exists, read its ## commit section and follow it — those rules win over the defaults below. That file is where a project's specifics live; this skill stays general.
  2. Run git status && git diff HEAD && git status --porcelain to see what files are uncommitted.
  3. Add the untracked and changed files.
  4. Write an atomic commit message with an appropriate, descriptive summary.
  5. Add a tag such as feat, fix, docs, refactor, test, chore, etc. that reflects our work.

Output

A single commit containing all uncommitted changes, with a conventional-commit-style message (<tag>: <atomic description>) that accurately reflects the work done.

After the commit succeeds, print two clearly labelled summaries:

What Changed

One short paragraph (3–6 sentences) describing the feature/fix/refactor that was committed — what problem it solves and what files were the key touch points. Write for a developer skimming the git log.

AI Layer Changes

Only include this section if any files under .claude/ were modified or added (CLAUDE.md, .claude/references/, .claude/skills/, .claude/agents/, etc.).

List each changed AI-layer file with a one-line note on what evolved and why. If nothing in .claude/ changed, omit this section entirely.

© coleam00, 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 .claude/skills/piv-commit of coleam00/skills.

Open the folder on GitHubat commit dfaa910

Compare with similar skills

Piv Commit 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.

Piv Commit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Piv Commit this skillcoleam00/skills670—~412Automated safety check: PassMIT
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
ToolJet Multi-Repo CommitToolJet/ToolJet41k—~1.3kAutomated safety check: PassAGPL-3.0
Git Workflow and Versioningaddyosmani/agent-skills102k2 repos~3.5kAutomated safety check: NotesMIT
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT

Similar skills

  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Commits changes across ToolJet's root repo and its server/ee and frontend/ee submodules, writing messages from the diffs and updating submodule pointers in order.

    41k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • 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 yesterday
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Commits changes in the Saleor codebase and works through pre-commit hook failures from ruff, mypy, the GraphQL schema check and the migrations check.

    23k GitHub stars~575 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from coleam00/skills

All 33 skills in this repo
  • Ablate AI Layer

    coleam00/skills

    Measure whether a repository's AI instructions still earn their place, by running the same real task many times with the layer intact and with it stripped, then grading every rule against what…

    670 GitHub stars~1.9k tokensUpdated 20 days ago
    Auto-check passed
  • Build Dark Factory

    coleam00/skills

    Take a PRD and build a dark factory around it - a repository that takes work in as an issue and ships validated code out with nobody at the keyboard - one component at a time, into the user's actual…

    670 GitHub stars~12k tokensUpdated 20 days ago
    Auto-check passed
  • Drive Screen

    coleam00/skills

    Take real control of the desktop - list and focus windows, type, paste, click, scroll, and screenshot - on Windows, macOS or Linux, and drive other coding-agent sessions running in terminals.

    670 GitHub stars~5.4k tokensUpdated 20 days ago
    Auto-check passed
  • Second Brain Audit

    coleam00/skills

    Audit any second brain, notes folder, or agent memory for facts that have quietly stopped being true, then fix the worst one so it stops recurring.

    670 GitHub stars~4.6k tokensUpdated 20 days ago
    Auto-check passed
  • Worktree Create

    coleam00/skills

    Create one or more git worktrees for parallel development, each on its own branch with gitignored config copied in, dependencies installed, and a health check, by fanning out a setup subagent per…

    670 GitHub stars~958 tokensUpdated 20 days ago
    Auto-check passed
  • Hooks Create

    coleam00/skills

    Author a working Claude Code hook from a plain-English description of what it should guarantee or do.

    670 GitHub stars~3.6k tokensUpdated 20 days ago
    Auto-check: notes

Works with

Categories

Questions about Piv Commit

What does Piv Commit do?

Creates a new git commit for all uncommitted changes with an atomic, conventionally-tagged message. Piv Commit is an agent skill from coleam00/skills. Creates a new git commit for all uncommitted changes with an atomic, conventionally-tagged message.

When should I use Piv Commit?

Piv Commit fits situations like: work is complete and ready to be committed; tasks that involve Commit messages.

How do I install Piv Commit in Claude Code?

Run `npx skills add coleam00/skills --skill piv-commit -a claude-code`. Or copy the skill folder (.claude/skills/piv-commit in coleam00/skills) into .claude/skills/piv-commit in your project. Claude Code loads it when a task matches its description.

How do I install Piv Commit in Codex?

Run `npx skills add coleam00/skills --skill piv-commit -a codex`. Or copy the skill folder (.claude/skills/piv-commit in coleam00/skills) into .agents/skills/piv-commit in your project. Codex loads it when a task matches its description.

Can I use Piv Commit 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 coleam00/skills --skill piv-commit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/piv-commit, .gemini/skills/piv-commit, .github/skills/piv-commit and .opencode/skills/piv-commit in your project.

What does Piv Commit need to run?

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

Does Piv Commit 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 Piv Commit 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 Piv Commit use?

Piv Commit 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 Piv Commit use?

About 412 tokens (SKILL.md is roughly 1.6k 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 Piv Commit?

Skills that share tags, products or a category with Piv Commit: React Router Release Notes Prep (remix-run/react-router, 57k stars), ToolJet Multi-Repo Commit (ToolJet/ToolJet, 41k stars), Git Workflow and Versioning (addyosmani/agent-skills, 102k stars) and React Router Pull Request Creator (remix-run/react-router, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Piv Commit?

coleam00 (a GitHub user) maintains it in coleam00/skills, which has 670 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on September 17, 2026.

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