CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

integrate-todo-list

TodoWrite panel for an already-approved in-app useAtlasChat UI. New AI features use integrate-fusion-agent. Triggers: TodoWrite, todo panel — only when useAtlasChat already exists.

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, multi-step integration guide with concrete, near copy-paste code at every step, a clean file table pointing one level deep into a code bundle, and a verification step. The only weaknesses are minor: no error-recovery loop after the type-check, slight redundancy in the closing summary, and bundle-file navigation that relies on a find command.

DimensionReasoningScore

Conciseness

The body is lean: numbered steps, a purpose table for the eight module files, and code blocks with no explanation of concepts Claude already knows. Only minor trim candidates exist, e.g. the four-bullet "Done" outcome summary restating behavior already implied by the steps and comments like "Keep a ref so getAppContext always reads fresh state" — borderline useful, not padding. This matches anchor 4 (efficient, minor over-explanation) rather than 5 (every token earns its place).

4 / 5

Actionability

Guidance is fully executable: an exact find command to locate the skill directory, a file-by-file copy plan, near copy-paste code for every integration point (provider wrap, getAppContext, tool wiring, panel and card rendering), and a concrete verify command ("pnpm tsc --noEmit"). Placeholders like `{/* existing children */}` and `<YourChatInput ...>` are app-specific and their flexibility is explicitly justified ("adjust path to match the app's conventions"), which the rubric permits.

5 / 5

Workflow Clarity

Seven clearly sequenced steps (read app → create module → wrap provider → wire tool → render panel → render card → verify) with a validation checkpoint in Step 7 (type-check plus running tests). It falls below anchor 5 because there is no error-recovery feedback loop — Step 7 says to confirm no errors but not what to do when errors appear — matching anchor 4 (most checkpoints present, minor validation gaps).

4 / 5

Progressive Disclosure

SKILL.md stays an overview: implementation bulk lives in a separate code/ bundle surfaced through a purpose table with one-level-deep references ("Read each file from `<skill-dir>/code/`"), which is well-signaled. It falls below anchor 5 because locating that bundle requires a find-command indirection and the referenced bundle files are not present/verifiable in the skill package being evaluated, leaving minor navigation and structure gaps.

4 / 5

Total

17

/

20

Passed

Description

73%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 terse, third-person description with explicit trigger terms, strong disambiguation against a sibling skill, and a clear precondition. Its main weakness is that the "what" names the deliverable (a TodoWrite panel) without stating the concrete actions the skill performs, and it lacks common trigger synonyms.

Suggestions

State the concrete actions rather than only the artifact, e.g. "Adds a TodoWrite tool and renders a live todo task panel inside an existing useAtlasChat-powered chat UI".

Broaden trigger coverage with natural synonyms users would say: "todo list", "task list", "task panel", "show task progress".

Move the routing note ("New AI features use integrate-fusion-agent") into the when-clause so the what/when split reads cleanly.

DimensionReasoningScore

Specificity

The description names a concrete deliverable ("TodoWrite panel for an already-approved in-app useAtlasChat UI") but stops at naming the domain plus one artifact; it does not list the concrete actions performed (adding the tool, wiring it into useAtlasChat, rendering the panel). It is above anchor 2 because "TodoWrite panel" is a specific artifact, not a generic action, but below anchor 4 because no several specific actions are enumerated.

3 / 5

Completeness

Both parts are present: the "what" ("TodoWrite panel for an already-approved in-app useAtlasChat UI") and an explicit "when" ("Triggers: TodoWrite, todo panel — only when useAtlasChat already exists"). It is below anchor 5 because the "what" is a terse fragment rather than a clear statement of the actions performed, though the "when" is explicit.

4 / 5

Trigger Term Quality

Explicit trigger terms "Triggers: TodoWrite, todo panel" are natural phrases a user would say, plus the governing condition "useAtlasChat already exists". It falls short of anchor 5 because common variations like "todo list", "task list", or "task panel" are missing.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche and actively routes conflicts away: "New AI features use integrate-fusion-agent" and "only when useAtlasChat already exists". It also names the prerequisite skill lineage (useAtlasChat), so minimal conflict risk remains.

5 / 5

Total

16

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository

cognitedata/builder-skills

Path

skills/integrate-todo-list/SKILL.md

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.