Skip to main content
skill CX Codex

w-commit — Claude Code skill: what it does, how to install

The w-commit Claude Code skill reviews task changes and creates a repository-style commit. It runs when a commit is requested.

MIT 647 installs ★ 1 updated 2026-10-02

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add blockmatic-icebox/basilic-skills --skill w-commit -a claude-code
Open on GitHub

What w-commit does

w-commit compares staged and unstaged work with the task scope, then prepares a commit. It separates task changes from unrelated edits, including files already staged. If those changes cannot be safely split, the skill asks for the file scope to be clarified.

When behavior, commands, or conventions change, matching MDX files and the nearest README must be part of the diff, or the commit needs a short explanation. The skill stages selected paths or hunks only; it excludes secrets and .env. It writes a Conventional Commit message and leaves hooks enabled. It does not run the full pre-push suite.

After committing, it checks the result and the remaining working tree, then returns the commit ID and scope. A request to commit does not authorize pushing to a remote.

What it helps with

  • separate task changes from unrelated work
  • create commits that follow repository conventions
  • keep secrets and unrelated files out of a commit
  • report the commit ID and scope

Example prompts for the agent

  • Review this task's changes and create a commit.
  • Commit only the files that belong to this task.
  • Write a Conventional Commit message and show the remaining changes.

How to install w-commit

1Skills CLI (Vercel)

npx skills add blockmatic-icebox/basilic-skills --skill w-commit -a claude-code

2Manually: put the files in place

~/.claude/skills/w-commit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/w-commit/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about w-commit

How do I install w-commit in Claude Code?

Run npx skills add blockmatic-icebox/basilic-skills --skill w-commit -a claude-code. The skill file is at ~/.claude/skills/w-commit/SKILL.md.

What does w-commit do?

It checks changes against the task scope, stages the relevant paths or hunks, and creates a commit that follows repository conventions. It then reports the commit ID and remaining work.

Does w-commit push changes to a remote?

No. A commit request alone does not authorize pushing.

Source text

SKILL.md · MIT
---
name: w-commit
description: Review and commit the task's intended changes using repository conventions.
disable-model-invocation: true
---

Invocation requests a commit. Inspect staged and unstaged changes and the authorized task scope before staging anything. Follow [git publish](references/git-publish.md).

1. If creating a new branch, `git fetch origin` then `git switch -c <name> --no-track origin/main` first — never skip fetch, never a stale local `main`. Inspect the diff and distinguish task-owned changes from unrelated work, including pre-staged files. If the intended commit cannot be separated safely, clarify the file scope.
2. Before staging: if behavior, commands, or conventions changed, matching MDX and nearest README must be in the diff; otherwise one line why not. Rely on commit hooks. Never the full pre-push suite.
3. Stage explicit task-owned paths or hunks. Do not sweep unrelated or untracked work into the commit with a blanket add. Never `git add -A`. Never stage `.env`, credentials, or secrets.
4. Write a Conventional Commit: lowercase type/scope, imperative summary of at most 60 characters, no period. Follow repository-specific scope conventions. Pass the message via a heredoc; commit with hooks enabled.
5. Inspect the result and remaining working tree. Return commit ID and scope. A commit request alone does not authorize pushing.

© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills

Similar skills

All skills for Git and GitHub →

From the same set45

The whole set →
w-git-repair The w-git-repair Claude Code skill diagnoses local Git problems and conflicts. It checks repository state before suggesting repair commands. CX Codex +1 647installs w-comments The w-comments Claude Code skill handles reviewer comments on pull requests and applies requested fixes. It drafts a reply for each comment and only commits after /w-commit is invoked. CX Codex +1 647installs w-pr The w-pr Claude Code skill creates or updates a pull request for the intended branch. It publishes the branch, writes the PR description, and checks the result. CX Codex +1 647installs w-push w-push — a skill for Claude Code checks changes before pushing the intended branch. It runs when asked to publish the current task. CX Codex +1 647installs w-retro The w-retro Claude Code skill reviews completed work and suggests changes for the next similar task. It runs after a task is finished. CX Codex +1 647installs w-build w-build — a skill for Claude Code that implements an agreed task in small slices and checks the result. It starts from an existing plan or a clear implementation request. CX Codex +1 647installs w-council The w-council Claude Code skill explores a codebase with parallel agents. It gathers architectural findings and hands them off for follow-up work. CX Codex +1 647installs w-plan The w-plan Claude Code skill turns a project change into an ordered work plan. It inspects relevant context and task dependencies without modifying implementation. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open