CtrlK
BlogDocsLog inGet started
Tessl Logo

jj-todo-workflow

Structured TODO commit workflow using JJ (Jujutsu). Use to plan tasks as empty commits with [task:*] flags, track progress through status transitions, manage parallel task DAGs with dependency checking. Enforces completion discipline. Enables to divide work between Planners and Workers. **Requires the working-with-jj skill**

87

1.50x
Quality

82%

Does it follow best practices?

Impact

96%

1.50x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

A well-crafted skill body: highly actionable commands with sample outputs, an explicitly validated workflow with dependency checking and completion discipline, and a sound file structure with real, well-signaled references. The main gains are literal copy-paste readiness (actual script paths), trimming duplicated notes, and offloading one or two long sections to reference files.

Suggestions

Write the actual script invocation paths (e.g., scripts/jj-todo-create ...) in the Quick Start and workflow examples so commands are copy-paste executable, instead of the 'full paths not written' placeholder.

Remove duplicated provenance notes (the jj-show-desc 'BEWARE'/'REMINDER' pair) and the 'standby was previously called broken' version-history aside to save tokens.

Move the full 'Writing Good TODO Descriptions' example and/or the 'AI-Assisted TODO Workflow' section into a references/ file, keeping SKILL.md as a leaner overview with pointers.

DimensionReasoningScore

Conciseness

Mostly lean and command/table-driven, teaching only JJ-workflow-specific knowledge Claude would not already have. Minor trimmable instances keep it below the 5 anchor: the jj-show-desc provenance is flagged twice ('BEWARE: Script from the working-with-jj skill' and 'REMINDER: jj-show-desc is from the working-with-jj skill'), the 'NOTE: In previous versions of this Skill, standby was called broken' version-history aside, and some introductory prose about the core idea. Well above the 3 anchor — no padding or explanation of concepts Claude already knows.

4 / 5

Actionability

Concrete, executable guidance throughout: specific script invocations with expected output, jj commands, a fully worked example TODO description, and a script table. Falls short of the 5 anchor ('copy-paste ready') because the Quick Start itself notes 'full paths to helper scripts not written' and examples use placeholders like <T1-id>, so commands are not literally copy-paste runnable as-is.

4 / 5

Workflow Clarity

The Quick Start lays out a numbered plan→work→verify→transition cycle, and validation is explicit and layered: 'Verify ALL acceptance criteria met' (make test), 'ONLY if all checks pass' before --mark-as done, jj-todo-next's automatic dependency checking, the ✅/❌ completion-discipline checklist, dependency inspection commands, and a dedicated 'When to Stop and Report' error-recovery section. This matches the 5 anchor's explicit validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

Good structure with clearly signaled, verified one-level-deep references: 'references/parallel-agents.md' is referenced in context, listed in a References section, and exists as a real file; the script table matches the actual contents of scripts/. Not a 5 because the ~420-line body inlines some material that could live in references (the full example TODO description, the AI-Assisted TODO Workflow section), making the overview slightly heavier than the exemplary quick-start-plus-pointers shape.

4 / 5

Total

17

/

20

Passed

Description

83%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.

A strong description: concrete, comprehensive action list with explicit (if capability-shaped) usage guidance and a clearly distinct JJ-specific niche. The explicit dependency note ('Requires the working-with-jj skill') is a plus. The only refinement is converting 'Use to...' into situational 'Use when...' trigger phrases and adding a few natural synonyms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'plan tasks as empty commits with [task:*] flags', 'track progress through status transitions', 'manage parallel task DAGs with dependency checking', 'enforces completion discipline', 'divide work between Planners and Workers' — comprehensively covering the workflow's capabilities. It exceeds the 4 anchor ('several specific actions; minor gaps') because no significant capability of the skill is omitted.

5 / 5

Completeness

Both 'what' and 'when' are present: the opening sentence states what the skill does, and 'Use to plan tasks as empty commits with [task:*] flags...' provides explicit trigger guidance, so it clears the cap-of-3 guideline for missing usage clauses. Not a 5 because the 'when' is capability-shaped ('Use to...') rather than concrete situational triggers like 'when the user mentions...' or 'when working with...', leaving it one notch below the exemplary anchor.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'TODO', 'commit', 'JJ (Jujutsu)', 'task', 'Planners', 'Workers' — terms a user of this workflow would actually say. Falls short of the 5 anchor because common synonyms and variations (e.g., 'todo list', 'backlog', 'task tracking') are absent, but it is well above the 3 anchor's 'missing common variations' since both the tool name and natural domain terms are present.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: 'JJ (Jujutsu)', 'empty commits', '[task:*] flags', 'parallel task DAGs' — no other plausible skill would trigger on these terms. Minimal conflict risk matches the 5 anchor.

5 / 5

Total

18

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
YPares/agent-skills
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.