jujutsu

Teach LLMs to operate Jujutsu repositories for version-control task automation.

Updated Feb 27, 2026
One-click install
npx skills add https://github.com/cfcosta/duskpi --skill jujutsu-cfcosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jujutsu
Source: https://github.com/cfcosta/duskpi/tree/main/skills/jujutsu
Command: npx skills add https://github.com/cfcosta/duskpi --skill jujutsu-cfcosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teaches the LLM how to use Jujutsu (jj), a Git-compatible VCS, correctly. Use when a .jj/ directory exists at the workspace root (jj-managed repo, possibly colocated with .git/), when the user mentions "jj"/"jujutsu", or when the user asks for VCS operations and prefers jj. Covers mental model, commands, bookmarks, push workflow, conflicts, recovery via the operation log, revsets/templates/filesets, scripting hygiene, and known gotchas.

Core Features & Use Cases

  • Teaches a mental model for jj: how it represents commits, operation logs, and the differences to Git.
  • Maps common Git intents to jj equivalents, enabling smooth VCS conversations and task execution.
  • Highlights workflows for bookmarks, pushes, rebases, conflicts, and recovery, with guidance on when jj is preferred over Git.

Quick Start

Activate this skill when a workspace contains a .jj/ directory and you want to manage VCS tasks with jj.

Frequently Asked Questions about jujutsu

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use jj for version control in a colocated Git repository?

Use jj for version control in colocated repositories by operating on commits directly while Git tracks the underlying objects. The Skill activates when a `.jj/` directory exists, mapping common Git intents to jj equivalents for managing bookmarks, rebases, and conflicts.

What is the jj operation log and how does it work for recovery?

The jj operation log records every VCS action sequentially, allowing you to undo or restore previous repository states. It tracks changes to commits and bookmarks deterministically, enabling safe recovery from failed rebases, conflicts, or unintended operations.

Can I manage bookmarks and push workflows using jujutsu instead of Git?

Yes, jujutsu supports bookmark management and push workflows natively. The Skill guides bookmark creation, tracking, and deletion, while enforcing safe push operations by mapping Git intents to jj commands and verifying the operation log before execution.

How do I resolve merge conflicts in a jj-managed repository?

Resolve merge conflicts in a jj-managed repository by treating conflicts as first-class commit content rather than blocking states. The Skill provides workflows for editing conflicted files directly, using revsets to isolate changes, and finalizing via the operation log.

What are revsets and templates in jujutsu version control?

Revsets and templates in jujutsu version control provide a query language for selecting commits and customizing output formats. Revsets filter the operation log and history, while templates format commit displays, enabling precise scripting and repository navigation.

Does jujutsu support scripting and automation for version control tasks?

Yes, jujutsu supports scripting and automation through deterministic execution paths in `scripts/` and `references/` directories. The Skill enforces scripting hygiene and frontmatter rules to ensure safe, repeatable VCS operations via the operation log.