commit
Skill1 starsChanged 34 days agoMITView on GitHub
Splits working-tree changes into logical, self-consistent commits (ordering so nothing dangles, stepping files that straddle commits through intermediate states), writes conventional-commit messages (feat/fix/docs/refactor/chore) with motivation in the body, stages explicit paths only, uses git mv for renames, never pushes/amends/skips hooks unless explicitly asked, and ends by reporting the resulting hashes against a clean tree. Includes pre-commit checks for Fabric Git-synced repos (core.autocrlf, .gitattributes, whitespace-only portal diffs). In a working tree another session is editing at the same time, gates the commit on the branch and on the index exactly as read, so nothing of theirs is swept in and nothing lands on a branch a peer switched to.
187 other projects use a version of this.
Adopted by
Most recently taken up by
- yagizdo/quivertheir own version, first seen Nov 15, 2026
- markmhendrickson/neotomatheir own version, first seen Nov 15, 2026
- ShipfoxHQ/shipfoxtheir own version, first seen Nov 15, 2026
- atomicinnovation/acceleratortheir own version, first seen Nov 14, 2026
- Integralist/agent-skillstheir own version, first seen Nov 14, 2026
- gtapps/claude-code-hermittheir own version, first seen Nov 13, 2026
Used with
Projects with it also use validate-plan, act-on-feedback and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
shawn-dumasSkillvalidate-plan
Validate an orchestration plan after pre-flight certification. Runs adversarial review, deep review (verify prompt data against codebase), and PoC gate for risky approaches. Auto-invoked by orchestrate-* skills at Step 8.
Also in 5 projects that use this
MicrosoftSkillact-on-feedback
Act on user feedback attached to the current session. Use when the user submits feedback on the session's changes via the Submit Feedback button.
Also in 3 projects that use this
decocmsSkilladd-mcp-tools
Guide for adding new MCP tools with consistent patterns for schemas, tool definitions, registry updates, and Better Auth integration
Also in 3 projects that use this
MicrosoftSkillgenerate-run-commands
Generate or modify run commands for the current session. Use when the user wants to set up or update run commands that appear in the session's Run button.
Also in 3 projects that use this
mitsuhikoSkilloebb-scotty
Austrian rail travel planner (ÖBB Scotty). Use when planning train journeys in Austria, checking departures/arrivals at stations, or looking for service disruptions. Covers ÖBB trains, S-Bahn, regional trains, and connections to neighboring countries.
Also in 3 projects that use this
mitsuhikoSkillpi-share
Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com/pi.dev (pi-share) URLs. Fetches gists, decodes embedded session data, and extracts conversation history.
Also in 3 projects that use this
Other versions187 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 187
- microsoft/vscode★ 195ksame name
- TryGhost/Ghost★ 56ksame name
- ToolJet/ToolJet★ 41ksame name
- ShareX/ShareX★ 41ksame name
- openai/symphony★ 27ksame name
- ryoppippi/ccusage★ 19ksame name
- ccusage/ccusage★ 19ksame name
- windmill-labs/windmill★ 19ksame name
- EverMind-AI/EverMemOS★ 14ksame name
- EverMind-AI/EverOS★ 14ksame name
177 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository38 other files it gives its agents.
- claude/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- author-skillSkill
- drift-auditSkill
- drift-handoffSkill
- drift-updateSkill
- test-skillSkill
- triageSkill
- fabric-iqSkill
- fabric-catalog-governanceSkill
- fabric-deploySkill
- fabric-rest-apiSkill
- fabric-securitySkill
- fabric-variable-librarySkill
- fabric-databaseSkill
- fabric-dataflowSkill
- fabric-data-pipelineSkill
- fabric-sparkSkill
- fabric-warehouse-monitoringSkill
- fabric-warehouseSkill
- fabric-activatorSkill
- fabric-eventhouseSkill
- fabric-event-schema-setSkill
- fabric-eventstreamSkill
- fabric-realtime-dashboardSkill
- learnSkill
- fabric-semantic-model-auditSkill
- fabric-tmdlSkill
- pbip-project-structureSkill
- pbir-report-workflowSkill
- linkedin-highlightsSkill
- msix-packagingSkill
- code-reviewSkill
- find-sessionSkill
- landSkill
- prune-branchesSkill
- recreate-repoSkill
- run-briefsSkill
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 9 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 167 edited versions we read keep these.
9
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
Read the diffs (git diff, git diff --stat, plus untracked files) well enough to explain *why* each change exists, not just what it touches.
- Distinctive: line 50
Test: could each commit's subject line be written without "and"?
- Distinctive: line 58
Every commit must be self-consistent: No commit may reference a name, file, or skill that doesn't exist yet at that point in history, and …
- Distinctive: line 80
Stepping assumes you own the whole file: If another session has uncommitted work in it, stepping rewrites their in-flight text — commit …
- Distinctive: line 123
Never push, amend, force, rebase, or tag unless the user asked for that in this conversation.
- Very specific: line 125
Never --no-verify / skip hooks.
- Distinctive: line 126
If a change looks accidental or unrelated to the stated work, leave it uncommitted and flag it rather than sweeping it in.
- Distinctive: line 175
Only the user's word in this conversation holds a finished unit back.
- Distinctive: line 176
Run the whole procedure, but on main where step 4 would branch, ask instead, since git switch -c moves the peer's HEAD too.
- Distinctive: line 293
Record what you left: Commit only what is yours, and name the deferred piece in the commit message so git log carries it rather than this …
- Very specific: line 302
Before the first commit in a repo containing *.{ItemType} folders: check git config core.autocrlf and whether .gitattributes pins the item …
“Common” is measured: kept by at least 6 in 10 of the 167 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Commit workflow
Turn the current working-tree changes into one or more well-formed commits. Committing only — pushing, amending, rebasing, and tagging happen only when explicitly requested, never as follow-through.
Survey first
git status --short— full picture of modified, renamed, untracked. Note anything already staged that you did not stage.git log --oneline -10— calibrate message style against this repo's actual history, not assumptions.- Read the diffs (
git diff,git diff --stat, plus untracked files) well enough to explain why each change exists, not just what it touches. Never commit content you haven't looked at. - On
main? Branch when the work is more than one commit, or an intermediate state would break while deployed — the trigger and the name are~/.claude/CLAUDE.md§ "Branch naming"'s — and from the first commit when it is bound forland, which refuses to start frommain. Work in a repo that lands by pull request is bound forland: a pull-request rule onmain(landstep 7 has the two reads), or(#<n>)andMerge pull requestsubjects in the log above; a fast-forward landing leaves none. A repo's own committed convention wins, in itsCONTRIBUTING.mdor agent instructions: one that commits straight tomainanswers no, and then you commit where you stand. Say which way you went. In a shared treegit switch -cmoves HEAD for everyone — see below.
An empty git status --short is the whole answer. Report that there
is nothing to commit and stop; don't work through the diffs to confirm
it. git diff --stat prints nothing on a clean tree, and reading that
silence as a failed command rather than as the answer is a real failure
mode — observed 2026-09-09, three tool calls spent re-asking the same
question.
Splitting into commits
- One logical unit per commit. A rename, a new feature, and a docs catch-up are three commits even when they touch the same file. Test: could each commit's subject line be written without "and"?
- Review grouping is not a commit boundary. Parts approved
together in one review are still separate commits when each stands
on its own in history — independently revertible, citable, worth
landing alone. Bundle only when the parts are mutually dependent
for meaning: a claim and the caveat qualifying it, a rename and its
call sites. Tiebreak for a docs batch — which shape would you
rather read in
git loga year from now? - Every commit must be self-consistent. No commit may reference a name, file, or skill that doesn't exist yet at that point in history, and none may leave the repo in a broken intermediate state. Order accordingly (e.g. a rename lands before anything citing the new name).
- When one file straddles commits, reach for interactive
git add -pwhere your harness offers it. Some do not: an agent shell with no interactive stdin cannot drive it, and the prompt either hangs or reads EOF. Where it is unavailable, stage through the index: scripts/stage-part.py builds the next commit's version of the file from the changed blocks a regex picks and writes it straight into the index, leaving the working tree at its final state. Read theTAKEandskipline it prints for each block, thengit diff --cached, before each commit; an emptygit status --shortafter the last commit proves the commits add up to the file on disk. Usage, limits, and the blob built by hand for changes no unchanged line separates: references/index-staging.md. Stepping the file through intermediate states on disk is the fallback — edit it down to the first commit's portion, commit, restore the next portion, commit again — and rewrites the working tree, so verify the final state matches the intended end state exactly. Stepping assumes you own the whole file. If another session has uncommitted work in it, stepping rewrites their in-flight text — commit only what is yours and leave the rest with a note. - Stage explicit paths only. No
git add -A/git add .— they silently sweep in untracked or unrelated files. - Verify the index before each commit.
git diff --cached -- <paths>must show your change and nothing else. The diff you read in the survey is not whatgit addstaged: the file can change in between, andgit add <path>takes every hunk in the file, not the hunk you meant.--statis not enough — a foreign hunk in a file you also edited has a stat line that looks exactly right. This is the last point at which a swept-in change is free to fix — and in a shared tree it has to gate the commit rather than precede it; see below. - Renames go through
git mv(or are staged so git detects the rename) so history follows the file.
Messages
- Subject:
<type>(<scope>): <imperative summary>, with the scope where the log uses one.<type>is one of the conventional-commit types~/.claude/CLAUDE.md§ "Branch naming" lists,perf,buildandciamong them. Lowercase after the colon, no trailing period. - Body: explain motivation and non-obvious decisions — why the change exists, what prompted it, provenance ("derived from X, now deleted"), and any ordering or scoping rationale. Never restate the diff. Wrap near 72 columns. Trivial single-file changes may skip the body.
- Multi-line messages: from PowerShell, a single-quoted here-string
(
@'...'@, closing delimiter at column 0) handed to-m, never to-F -, which reads stdin and leaves git the here-string as a pathspec:error: pathspec '<subject>…' did not match any file(s) known to git, exit 1, nothing committed (2026-10-09). From Bash, prefergit commit -F -fed by a quoted heredoc over-m, which sidesteps the quoting entirely. Crossing the two exits 0 — a PowerShell here-string handed to-min the Bash tool commits@as the subject with the delimiters in the body, and neither the hooks nor the exit code says so. Confirm withgit log -1 --format=%B --statbefore reporting the commit — one call gives both the message actually recorded and the files actually in it.
Safety rails
- Never push, amend, force, rebase, or tag unless the user asked for that in this conversation. Commit, report, stop.
- Never
--no-verify/ skip hooks; if a hook fails, fix the cause. - If a change looks accidental or unrelated to the stated work, leave it uncommitted and flag it rather than sweeping it in.
- Scan for identity strings — in the diff and in the message you
are about to write. An organization's account names (
AzureAD\…, Entra accounts), tenant names, internal hostnames, and hardcodedC:\Users\<name>profile paths get genericized before the commit, whatever the repo's visibility. gitleaks does not cover this: it matches secrets, not identities, and the pre-commit hook only sees staged content, so the message is unguarded entirely. The trap is that a commit documenting machine- or tenant-specific behaviour is exactly where real account names read as the subject matter — and a message, unlike a file, cannot be fixed forward. Assume nothing catches this for you. A hook can: anidentity-guardreading a local denylist blocks a commit whose staged diff adds a listed term, hands back a message that carries one, and blocks the push. But it is a local hook reading a local list — the list is itself the leak, so it lives in no repo and travels with no clone. Unless you installed both on this machine, nothing above is checked for you and the scan is entirely yours. Even where it does run it knows only what is on the list, so a name it has never seen is yours to catch, and then to add.
When another session shares this tree
Two sessions in one working tree share every file, the index and
HEAD, so neither staging nor a branch isolates you — only a commit
does, and only if it lands on the branch you meant. Suspect it when the
survey shows a path you never touched, when something is already staged
that you did not stage, when git diff --cached holds a hunk you cannot
account for from this conversation, when HEAD is not on the branch you
left it on, or when the user says so. Rule out the two innocent
explanations first: your own stepping edits, and a hook that rewrites
files, which leaves its rewrite unstaged. Neither is contention.
A linked worktree is a tree of its own: git keeps its index and HEAD
under .git/worktrees/<name>/, so a session alone in one has nothing
to suspect and commits with the plain commands. The EnterWorktree
guard refuses the chained form below there as too complex to verify
(2026-10-06, 2.1.289), and a worktree needs none of it.
Commit each finished unit unasked while a peer shares the tree: the
user's standing word since 2026-10-09. Held for their review, it can
vanish under a peer's stash, checkout or pre-commit run before they
look, and nothing reports it; a commit they did not want costs a revert.
A peer is any live ListAgents row that may sit in this tree: a
<cwd-basename>-<hash> naming it or a folder in it, or a named row you
cannot place elsewhere, idle or never prompted alike, since the user can
prompt it at any moment. Finished means the hooks pass and nothing in it
dangles; work in progress stays out, and the report says it is at risk.
Only the user's word in this conversation holds a finished unit back.
Run the whole procedure, but on main where step 4 would branch, ask
instead, since git switch -c moves the peer's HEAD too. Open the report
with the commit and why it was made unasked.
- Ask them.
ListAgentsnames every live session by its/renameor--namename, else<cwd-basename>-<hash>— its working directory, not its repo — andSendMessagereaches one. Read every row rather than filtering by repo name: a peer sitting in a subdirectory of this tree is both the likeliest contender and invisible to a prefix match (measured 2026-09-17). A peer is the only source for what is in its working tree and not inHEAD, so ask it — "are you editing<path>right now?" — before cutting a patch, not after a collision. What they say about committed state is as old as their session, so check that yourself. Skip a session that was never prompted, for whichbash ~/.claude/skills/land/scripts/never-prompted.sh <name>exits 0: it holds nothing in this tree, and a message would prompt it, making it a peerlandthen has to count (2026-09-30). Stage and read in one chained command, commit in a second, and read the branch inside both — with
git write-treecarrying the index you read into the commit. The gap between reading a diff and runninggit addis where their hunk gets swept in, and HEAD is shared the same way: a peer'sgit switchmoves the branch your commit lands on, with no error on either side.git statuscannot show it — it reports files relative to HEAD, so a clean tree after someone moved HEAD reads exactly like one before, and "the tree is clean, so nothing is at risk" has been said and been wrong. One chain fromaddtocommitcloses that gap by dropping the index check: nothing can be read between two&&, and agit diff --cachedprinted mid-chain exits 0 and gates nothing (measured 2026-09-23: 3 of 3 probes on that form never verified the index).[[ "$(git branch --show-current)" == "<branch>" ]] \ && git add <paths> && git diff --cached && git write-tree # read the diff -- your hunks and nothing else -- and note the tree id [[ "$(git branch --show-current)" == "<branch>" \ && "$(git write-tree)" == "<tree>" ]] && git commit -F - <<'MSG' … MSGgit write-treehashes the whole index, so the second chain refuses if anything reached it since you read — their hunk in your file, a file of theirs — and ignores what they left unstaged, whichcommitwould not take either (all four cases measured 2026-09-23). From PowerShell both tests have to be anif: pwsh's&&runs its right side whenever the left side ran, true or false, so a literal port never refuses (measured 2026-09-23, pwsh 7.6).if ((git branch --show-current) -eq '<branch>') { git add <paths> && git diff --cached && git write-tree } if ((git branch --show-current) -eq '<branch>' -and (git write-tree) -eq '<tree>') { git commit … }A mismatch means someone moved HEAD: stop,
ListAgents, ask — switching back is a HEAD move for them too. Recorded 2026-09-22, andlandstep 1 has the other seat: a peer'sgit switch mainlanded between this session'sswitch -cand itsgit add, and the commit went tomainunnoticed for over an hour. If it already happened, propose the repair rather than run it — the stray commit onto<branch>, the wrong branch back to<sha>^— since both move refs a peer may be standing on, and resetting to the upstream instead would drop anything unpushed.- Don't route around a staged file with
git commit -- <path>. Withcore.filemodefalse, the Windows default, a pathspec commit ignores the index's mode: a new script lands 100644 thoughgit add --chmod=+xstaged 100755, a tracked one keeps HEAD's mode, and the index keeps 100755 staged asMfor the next plain commit, whoever makes it. It exits 0 (git 2.55.0.windows.3, 2026-10-01). With a peer's file staged, ask them to commit or unstage it first. fatal: Unable to create '.git/index.lock': File existsis their git command in flight, not a stale lock. Wait and retry; never delete it.[ERROR] Your pre-commit configuration is unstaged.is their edit when you never touched.pre-commit-config.yaml: pre-commit refuses every commit in the tree while that file has unstaged changes, whoever made them. Don't run thegit addit suggests, which commits their half-made config under your message; ask them to finish or revert it. A config edit of yours blocks them the same way: make it last, and stage it in the chain that commits it (pre-commit 4.6.2, 2026-10-06).[WARNING] Unstaged files detected.on your commit is pre-commit taking their edits off disk. It saves every unstaged change in the tree, theirs included, as a patch, runsgit checkout -- ., runs the hooks, and applies the patch back, so for the hooks' seconds their files read asHEAD. A write of theirs in that window fails the commit asfiles were modified by this hookunder whichever hook was running, though the hook passed; one that makes the patch conflict is discarded by a secondgit checkout -- ., underStashed changes conflicted with hook auto-fixes, which names nothing of theirs. With a peer busy in the tree, commit from a throwaway worktree, whose index, HEAD and files are yours alone, and fast-forward the shared tree, where no hook runs. Stage the path first:--ff-onlyrefuses an unstaged file asYour local changes to the following files would be overwritten by merge, even one already identical, and refuses once a peer's commit has movedmain: branch again from the newmainin the worktree and commit again, taking each file from your own commit withgit -C <wt> checkout <sha> -- <path>. Copy nothing from the shared tree while a peer commits: acpinside their stash window takesHEAD's version, and the worktree's staged diff comes back empty, so write the edit into the worktree's copy instead. Thegit diff --quietbefore the fast-forward is the shared side's check: it refuses while their stash has your file reading asHEAD, the moment a fast-forward would fail their restore twice and leave their edits in the patch file alone. The work itself never leaves the main checkout (pre-commit 4.6.2staged_files_only.py; the spurious failure, the clean restore, the empty copy and both refusals measured 2026-10-08, git 2.55.0.windows.3; the rollback and the failed restore read, not run).git worktree add -b <branch> <scratch>/wt HEAD # then write your edit into <scratch>/wt/<path> git -C <scratch>/wt add <path> && git -C <scratch>/wt diff --cached # your hunk alone; commit there git diff --quiet <branch> -- <path> && git add <path> && git merge --ff-only <branch> # refuses mid-stash: retry git worktree remove <scratch>/wt && git branch -d <branch>- Record what you left. Commit only what is yours, and name the
deferred piece in the commit message so
git logcarries it rather than this conversation.
Staging one hunk out of a file they are also writing: references/concurrent-sessions.md.
Fabric Git-synced repos
Before the first commit in a repo containing *.{ItemType} folders:
check git config core.autocrlf and whether .gitattributes pins the
item folders (per ~/.claude/rules/fabric-git-serialization.md).
Whitespace-only diffs (EOF newline, CR-stripping) in portal-owned files are
translation artifacts — do not commit them as "cleanup"; flag them and
fix the .gitattributes instead.
Finish
git status --shortmust come back clean, or every remaining line must be intentionally left and mentioned in the report.- Report each commit: hash, subject, and one line on what it contains — plus an explicit note that nothing was pushed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

