CtrlK
BlogDocsLog inGet started
Tessl Logo

format-todo-list

Generate properly formatted TodoWrite lists for orchestrator progress tracking. Use when creating phase checklists, updating task status, or ensuring consistent todo formatting.

64

Quality

75%

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

Quality

Content

63%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 is highly actionable — a complete, executable transformation spec with concrete JSON examples and explicit error handling — but it is padded: three near-duplicate examples and rules re-teaching verb conjugation Claude already knows roughly triple the necessary length. The single external reference (template.json) is also dangling, since no such file ships in the bundle.

Suggestions

Collapse Examples 1–3 into one worked example; all three demonstrate the same receive→generate→validate→format pattern and cutting two removes ~120 lines without losing coverage.

Delete the imperative-to-present-continuous rules ("Run X" → "Running X" etc.) — one worked example already demonstrates the transformation Claude can trivially infer.

Fix the Supporting Files section: either ship the referenced `template.json` or remove the dangling, self-referential pointer to it.

DimensionReasoningScore

Conciseness

The body runs ~223 lines for a trivial JSON transform: three worked examples ("Example 1: Phase Checklist", "Example 2: Simple Task List", "Example 3: Priority-Based List") each demonstrate the identical input→output pattern, and the rules section teaches verb conjugation Claude already knows ("Convert imperative to present continuous", "Run X" → "Running X"). This matches anchor 2's 'noticeably verbose; several unnecessary explanations or padded sections'; it is above anchor 1 because nothing explains external concepts and the core Steps 1–4 are tight.

2 / 5

Actionability

Fully executable guidance: complete JSON input/output pairs ("Expected Input"/"Expected Output" in Step 4 and all three examples), an enumerated valid-status list ("pending: Not started", "in_progress: Currently active", "completed: Finished"), and concrete error behaviors ("Invalid Status: Return error listing valid statuses"). This matches anchor 5's 'copy-paste ready... specific examples cover the common cases'.

5 / 5

Workflow Clarity

Steps 1–4 give a clear sequence (Receive Todo Items → Generate Active Forms → Validate Status → Format for TodoWrite) with an embedded validation checkpoint (Step 3) and a closing Validation checklist. It sits at anchor 4 rather than 5 because the Error Handling section says to return errors but defines no fix-and-retry feedback loop, and Step 2's activeForm generation is heuristic rather than deterministic for non-template content.

4 / 5

Progressive Disclosure

Section structure is good (When to Use, Instructions, Error Handling, Examples, Validation), but the only external reference is broken: "`template.json`: TodoWrite format template (see Supporting Files section)" points to a file that does not exist in the bundle, and the pointer is self-referential (the Supporting Files section pointing to itself). Anchor 3's 'references present but not clearly signaled' fits; it is not anchor 2 because the inline content is small-format examples rather than misplaced bulk reference material.

3 / 5

Total

14

/

20

Passed

Description

87%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 explicitly answers both what and when, uses natural trigger phrases users would actually say, and occupies a distinct niche around TodoWrite formatting. The only gap is modest keyword coverage — a few synonymous phrasings (e.g., 'task list', 'progress tracking checklist') could be added.

DimensionReasoningScore

Specificity

The what-clause names one concrete action ("Generate properly formatted TodoWrite lists for orchestrator progress tracking") and the when-clause enumerates several specific activities ("creating phase checklists, updating task status, or ensuring consistent todo formatting"), matching anchor 4's 'several specific actions; minor gaps in coverage'. It is above anchor 3 because more than 1-2 concrete actions are named, and below anchor 5 because coverage of the format transform itself (activeForm generation, status validation) is only implied.

4 / 5

Completeness

Both parts are explicit: the what ("Generate properly formatted TodoWrite lists for orchestrator progress tracking") and a concrete when-clause ("Use when creating phase checklists, updating task status, or ensuring consistent todo formatting"). This matches anchor 5's 'clearly and explicitly answers both what AND when with concrete trigger phrases'; anchor 4 would require the when to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

Natural user phrases like "todo list", "phase checklists", "task status", and "todo formatting" are present, giving good keyword coverage per anchor 4. It falls short of anchor 5's 'comprehensive coverage of natural terms including synonyms and file extensions' because common variations such as "task list", "progress tracker", or related tool names (TaskCreate/TaskUpdate) are missing.

4 / 5

Distinctiveness Conflict Risk

"TodoWrite lists" and "orchestrator progress tracking" carve out a clear niche with distinct triggers and minimal conflict risk, matching anchor 5. It is not anchor 4 because the description is tied to a specific tool and formatting purpose rather than a broad file type that would overlap with related skills.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
maslennikov-ig/claude-code-orchestrator-kit
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.