gjalla-prepare-and-commit — Claude Code skill: setup guide
Prepares staged code for clean commits by verifying tests and splitting mixed diffs. It formats change reports for human review.
npx skills add gjalla/engineering --skill gjalla-prepare-and-commit -a claude-code
npx skills add gjalla/engineering --skill gjalla-prepare-commit -a claude-codeWhat gjalla-prepare-and-commit does
This skill guides the agent through verifying working changes before creating git commits. It checks whether acceptance criteria are met and placeholder stubs are removed. If checks fail, the agent stops instead of applying quick fixes.
The workflow introduces an explicit human gate. The agent drafts a short summary covering test runs and system impact. Then it prepares a staging plan using precise file selection or git add -p rather than broad git add . operations.
Syncing specs into the main record fails completely if repository hooks for gjalla are not installed beforehand. The tool also formats commit metadata using gjalla attest --example and stops before pushing code to remote branches without direct permission.
What it helps with
- verify test results and remove leftover placeholder stubs
- split mixed diffs into atomic commits using
git add -p - generate an evidence-backed change summary for human review
- format attestations for
gjallacommit hooks
Example prompts for the agent
- Review current unstaged changes and prepare an atomic commit plan.
- Run tests and draft the change report before staging files.
- Generate the gjalla attestation and commit this bugfix.
How to install gjalla-prepare-and-commit
1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-prepare-and-commit -a claude-codenpx skills add gjalla/engineering --skill gjalla-prepare-commit -a claude-code2Manually: put the files in place
~/.claude/skills/gjalla-prepare-commit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gjalla-prepare-commit/
1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-prepare-commit -a codex2Manually: put the files in place
.agents/skills/gjalla-prepare-commit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-prepare-commit -a cursor2Manually: put the files in place
.cursor/skills/gjalla-prepare-commit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gjalla/engineering gjalla-prepare-commit2Manually: put the files in place
.github/skills/gjalla-prepare-commit/SKILL.md1Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-prepare-commit -a gemini-cli2Platform CLI
gemini skills install https://github.com/gjalla/engineering --path skills/gjalla-prepare-commitManually: put the files in place
.devin/skills/gjalla-prepare-commit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add gjalla/engineering --skill gjalla-prepare-commit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gjalla-prepare-and-commit
How do I install gjalla-prepare-and-commit in Claude Code?
Run npx skills add gjalla/engineering --skill gjalla-prepare-and-commit -a claude-code.
What does gjalla-prepare-and-commit do?
It enforces pre-commit verification by running tests, drafting an evidence report for human review, and splitting diffs into atomic commits.
What happens if gjalla git hooks are missing?
Without the preconfigured hooks, your attestation and spec will fail to sync with the primary source of truth during the commit.