CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

todo-manager

帮助用户管理待办事项,支持添加、删除、标记完成、列出任务等操作。

50

Quality

63%

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 ./.agents/skills/skill-upper/evals/fixtures/skills/sample-with-evals/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

51%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 admirably lean and well-sectioned, but it is a skeleton without an engine: it points to scripts/todo.py which does not exist in the bundle, provides no command syntax or usage examples, and includes no validation around the destructive delete operation. Shipping the script (or documenting its CLI) with usage examples would transform it.

Suggestions

Ship the referenced scripts/todo.py in the bundle (or remove the reference) — the body currently instructs Claude to use a script that does not exist anywhere in the skill.

Add concrete, copy-paste-ready usage examples for each operation, e.g. `python scripts/todo.py add "买牛奶"`, `python scripts/todo.py done 3`, `python scripts/todo.py list --status pending`, so the skill is executable without guessing the CLI.

Add a verification step around the destructive delete operation (e.g., confirm the task ID exists and show the task before deleting, or verify the deletion succeeded) — destructive operations without validation cap workflow clarity at 3.

DimensionReasoningScore

Conciseness

The body is ~20 lines with zero padding and no explanations of concepts Claude already knows — sections ("## 功能", "## 触发场景", "## 脚本") each earn their place, matching the anchor 'lean and efficient; assumes Claude's competence; every token earns its place'. It is not 4 because there is nothing that could be trimmed.

5 / 5

Actionability

The only concrete guidance is "使用 `scripts/todo.py` 进行持久化操作,数据存储在工作区的 `todos.json` 中" plus a trigger-to-operation mapping — minimal concrete pointers with no specific steps to execute (no command syntax, arguments, or examples for todo.py). It sits at the 'minimal concrete guidance; missing the specific steps to execute' anchor rather than 1 because concrete artifacts (script path, data file) are named; it cannot be 3+ because the referenced scripts/todo.py does not exist in the bundle, leaving nothing executable at all.

2 / 5

Workflow Clarity

The body maps triggers to operations ("完成了任务 X"→mark complete, "删除任务 X"→delete) but defines no step sequence for actually performing an operation, and the destructive delete operation has no validation/verification step — which per the judging guidelines caps workflow clarity at 3. It scores 2 rather than 3 because no steps are listed at all (the mapping is not a step sequence) and validation is entirely absent; it is above 1 because the capabilities and trigger mapping are coherently organized.

2 / 5

Progressive Disclosure

The short body is well-sectioned (matching the simple-skill pattern), but its single external reference "scripts/todo.py" is dangling — no scripts/ directory or any bundle file exists — so the reference resolves to nothing and Claude would try to read a missing file. This fits 'references present but not clearly signaled' territory more than the 4 anchor's 'minor organization gaps', because a broken reference is a functional navigation defect, not just an organizational one.

3 / 5

Total

12

/

20

Passed

Description

58%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 does a solid job stating concrete capabilities but omits any 'when to use' trigger guidance, which caps its completeness and weakens trigger-term quality. Adding an explicit trigger clause with natural user phrases (and removing the "等操作" hedge) would raise it substantially.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user mentions 待办事项、任务清单、todo, or asks to add/complete/delete/list tasks" — the missing 'when' guidance currently caps completeness at 3.

Include natural synonyms and user phrasings users would actually say ("待办", "清单", "打卡", "todo", "checklist") to broaden trigger-term coverage beyond the formal capability verbs.

Drop the vague trailing "等操作" ("etc.") hedge and instead enumerate the actual full operation set, including the status filtering mentioned in the body, for comprehensive coverage.

DimensionReasoningScore

Specificity

The description names the domain ("帮助用户管理待办事项") and enumerates four concrete actions ("添加、删除、标记完成、列出任务"), matching the anchor for several specific actions with minor gaps. It falls short of 5 because the trailing hedge "等操作" ("and other operations") signals unspecified extras rather than comprehensive coverage; it is above 3 because it lists several specific actions rather than only 1-2.

4 / 5

Completeness

The 'what' is clear (manage todos with add/delete/mark-complete/list operations), but the 'when' is entirely absent — there is no "Use when..." or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. It is not 4/5 because no usage trigger exists at all; it is not 2 because the 'what' half is concrete and multi-action.

3 / 5

Trigger Term Quality

Relevant domain keywords are present ("待办事项", "任务", "添加", "删除", "标记完成", "列出任务") but natural variations users might say (e.g., "待办", "任务清单", "checklist", "提醒", "记录") are missing, matching the anchor 'some relevant keywords but missing common variations or synonyms'. It is not 4 because there is no trigger-phrase phrasing (no 'Use when...' equivalent) and synonym coverage is thin; it is not 2 because the terms are domain-specific rather than generic.

3 / 5

Distinctiveness Conflict Risk

The todo-management niche with its specific CRUD enumeration ("添加、删除、标记完成、列出任务") is mostly distinct with only minor overlap risk against closely related task-management or reminder skills, matching the anchor at 4. It is not 5 because there are no explicit trigger phrases to sharpen the niche; it is not 3 because the enumerated operations on 待办事项 are more specific than generic 'works with X files' phrasing.

4 / 5

Total

14

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

LuminairPrime/git-worktrees-prime

Path

.agents/skills/skill-upper/evals/fixtures/skills/sample-with-evals/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.