CtrlK
BlogDocsLog inGet started
Tessl Logo

todo-finder

从 todos.json 和归档中以多种匹配方式查找 todo

60

Quality

70%

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

Quality

Content

86%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, token-efficient skill body with executable, accurate examples and appropriate structure for a simple single-purpose lookup. The main defect is a mismatch between the documented usage step (positional <query>) and the script's actual flag-based CLI, plus the undocumented --detail flag.

Suggestions

Fix 使用步骤 step 2 to match the real CLI, e.g. `python scripts/todo_finder.py --keyword "<query>"`, instead of a positional "<query>" argument the script does not accept.

Document the --detail flag and show how it maps to the 详情格式 output described in 输出格式.

Note that flags can be combined (as the --archived --keyword example implies) and what happens when no match is found.

DimensionReasoningScore

Conciseness

The body is lean with zero concept explanation: sections are limited to when to use it, three usage steps, a flag table, output format, and copy-paste examples. Every token earns its place and it assumes Claude's competence, matching the 'Lean and efficient' anchor; the only trace of padding ("脚本将返回查找结果") is a single short step, not the 'minor instances' of score 4.

5 / 5

Actionability

The examples are fully executable copy-paste commands whose flags (--id, --title, --keyword, --status, --priority, --archived, --all) match the actual script's argparse interface. It falls short of 5 because 使用步骤 step 2 shows a positional "<query>" argument the script does not accept, and the script's --detail flag is undocumented, leaving minor gaps in covering the common cases.

4 / 5

Workflow Clarity

This is a simple, single-purpose read-only lookup with an unambiguous action, which would normally merit 5 under the simple-skill exception. It drops to 4 because the documented step-2 command (positional "<query>") contradicts every example and the actual CLI, a small but real accuracy gap in the stated sequence; no validation checkpoints are required since the operation is non-destructive.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external reference files, and it is organized into clear, well-labeled sections (适用场景, 使用步骤, 匹配方式, 输出格式, 示例). Its single bundle path, scripts/todo_finder.py, is real and referenced accurately, satisfying the guideline that short simple skills can score 5 with well-organized sections.

5 / 5

Total

18

/

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 communicates a clear, concrete capability with a distinct niche, but it stops at a generic 'multiple matching methods' phrase and omits any 'Use when...' trigger guidance. Listing the actual match dimensions and adding an explicit usage trigger would bring it in line with the strong reference examples.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to find, search, or look up a todo, or mentions todos.json or the todo archive."

Enumerate the concrete match dimensions (ID, title, keyword, status, priority, assignee) instead of the vague "多种匹配方式".

Include natural synonyms and file-path triggers (搜索 todo, 查任务, .trae/todos/todos.json, archive) to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description states a concrete action ("查找 todo") and names its data sources ("todos.json 和归档"), but "以多种匹配方式" (multiple matching methods) is generic without naming any of the actual match dimensions (ID, title, keyword, status, priority, assignee). This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; it is above score 2 because real actions and sources are named, and below 4 because no specific match types are listed.

3 / 5

Completeness

The 'what' is clear (find todos from todos.json and archives via multiple match methods), but there is no 'Use when...' clause or equivalent trigger guidance, so per the judging guidelines completeness is capped at 3. It is not score 2 because the 'what' is concrete, and not 4 because 'when' is entirely absent rather than merely weak.

3 / 5

Trigger Term Quality

It includes the natural keyword "todo" and the specific file "todos.json" plus "归档" (archive), which are terms a user would say. However, common variations are missing — no "搜索/查找" phrasing variants, no "task/任务" synonym, no mention of the archive path — matching the anchor 'Some relevant keywords but missing common variations or synonyms' rather than score 4's 'Good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

"从 todos.json 和归档中查找 todo" carves out a clear niche (searching a specific todo store and its archive) with distinct triggers like "todos.json". There is minor overlap risk with todo-management skills (create/update/track todos), which keeps it below score 5, but the search-only scope and named file make it mostly distinct from those.

4 / 5

Total

13

/

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
huangruiteng/CS-Notes
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.