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
81%
Does it follow best practices?
Impact
96%
1.50xAverage score across 3 eval scenarios
Passed
No known issues
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
d2b7dff
Table of Contents
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.