Skip to content
Back to search

jujutsu-skill

Agent Skill for working with Jujutsu VCS

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/danverbraganza/jujutsu-skill with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/danverbraganza/jujutsu-skill'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/danverbraganza--jujutsu-skill/badge.svg)](/listings/danverbraganza--jujutsu-skill)

HTML

<a href="/listings/danverbraganza--jujutsu-skill"><img src="/api/listings/danverbraganza--jujutsu-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

If you use [just](just.systems), you can run:

just install

Copy the `skill/` directory into your project's `.claude/skills/` directory:

cp -r skill/ /path/to/your/project/.claude/skills/jj-vcs/

Or install it as a global skill:

cp -r skill/ ~/.claude/skills/jj-vcs/

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 93 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # jj VCS Agent Skill
  2. An Agent Skill that helps AI coding agents work with the Jujutsu (jj) version control system.
  3. ## Overview
  4. This repository provides an Agent Skill for Claude Code and other compatible AI agents to effectively use the Jujutsu VCS. The skill teaches agents the proper workflow and commands for creating atomic, well-documented commits using jj.
  5. ## Compatibility
  6. **Tested with:** jj v0.46.0
  7. This skill is designed for jj v0.46.0 and may work with other versions, though compatibility is not guaranteed. The [latest eval run](evals/results/2026-11-03-skill-improvements.md) passes on both v0.37.0 and v0.46.0.
  8. ## What is Jujutsu?
  9. Jujutsu (jj) is a Git-compatible version control system that offers several advantages:
  10. - **Working copy as a commit**: The working directory is always a commit, automatically snapshotting changes
  11. - **No staging area**: Changes are moved directly between commits using `squash` and `split`
  12. - **Automatic rebasing**: Descendant commits are automatically rebased when parent commits change
  13. - **Mutable commits**: Commits can be freely edited, split, and squashed
  14. - **Change IDs**: Stable identifiers that persist across commit rewrites
  15. - **Conflict handling**: Conflicts can be committed and resolved later
  16. ## Installation
  17. If you use [just](just.systems), you can run:
  18. ```
  19. just install
  20. ```
  21. Copy the `jujutsu/` directory into your project's `.claude/skills/` directory:
  22. ```bash
  23. cp -r jujutsu/ /path/to/your/project/.claude/skills/jujutsu/
  24. ```
  25. Or install it as a global skill:
  26. ```bash
  27. cp -r jujutsu/ ~/.claude/skills/jujutsu/
  28. ```
  29. ## Skill Contents
  30. ```
  31. jujutsu/
  32. └── SKILL.md # Main skill file with jj workflow instructions
  33. ```
  34. ## Key Workflow Philosophy
  35. The skill emphasizes:
  36. 1. **Describe-first commits**: Use `jj desc -m "message"` before making changes
  37. 2. **Atomic commits**: Each commit should represent one logical change
  38. 3. **Commit quality preservation**: Leverage jj's mutability to refine commits
  39. 4. **Clean history**: Use `squash`, `split`, and `absorb` to maintain a readable history
  40. ## Evaluation
  41. In an end-to-end evaluation with [Harbor](https://harborframework.com/docs), the skill lets Claude Code
  42. complete 36% more tasks than it does without the skill: 100% of trials succeed with it (90 of 90), and
  43. 73% without it (66 of 90). Both runs used the same 30 scenarios, three trials each, against jj 0.46.0.
  44. Each scenario gives the agent a plain-language request, such as "Rebase my feature bookmark onto main",
  45. in a real jj repo, and grades only the repo's end state. Most scenarios use a jj repo that is not
  46. colocated with git, so git commands fail and the agent has to use jj. Scenarios about using jj and git
  47. together run in a colocated repo. Only Claude Code has been tested so far, with `claude-sonnet-5-5`.
  48. ### Running the evals
  49. `evals/` holds the scenarios and the harness. Each scenario runs in a container with an official jj
  50. release. Any agent Harbor supports works, including Claude Code and pi.
  51. ```bash
  52. just eval-selftest 0.46.0 # check every scenario with Harbor's oracle and nop agents, no API calls
  53. just eval 0.46.0 # run Claude Code on the scenarios against jj 0.46.0
  54. just eval 0.46.0 --agent pi --model anthropic/claude-sonnet-5
  55. just eval 0.46.0 --no-skill # the same scenarios without the skill, for comparison
  56. ```
  57. See [evals/README.md](evals/README.md) for credentials, the scenarios, and the diagnostics.
  58. ## Contributing
  59. Contributions are welcome. Please ensure any changes are compatible with jj v0.46.0; `just eval 0.46.0` checks this.
  60. ## License
  61. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.