CtrlK
BlogDocsLog inGet started
Tessl Logo

todo-management

Systematic progress tracking for skill development. Manages task states (pending/in_progress/completed), updates in real-time, reports progress, identifies blockers, and maintains momentum. Use when tracking skill development, coordinating work, or reporting progress.

58

Quality

73%

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 ./skills/todo-management/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

48%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 skill has a clear operational structure (8 well-sequenced operations, explicit state model, real one-level-deep references) but is significantly undermined by verbosity — heavy duplication and generic advice — and by documented script commands that do not match the actual CLI. Roughly 40% of the body could move to the existing reference files without losing anything.

Suggestions

Cut the duplicated 'Quick Reference' section that restates the operations table, task-state tables, best practices, and script commands already covered earlier in the body, and merge the two 'Automation'/'Common Commands' blocks into one.

Fix the documented CLI to match scripts/update-todos.py: replace '--blocker 7 "…"' with '--block 7 --reason "…"', correct '--init task-list.md' to '--init task-list.md my-skill' (two arguments), and remove or correct the nonexistent '--update-estimate' and '--add' flags; also surface the existing '--validate' and '--unblock' flags.

Move the four 'Progress Tracking Formats' sections and the 'Maintain Momentum' strategies into the existing reference guides, keeping SKILL.md as a concise overview with the state model, operations, and script quick-start.

DimensionReasoningScore

Conciseness

The ~670-line body is noticeably padded: content is duplicated nearly wholesale (the operations table reappears in 'Quick Reference', the Automation commands reappear as 'Common Commands', best practices appear twice, task-state tables appear twice) and it explains generic todo-management advice Claude already knows ('Take 15-min break', 'Celebrate Progress', 'Remind yourself of MVP'). It is not 1 because the bulk is on-topic skill material rather than extensive background explanation; not 3 because the duplication and generic-advice sections go beyond 'some unnecessary explanation'.

2 / 5

Actionability

The tracking formats and operation processes are concrete with copy-paste markdown examples, but the documented script commands are partially wrong: '--blocker', '--update-estimate', and '--add' do not exist in scripts/update-todos.py (which uses '--block'/'--reason', '--obsolete', '--validate', '--unblock'), and '--init' actually requires two arguments (TASK_FILE SKILL_NAME) while the doc shows one. It is not 4 because a large fraction of the shown commands fail when run; not 2 because the markdown-format guidance and half the CLI are genuinely executable.

3 / 5

Workflow Clarity

Each of the 8 operations has a clear numbered Process with When-to-Use, Output, and examples; checkpoints exist ('Verify Completion: Output exists, quality checked', the Momentum Checklist), and feedback loops are present (blocker → action/escalation, actual-vs-estimated recalibration, in_progress → pending on discovered blockers). It is not 5 because validation is soft in places (e.g., the script's '--validate' flag is never surfaced, and Report Progress has no verification step); not 3 because sequences and checkpoints are explicit throughout.

4 / 5

Progressive Disclosure

The two reference guides (state-management-guide.md, progress-reporting-guide.md) are real, clearly signaled with bold links and one-line descriptions, and one level deep — but the body inlines substantial content that belongs in them (four full tracking-format sections, momentum strategies, extensive duplicated examples, a 200-line Quick Reference). It is not 4 because much content that should be separate is inline despite good reference signaling; not 2 because references are prominent rather than buried and the body has clear section structure.

3 / 5

Total

12

/

20

Passed

Description

88%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: it states concrete capabilities with the task-state model spelled out and provides an explicit 'Use when…' trigger clause. The only weaknesses are a few missing natural synonyms (e.g., 'todo list', 'checklist') and slightly broad trigger phrases ('coordinating work') that could overlap with adjacent planning skills.

DimensionReasoningScore

Specificity

The description lists five concrete actions ('Manages task states (pending/in_progress/completed), updates in real-time, reports progress, identifies blockers, and maintains momentum') with the state model spelled out, matching the comprehensive-coverage anchor. It is not 4 because no meaningful capability of the skill is left unlisted.

5 / 5

Completeness

It explicitly answers both what ('Manages task states… identifies blockers, and maintains momentum') and when ('Use when tracking skill development, coordinating work, or reporting progress') with concrete trigger phrases, matching the top anchor. It is not 4 because the 'when' clause is already explicit and trigger-phrase-based rather than merely present.

5 / 5

Trigger Term Quality

Natural phrases like 'tracking skill development', 'coordinating work', and 'reporting progress' give good keyword coverage. It is not 5 because common user-side terms such as 'todo list', 'task list', or 'checklist' are absent, leaving a few natural synonyms missing.

4 / 5

Distinctiveness Conflict Risk

The niche (progress tracking for skill development) is mostly distinct, but 'coordinating work, or reporting progress' is broad enough to risk overlap with general project- or task-management skills. It is not 5 because those triggers are not narrowly distinctive; not 3 because the skill is still clearly scoped beyond a generic 'works with tasks' description.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

14

/

16

Passed

Repository
fernandezbaptiste/Skrillz
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.