mtaran

Jj Guide — Development skill for Claude Code

Development community

Claude Code / Agent skill for working with Jujutsu (jj) VCS — agent-safe, progressive-disclosure.

How to install Jj Guide

This entry records only its repository, not the path inside it, so there is no exact command to give. Open mtaran/jj-guide and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Jj Guide does

Claude Code / Agent skill for working with Jujutsu (jj) VCS — agent-safe, progressive-disclosure.

Alternatives in Development

Claude How To — by luongnv89 — Example-driven guide to mastering Claude Code through progressive tutorials with copy-paste tem 8.5k ★
Om Tidy — Self-maintenance pass — acts on every hygiene flag: archives completed work, groups loose clusters, splits ove 4.6k ★
Claude-code-safety-net Rules Reference — Custom rules reference for defining safe/dangerous command patterns 1.2k ★

README

jj-guide

A Claude Code / Agent skill for working safely and effectively with [Jujutsu (jj)](https://github.com/jj-vcs/jj), a Git-compatible VCS with mutable commits, automatic snapshotting, no staging area, and first-class conflicts.

The skill is designed for non-interactive agent use: it teaches the agent which jj commands hang in TUI environments, how to avoid them, and how to recover when something goes sideways.

Installation

This is a [Claude Code skill](https://docs.claude.com/en/docs/claude-code/skills). To install it as a personal skill, clone into your skills directory:

git clone https://github.com/mtaran/jj-guide.git ~/.claude/skills/jj-guide

The skill activates automatically in any repository containing a `.jj/` directory.

Layout

jj-guide/
├── SKILL.md                              # main entry — critical rules, mental model, common workflows
└── references/                           # progressive disclosure, loaded on demand
    ├── git-to-jj.md                      # full Git ⇄ jj command mapping + filesets
    ├── revsets.md                        # operators, functions, string/date patterns, recipes
    ├── bookmarks.md                      # tracking, push safety, multi-remote workflows
    ├── conflicts.md                      # marker formats (jj/snapshot/git), resolution
    ├── operation-log.md                  # undo, --at-op, recovering files from snapshots
    ├── workspaces.md                     # multiple working copies, stale recovery, colocated
    ├── glossary.md                       # formal definitions
    ├── troubleshooting.md                # diagnostic protocol, problem→fix table, rebase matrix
    ├── workflow-commit-push-pr.md        # ship a PR end-to-end
    └── workflow-new-workspace.md         # isolated workspace + bookmark for parallel work

`SKILL.md` contains everything needed for routine work. The files under `references/` are loaded by the agent only when the user's task touches that t