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**

86

1.50x
Quality

81%

Does it follow best practices?

Impact

96%

1.50x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

85%

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 is a strong, specific description that clearly defines a niche workflow around JJ (Jujutsu) TODO commit management. It excels at specificity and distinctiveness, listing concrete actions and unique concepts. The main weakness is that trigger terms lean heavily on specialized jargon rather than natural language a user might employ when seeking this functionality.

Suggestions

Add more natural trigger terms users might say, such as 'task tracking', 'plan work', 'manage todos', or 'organize tasks in commits' to improve discoverability beyond JJ-specific jargon.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: plan tasks as empty commits with [task:*] flags, track progress through status transitions, manage parallel task DAGs with dependency checking, enforce completion discipline, divide work between Planners and Workers.

3 / 3

Completeness

Clearly answers both 'what' (plan tasks as empty commits, track progress, manage parallel task DAGs) and 'when' ('Use to plan tasks as empty commits with [task:*] flags, track progress through status transitions, manage parallel task DAGs'). The 'Use to...' clause serves as an explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes some relevant keywords like 'TODO', 'commit', 'JJ', 'Jujutsu', 'task', 'DAG', and 'dependency', but these are fairly specialized terms. Missing more natural user phrases like 'task management', 'track tasks', 'plan work', or 'todo list'. A user might not naturally say 'task DAG' or '[task:*] flags'.

2 / 3

Distinctiveness Conflict Risk

Highly distinctive with a very clear niche: JJ/Jujutsu-based TODO commit workflow with specific concepts like empty commits, [task:*] flags, Planners/Workers roles, and task DAGs. Unlikely to conflict with generic task management or git skills.

3 / 3

Total

11

/

12

Passed

Implementation

77%

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

This is a well-structured, highly actionable skill that clearly defines a TODO commit workflow using JJ. Its greatest strengths are the concrete executable examples, clear role delineation (Planner/Worker), and explicit validation checkpoints throughout the workflow. The main weakness is moderate verbosity—some sections could be tightened or moved to reference files to reduce the token footprint, and there are minor redundancies (repeated reminders about external scripts, the renaming note).

Suggestions

Trim the 'When to Use draft vs todo' section and 'Completion Discipline' checklist—the ✅/❌ lists repeat information already conveyed by the status flag table and workflow steps.

Move the 'Writing Good TODO Descriptions' section and the 'AI-Assisted TODO Workflow' section to separate reference files, leaving only brief summaries with links in the main SKILL.md to reduce token footprint.

DimensionReasoningScore

Conciseness

The skill is fairly long (~300 lines) and includes some redundancy (e.g., reminders about which role sections apply to, repeated notes about scripts from other skills, the NOTE about renaming 'broken' to 'standby'). However, most content earns its place given the complexity of the workflow. Some tightening is possible—the 'When to Use draft vs todo' section and the verbose completion discipline checklist could be condensed.

2 / 3

Actionability

The skill provides concrete, executable bash commands throughout, with specific script invocations, flag values, and jj commands. The Quick Start section is a complete copy-paste-ready cycle, and examples like the TODO description template and dependency checking commands are fully actionable.

3 / 3

Workflow Clarity

The workflow is clearly sequenced (Plan → Work → Complete → Next) with explicit validation checkpoints: verify acceptance criteria before marking done, check dependencies before starting, run tests before transitioning. The `jj-todo-next` without args serves as a review/validation step, and there are clear error recovery instructions ('When to Stop and Report'). Feedback loops are present (validate → fix → re-validate implied in completion discipline).

3 / 3

Progressive Disclosure

The skill references external files (`references/parallel-agents.md`, the `working-with-jj` skill) appropriately, and uses a Quick Start → detailed sections structure. However, the body itself is quite long with substantial inline content (the full TODO description template, the AI-assisted workflow section, completion discipline details) that could potentially be split into reference files. The helper scripts table at the end provides good navigation, but no bundle files were provided to verify references.

2 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

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.