jj VCS Agent Skill
A skill that teaches Claude Code to work with Jujutsu: atomic commits via describe, squash, split and absorb.
- 81 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The agent runs jj commands that rewrite commit history and can lose changes on error.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/jj-vcs-agent-skillDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent runs jj commands that rewrite commit history and can lose changes on error.
This is third-party code. Review the repository files before installing.
What it does
The skill explains to the agent how Jujutsu (jj) works: the working copy is always a commit, there is no staging area, and changes move between commits with `squash` and `split`. Descendant commits rebase on their own, commits have stable change IDs, and conflicts can be committed and resolved later. The workflow: describe the commit first with `jj desc -m`, make atomic changes, then refine history through `squash`, `split` and `absorb`. `SKILL.md` lives in the `jujutsu` directory. The repository includes an evaluation suite: by the author measurements the agent succeeds in 90 of 90 trials with the skill and 66 of 90 without it.
Who it is for. Developers who moved to Jujutsu and want Claude Code to stop breaking history with git commands.
Good fit when
- The repository was created with jj without colocated git and plain git commands do not work in it.
- You need to rebase the feature bookmark onto main without losing commits.
- A large set of edits is broken into several atomic commits with `split`.
- The project uses jj together with git and the agent needs a hint on combining them.
Not a fit when
- The project runs on plain git and you do not use Jujutsu.
- You need a jj version far older than 0.37.0 or newer than 0.46.0, which the skill was not tested on.
- You need support for agents other than Claude Code: the author tested only it.
Example request
Split the current changes into two atomic commits with descriptions and rebase the feature bookmark onto main.Limitations
The skill is designed for jj 0.46.0, the latest scenario run also passes on 0.37.0, and other versions are not guaranteed. Testing used only Claude Code with the `claude-sonnet-5-5` model. The 90 of 90 and 66 of 90 figures come from 30 scenarios with three trials each, most in a repository without colocated git. The skill does not replace knowing jj: confirm risky history operations such as force pushes yourself.
How to disable. Delete the `jujutsu` folder from the project `.claude/skills/` or from `~/.claude/skills/`.
FAQ
How do I install the skill?
With `just install` or by copying: `cp -r jujutsu/ /path/to/your/project/.claude/skills/jujutsu/`. For a global install the target is `~/.claude/skills/jujutsu/`.
Which jj versions are supported?
The skill targets 0.46.0 and the latest scenario run also passes on 0.37.0. Other versions are not promised.
How do I verify the skill myself?
The `evals` directory holds the scenarios and a Harbor harness. `just eval 0.46.0` runs Claude Code, and the `--no-skill` flag gives a comparison without the skill.
Does git need to be alongside?
No. Most scenarios run in a repository without colocated mode, where git commands fail and the agent must use jj.
What does the skill teach the agent?
To describe a commit first with `jj desc -m`, make atomic changes and clean history with `squash`, `split` and `absorb`.
Discussion
No questions or reviews yet.
Related
SkillsOver twenty skills for coding agents: MCP and hooks, plan mode, a bug-fix protocol, prompting and a bash safety hook
110 skills for Claude Code and Codex and seven Claude Code agents: development, product, UI, diagnostics and operations, installed whole or as a bundle
Nine personal engineering skills: an idea-to-PR chain, standards search, a sandboxed review loop and wizard pages for changes
17 ready skills for tests, Git, READMEs and multi-agent work plus a kernel that checks skill execution in Claude Code and Codex.
14 skills that find the gaps in a task before the code: interviews, plans, assumption tests and proof that a bug fix works
Six Claude Code skills: code review for SOLID and security, the Sigma tutor, skill audit and creation, a wiki from notes and a book-reading coach
README in short
The skill describes jj philosophy and the working order: description first, atomic commits, history cleanup. Evaluation scenarios and run reports are attached.