CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agentic-jujutsu

Quantum-resistant, self-learning version control for AI agents with ReasoningBank intelligence and multi-agent coordination

Quality

57%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/agentic-jujutsu/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is actionability-focused with real, mostly executable code and a clear recurring workflow, but it is heavily padded with thrice-repeated examples and inlines its entire API reference rather than splitting it into reference files. Cutting duplication and moving the API tables and use cases into bundled reference files would cut the token cost roughly in half without losing information.

Suggestions

Deduplicate the trajectory lifecycle examples — Quick Start, Core Capabilities, Advanced Use Cases, and Examples all demonstrate the same start/add/finalize pattern; keep one canonical example and vary only genuinely new material.

Move the API reference tables, the four Advanced Use Cases, and the Examples section into references/ files (e.g. references/api.md, references/examples.md) linked one level deep from SKILL.md.

Complete the partial examples by defining the stub functions (executeOperation, verifyDeployment, executeTask) or replacing them with real JjWrapper calls so the code is copy-paste ready, and fold the duplicated validation rules into one section.

DimensionReasoningScore

Conciseness

The ~640-line body is noticeably verbose with heavy redundancy: the same trajectory workflow (startTrajectory → operations → addToTrajectory → finalizeTrajectory) is demonstrated in Quick Start, again in Core Capabilities, again in three Advanced Use Cases, and a third time in the Examples section, and the validation rules appear in both section 1 and a standalone 'Validation Rules' section. It avoids score 1 because it does not explain basic concepts Claude already knows — the padding is repetition, not conceptual hand-holding.

2 / 5

Actionability

Most guidance is executable JavaScript against a real npm package, with method signatures, return types, and error handling, plus a copy-paste install command. It misses score 5 because several prominent examples depend on undefined stubs (executeOperation(), verifyDeployment(), executeTask(), this.execute(), agent.analyze()), so they are not copy-paste ready.

4 / 5

Workflow Clarity

Multi-step processes are clearly sequenced (start trajectory → perform tracked operations → addToTrajectory → finalize with score/critique) and error handling shows try/catch feedback loops that record failures for learning, supported by a troubleshooting section. It falls short of score 5 because validation appears only in scattered examples rather than as explicit enforceable checkpoints or a checklist for the workflow.

4 / 5

Progressive Disclosure

Section headers are clear, but the skill is a monolithic 640-line file with no bundle files: ~120 lines of API reference tables, four advanced use cases, and two full example workflows are all inlined where the rubric expects them in separate one-level-deep reference files. It matches anchor 3 ('some structure but content that should be separate is inline') rather than 4, since the bulk of the content — not just a minor portion — belongs in reference files.

3 / 5

Total

13

/

20

Passed

Description

41%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a buzzword-heavy one-liner that names a genuinely distinct niche but gives no concrete actions and completely lacks 'when to use' trigger guidance. It would rarely be selected by a user's natural phrasing. Adding an explicit 'Use when...' clause with plain-language triggers and concrete capabilities would substantially improve it.

Suggestions

Add an explicit trigger clause, e.g. 'Use when multiple AI agents need to commit concurrently, when agents conflict over a shared Git repo, or when the user mentions jujutsu/jj or lock-free version control.'

Replace buzzwords ('ReasoningBank intelligence', 'quantum-resistant') with concrete capabilities users can recognize: create commits, branches, resolve conflicts automatically, learn from past operations.

Include natural trigger terms and synonyms users would actually say — 'version control', 'jj', 'Git', 'merge conflicts', 'parallel agents' — instead of product-internal jargon.

DimensionReasoningScore

Specificity

The description names the domain ('self-learning version control for AI agents') but contains no concrete actions — no committing, branching, merging, or conflict resolution — while 'Quantum-resistant' and 'ReasoningBank intelligence' are buzzwords. It matches anchor 2 (domain named, actions minimal or generic) rather than 3, which requires 1-2 concrete actions to be listed.

2 / 5

Completeness

It has a recognizable 'what' (self-learning version control for AI agents) but no 'when' guidance whatsoever — no 'Use when...' clause or equivalent trigger. Per the rubric guideline a missing 'Use when' clause caps completeness at 3; it cannot score 4 because the 'when' is entirely absent, not merely implicit.

3 / 5

Trigger Term Quality

'version control' and 'AI agents' are somewhat natural, but 'ReasoningBank intelligence', 'Quantum-resistant', and 'multi-agent coordination' are technical jargon users would not naturally say. Common natural phrases a user would utter ('jj', 'git conflicts', 'parallel agents', 'lock-free commits') are missing, matching anchor 2 rather than 3, which requires genuinely relevant keyword coverage.

2 / 5

Distinctiveness Conflict Risk

The niche (lock-free version control for concurrent AI agents) is mostly distinct from typical skills, with only minor overlap risk against general git/version-control skills. It falls short of anchor 5 because the vague, buzzword-heavy phrasing provides no distinct concrete triggers that would reliably disambiguate it.

4 / 5

Total

11

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (646 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

ruvnet/ruflo

Path

.claude/skills/agentic-jujutsu/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.