Agent skill

Dev Commit

by codeaholicguy in codeaholicguy/ai-devkit

AI DevKit · Safe git commit workflow for AI coding agents. An agent skill from codeaholicguy/ai-devkit.

Apache-2.0Auto-check: notesDevelopment

Install Dev Commit

skills CLI
$ npx skills add codeaholicguy/ai-devkit --skill dev-commit -a claude-code

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

GitHub CLI
$ gh skill install codeaholicguy/ai-devkit dev-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/codeaholicguy/ai-devkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dev-commit .claude/skills/dev-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
dev-commit
GitHub stars
1.6k
Token cost
~799 tokens
SKILL.md length
412 words
Files
2
Skills in repo
28
Repo updated
First seen
Licence
Apache-2.0

At a glance

AI DevKit · Safe git commit workflow for AI coding agents. An agent skill from codeaholicguy/ai-devkit.

  • Works in 7 steps: Check repository state with git status… → Identify the files that belong to the… → Run appropriate validation before… → …
  • The user asks to commit
  • SKILL.md covers Commit Contract, Guardrails and Message Style
  • Calls git and npm

What it does

Dev Commit is an agent skill from codeaholicguy/ai-devkit. AI DevKit · Safe git commit workflow for AI coding agents. Use when the user asks to commit, prepare a commit, stage changes, create a PR-ready checkpoint, or finish work with a conventional commit while avoiding unrelated user changes.

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development, covering Commit messages. It works with Git. The repository describes itself as: The control plane for AI coding agents. The licence is Apache-2.0.

When your agent uses it

  • The user asks to commit
  • Prepare a commit
  • Create a PR-ready checkpoint
  • Finish work with a conventional commit while avoiding unrelated user changes

Example prompts

  • “/dev-commit”

Workflow steps

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

  1. Check repository state with git status --short --branch, git diff --stat, and git diff.
  2. Identify the files that belong to the requested change. Treat pre-existing user edits, local config, generated artifacts, dependency…
  3. Run appropriate validation before committing. Prefer the repo's targeted tests, lint, typecheck, build, or documented verification…
  4. Stage only intended paths. Prefer explicit pathspecs such as git add path/to/file over git add ..
  5. Re-check with git diff --cached --stat, git diff --cached, and git status --short.
  6. Write a concise conventional commit message: (optional-scope): .
  7. Commit, then report the commit SHA, final status, validation commands, and any unstaged/untracked files left behind.

What it can do on your machine

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

    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 npm, 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

Dev Commit loads about 799 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 412 words of instructions outside code blocks.

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

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:22
    - Do not commit secrets, credentials, `.env` files, local machine config, caches, coverage, logs, screenshots, or genera

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 codeaholicguy/ai-devkit at commit 7ef0cd5, republished under its Apache-2.0 licence (© codeaholicguy). 412 words, ~799 tokens.

Download SKILL.mdSave it as .claude/skills/dev-commit/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
dev-commit
description
AI DevKit · Safe git commit workflow for AI coding agents. Use when the user asks to commit, prepare a commit, stage changes, create a PR-ready checkpoint, or finish work with a conventional commit while avoiding unrelated user changes.

Dev Commit

Make one intentional, verified commit without sweeping in unrelated work.

Commit Contract

  1. Check repository state with git status --short --branch, git diff --stat, and git diff.
  2. Identify the files that belong to the requested change. Treat pre-existing user edits, local config, generated artifacts, dependency caches, build outputs, and unrelated formatting churn as out of scope unless the user explicitly includes them.
  3. Run appropriate validation before committing. Prefer the repo's targeted tests, lint, typecheck, build, or documented verification commands. Record skipped validation with the reason. In workspaces whose packages resolve against built artifacts, ensure install and build have run in that worktree (npm ci, npm run build) before full validation or commit hooks; a fresh worktree with stale artifacts fails hooks for environmental reasons.
  4. Stage only intended paths. Prefer explicit pathspecs such as git add path/to/file over git add ..
  5. Re-check with git diff --cached --stat, git diff --cached, and git status --short.
  6. Write a concise conventional commit message: <type>(optional-scope): <summary>.
  7. Commit, then report the commit SHA, final status, validation commands, and any unstaged/untracked files left behind.

