CtrlK
BlogDocsLog inGet started
Tessl Logo

agentic-jujutsu

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

41

1.26x
Quality

17%

Does it follow best practices?

Impact

81%

1.26x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agents/skills/agentic-jujutsu/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

7%

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

This description reads like marketing copy rather than a functional skill description. It is dominated by buzzwords ('quantum-resistant', 'self-learning', 'ReasoningBank intelligence') that provide no actionable information about what the skill actually does or when it should be selected. It fails on all key dimensions: no concrete actions, no natural trigger terms, and no explicit usage guidance.

Suggestions

Replace buzzwords with concrete actions the skill performs (e.g., 'Tracks file changes, manages branches, resolves merge conflicts for AI agent workflows').

Add an explicit 'Use when...' clause with natural trigger terms users would actually say (e.g., 'Use when the user asks about version control, tracking changes, branching, or coordinating code across multiple agents').

Remove or minimize marketing language like 'quantum-resistant' and 'self-learning' unless they describe genuinely distinct, user-facing capabilities, and if so, explain them concretely.

DimensionReasoningScore

Specificity

The description uses abstract buzzwords like 'quantum-resistant', 'self-learning', and 'ReasoningBank intelligence' without describing any concrete actions. There are no specific operations listed (e.g., commit, branch, merge, diff).

1 / 3

Completeness

The description vaguely gestures at 'what' (version control) but provides no 'when' clause or explicit trigger guidance. There is no 'Use when...' or equivalent, and the 'what' itself is obscured by marketing-style language.

1 / 3

Trigger Term Quality

The keywords are highly technical jargon ('quantum-resistant', 'ReasoningBank intelligence', 'multi-agent coordination') that no user would naturally say when needing version control help. 'Version control' is the only somewhat natural term, but it's buried among buzzwords.

1 / 3

Distinctiveness Conflict Risk

The buzzword-heavy language is distinctive enough that it's unlikely to accidentally trigger for common tasks, but the core concept ('version control') could overlap with standard git/VCS skills. The jargon creates accidental distinctiveness rather than intentional clarity.

2 / 3

Total

5

/

12

Passed

Implementation

27%

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

This skill reads more like a product README or marketing document than a concise, actionable skill for Claude. It is extremely verbose with repetitive examples all demonstrating the same trajectory pattern, includes promotional claims and performance benchmarks, and packs everything into a single monolithic file. While the code examples are relatively concrete and the API reference is useful, the overall token efficiency is very poor and the content would benefit enormously from aggressive trimming and splitting into referenced sub-files.

Suggestions

Reduce the body to ~100 lines: keep Quick Start, a single trajectory example, the API reference tables, and move Advanced Use Cases, Best Practices, Troubleshooting, and Examples into separate referenced files.

Remove all marketing language, performance comparison tables, version history, and status badges—these waste tokens and don't help Claude execute tasks.

Consolidate the 8+ trajectory examples into 1-2 canonical examples that cover the core pattern (start → operate → add → finalize → suggest), and reference additional patterns in a separate EXAMPLES.md.

Add explicit validation checkpoints in the workflow (e.g., verify JjWrapper initialization, check trajectory ID is valid before adding operations) rather than only showing error handling in a troubleshooting section.

DimensionReasoningScore

Conciseness

Extremely verbose at ~400+ lines. Includes extensive marketing language ('23x faster than Git', 'quantum-resistant'), redundant examples showing the same trajectory pattern 8+ times, a performance comparison table with unverifiable claims, version history, and status badges. Much of this is promotional rather than instructional, and the repetitive trajectory start/add/finalize pattern is shown far more times than necessary.

1 / 3

Actionability

Code examples are concrete and appear executable with specific API calls and return types. However, many examples reference undefined helper functions (executeOperation, verifyDeployment, executeTask, agent.analyze) making them incomplete. The API reference tables are useful but the code is not fully copy-paste ready due to these undefined dependencies.

2 / 3

Workflow Clarity

The trajectory workflow (start → operations → add → finalize) is repeated clearly across examples, and error handling patterns are shown. However, there are no explicit validation checkpoints between steps—for instance, no guidance on verifying trajectory was properly started before adding operations, or checking that the JjWrapper initialized correctly. The troubleshooting section partially compensates but validation is reactive rather than proactive.

2 / 3

Progressive Disclosure

The skill is a monolithic wall of text with everything inline. Despite referencing external docs (VALIDATION_FIXES_v2.3.1.md, AGENTDB_GUIDE.md), no bundle files are provided. The advanced use cases, full API reference, performance tables, best practices, validation rules, troubleshooting, and multiple examples could all be split into separate files. The 'Related Documentation' section at the bottom references files but the body doesn't use progressive disclosure effectively.

1 / 3

Total

6

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
ruvnet/claude-flow
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.