Menu
Create atomic commits in the conventional format. Use when the user asks to commit or save changes.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Add a new shared workspace package under packages/*. Use when creating a new @packages/<name>, whether a bundled library other workspaces import or a build-only script package that runs during a build.
Orient in this repo: which file to edit for a change, how a change ripples across the stack, and how to search the code. Use at the start of a task in an unfamiliar area, or before a cross-cutting change.
Prefer Bun-native APIs, else Node built-ins with the node: prefix. Use when importing a Node built-in (fs, path, child_process, crypto, os, util), reading or writing files, spawning a process, or choosing between a Bun and a Node API.
Icebox a raised-but-undecided concern instead of forcing a plan-or-dismiss call: record it with no verdict so the context survives. Use when a review, PR, audit, or eval surfaces something real-maybe that should not be scheduled or closed yet, or when the user says to icebox or park an item.
Add a typed Hono API endpoint or WebSocket route: router, OpenAPI docs, validation envelope, and RPC client wiring. Use when adding or modifying routes in api/hono.
Start, restart, and verify the ZeroStarter dev stack. `bun run dev` serves portless named `.localhost` URLs (branch-prefixed in a worktree); resolve them with `bunx portless get`. Use when asked to run the app, when the API returns NOT_FOUND for routes that exist in source, or before browser testing.
| name | gh-commit |
| description | Create atomic commits in the conventional format. Use when the user asks to commit or save changes. |
ATOMIC commits, conventional format. Stage and commit only; never push unless the user explicitly asks.
git status --short
git diff
git diff --staged
Read staged and unstaged changes before deciding what belongs together.
Stage one logical unit per commit (ATOMIC); split unrelated changes into separate commits so every staged file belongs to the same unit.
git add <paths>
git commit -m "<type>(<scope>): <subject>"
| Element | Rule |
|---|---|
| Type | feat, fix, refactor, docs, chore, test, perf, style, build, revert. Type ci is RESERVED for pipeline-generated commits and dropped from the changelog (changelog.config.json); real CI work uses fix(ci)/feat(ci)/docs(ci). |
| Scope | Optional area in parentheses (package, component, feature). |
| Subject | Imperative, lowercase, no period. The commit-msg hook rejects a header over 100 chars or a capitalized subject (subject-case). |
| Body | Optional; explain "why", not "what". Wrap lines at 100 (the hook rejects longer). |
Never add Co-authored-by (repo rule). The commit-msg hook runs commitlint (@commitlint/config-conventional); pre-commit runs lint-staged then bun run build.
Examples:
feat(auth): add OAuth provider support
fix(api): prevent duplicate webhook delivery
refactor(web): extract auth middleware into separate module
docs(readme): update installation steps
chore(deps): bump dependencies to latest versions
Stop after the commit. Push only when the user says "commit and push", "push the changes", or confirms when asked.
bun .github/scripts/build-sizes.ts --graph.