CtrlK
BlogDocsLog inGet started
Tessl Logo

todo

Search the entire codebase for TODO markers and create a markdown document with proposed next steps for each.

54

Quality

61%

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

Quality

Content

68%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 body is a well-structured, actionable instruction skill with lean sections and clear sequencing. Its main weakness is workflow clarity: a batch repo-wide scan lacks an explicit validation/feedback checkpoint, capping that dimension at 3.

Suggestions

Add an explicit validation step to the procedure, e.g. "Verify the report against Pass Criteria; if TODOs were missed or next steps are restatements, re-scan and revise before finalizing."

Provide a concrete executable search command (e.g. `rg -n --hidden 'TODO|FIXME' .`) to lift actionability toward 5.

Tighten the enumerated example lists in "Required Search Targets" and "Propose Next Steps" to push conciseness toward 5.

DimensionReasoningScore

Conciseness

The body is sectioned and lean, never explaining what a TODO is or basic concepts Claude already knows, with only minor lists (search-target variants, example next steps) that could be trimmed; it is not 5 because a few enumerated examples are slightly obvious.

4 / 5

Actionability

Concrete, specific guidance is given throughout — required search targets, fields to capture (file path, line, excerpt, subsystem, next step, priority), report structure, and pass criteria — which is actionable for an instruction-only skill; it is not 5 because no executable command (e.g. a grep/ripgrep invocation) is provided, leaving a minor gap.

4 / 5

Workflow Clarity

The five-step procedure is clearly sequenced and dedup is called out, but this batch repo-wide scan has no explicit validate→fix→retry checkpoint, so the batch-operation cap holds it at 3; the Pass Criteria section provides final verification but not the per-step feedback loop needed for 4.

3 / 5

Progressive Disclosure

No bundle files exist and the single-file body is well-organized into clear sections with no inlined content that belongs elsewhere; it is not 5 because the skill exceeds ~50 lines and lacks any one-level-deep reference signaling, so the simple-skill 5 exception does not fully apply.

4 / 5

Total

15

/

20

Passed

Description

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

The description is concrete and distinct but omits any explicit "Use when..." trigger guidance, which caps completeness at 3. Trigger-term coverage is adequate yet lacks common synonyms users would actually say.

Suggestions

Append a "Use when..." clause naming natural triggers, e.g. "Use when the user wants a TODO/FIXME backlog, a technical-debt audit, or triage before a release."

Add natural synonyms users say ("TODO comments", "FIXME", "backlog", "technical debt") to broaden trigger-term coverage.

Optionally surface a third concrete action (e.g. deduplicate and categorize TODOs) to lift specificity toward 4.

DimensionReasoningScore

Specificity

Quotes "Search the entire codebase for TODO markers" and "create a markdown document with proposed next steps for each" name the domain plus two concrete actions, matching the anchor for 1-2 concrete actions without being comprehensive; it does not reach 4 because only two actions are listed and nothing about dedup/categorization is surfaced.

3 / 5

Completeness

The description gives a clear "what" (search for TODO markers and produce a markdown report) but no "Use when..." trigger clause, so per the missing-trigger-guidance cap it stays at 3; it is not 2 because the "what" is concrete, and not 4 because "when" is entirely absent rather than weakly implied.

3 / 5

Trigger Term Quality

"TODO markers", "codebase", "markdown document", and "next steps" are relevant keywords, but common user phrasings like "TODO comments", "FIXME", "backlog", or "technical debt" are absent, leaving synonyms and variations missing as at anchor 3; it is above 2 because multiple relevant terms appear.

3 / 5

Distinctiveness Conflict Risk

Auditing inline TODO markers into a planning markdown report is a fairly distinct niche with low overlap risk, fitting "mostly distinct; minor overlap risk"; it is not 5 because the phrasing is generic enough to brush against general code-search skills.

4 / 5

Total

13

/

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.

Validation15 / 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
vladmandic/sdnext
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.