Guardrails

  • Do not commit secrets, credentials, .env files, local machine config, caches, coverage, logs, screenshots, or generated files unless the change explicitly requires them.
  • Do not stage another person's unrelated edits. If intended and unrelated changes are mixed in one file, use an interactive or patch-based staging flow and review the staged diff carefully.
  • Do not amend, rebase, force-push, reset, or delete branches unless the user explicitly asks for that operation.
  • If validation fails, stop before committing unless the user explicitly instructs you to commit with failing validation. Report the failing command and key output.
  • If the repo has commit hooks, let them run. If a hook changes files, inspect and stage only intended hook outputs before retrying. If a hook fails, first rule out environmental causes (missing install, stale workspace build artifacts, concurrent test runs sharing resources) by re-running the failing package in isolation; do not treat an environmental failure as a code regression or "stop" condition until isolated runs still fail.
Show full SKILL.md (65 more words)Show less

Message Style

Use semantic or conventional commit types that match the change:

  • feat: user-facing feature or capability
  • fix: bug fix
  • docs: documentation-only change
  • test: test-only change
  • refactor: behavior-preserving code restructuring
  • chore: maintenance, build, tooling, metadata, or generated index updates

Keep the subject under about 72 characters when practical, imperative, and specific. Add a body only when it explains non-obvious validation, risk, migration, or follow-up context.

© codeaholicguy, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/dev-commit of codeaholicguy/ai-devkit.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 7ef0cd5

Compare with similar skills

Dev 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.

Dev Commit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dev Commit this skillcodeaholicguy/ai-devkit1.6k—~799Automated safety check: NotesApache-2.0
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 codeaholicguy/ai-devkit

All 28 skills in this repo
  • Agent Management

    codeaholicguy/ai-devkit

    AI DevKit · Manage running AI agents with ai-devkit agent commands.

    1.6k GitHub stars~558 tokensUpdated yesterday
    Auto-check passed
  • Dev Lifecycle

    codeaholicguy/ai-devkit

    AI DevKit · Orchestrator for structured SDLC phase skills. An agent skill from codeaholicguy/ai-devkit.

    1.6k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Task

    codeaholicguy/ai-devkit

    AI DevKit · Track dev-lifecycle / structured-debug progress on a durable task with the ai-devkit task CLI.

    1.6k GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Simplify Implementation

    codeaholicguy/ai-devkit

    AI DevKit · Analyze and simplify existing implementations to reduce complexity, improve maintainability, and enhance scalability.

    1.6k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Agent Communication

    codeaholicguy/ai-devkit

    AI DevKit · Exchange information with active Codex, Claude Code, and other AI agents using ai-devkit agent list, detail, and send.

    1.6k GitHub stars~321 tokensUpdated yesterday
    Auto-check passed
  • Technical Writer

    codeaholicguy/ai-devkit

    AI DevKit · Review and improve documentation for novice users.

    1.6k GitHub stars~431 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Dev Commit

What does Dev Commit do?

AI DevKit · Safe git commit workflow for AI coding agents. An agent skill from codeaholicguy/ai-devkit. Dev Commit is an agent skill from codeaholicguy/ai-devkit. AI DevKit · Safe git commit workflow for AI coding agents.

When should I use Dev Commit?

Dev Commit fits situations like: the user asks to commit; prepare a commit; create a PR-ready checkpoint; finish work with a conventional commit while avoiding unrelated user changes.

How do I install Dev Commit in Claude Code?

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

How do I install Dev Commit in Codex?

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

Can I use Dev 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 codeaholicguy/ai-devkit --skill dev-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/dev-commit, .gemini/skills/dev-commit, .github/skills/dev-commit and .opencode/skills/dev-commit in your project.

What does Dev Commit need to run?

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

Does Dev Commit access the network?

SKILL.md contains no URLs. Its commands use git and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Dev Commit 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 Dev Commit use?

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

About 799 tokens (SKILL.md is roughly 3.2k 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 Dev Commit?

Skills that share tags, products or a category with Dev 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 Dev Commit?

codeaholicguy (a GitHub user) maintains it in codeaholicguy/ai-devkit, which has 1,641 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 6, 2026.

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