CtrlK
BlogDocsLog inGet started
Tessl Logo

priority-task-reader

按优先级读取任务 Skill - 从 todos.json 读取 in-progress 和 pending 任务,按 P0-P9 优先级排序

48

Quality

50%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.trae/openclaw-skills/priority-task-reader/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body provides concrete commands and clearly sequenced workflows in a well-organized structure, but it spends tokens on verbose output examples, hardcodes non-portable personal paths, and lacks validation checkpoints. It is functional and clear yet leaves clear room to tighten and harden.

Suggestions

Trim or remove the large ASCII output-example blocks; a short representative snippet conveys the same information with far fewer tokens.

Replace the hardcoded 'cd /Users/bytedance/...' path and absolute config paths with portable/relative paths so the commands are copy-paste ready anywhere.

Add a brief verification checkpoint to the 推进todo workflow (e.g., confirm the selected task's status and Feedback Required flag before executing) to strengthen workflow clarity.

DimensionReasoningScore

Conciseness

The body is mostly efficient and does not explain concepts Claude already knows, but it pads the context with large ASCII output-example blocks (the '任务列表输出' and '下一个任务输出' sections) that add little actionable value. It is tighter than the verbose level-1 anchor but not lean enough for level 3, where every token must earn its place.

2 / 3

Actionability

Concrete, executable commands with flags are provided ('python3 main.py --json', '--next', '--next-count 3', '--config'), but the first example hardcodes a personal machine path ('cd /Users/bytedance/CS-Notes/.trae/openclaw-skills/priority-task-reader') and references a main.py/skill.json that are not bundled. This is concrete-but-incomplete guidance with a missing key detail, below level 3's copy-paste-ready bar.

2 / 3

Workflow Clarity

Two clear sequences are present (the 5-step 核心功能 list and the 4-step '在推进todo指令中使用' workflow), but neither includes explicit validation or verification checkpoints. The task is low-risk so the destructive-cap does not force level 1, but the absence of checkpoints keeps it at level 2 rather than level 3's explicit validation/feedback loops.

2 / 3

Progressive Disclosure

The skill is well-sectioned (核心功能, 优先级排序规则, 使用方法, 输出示例, 配置) with no external bundle files, but at ~130 lines it exceeds the 'under 50 lines' allowance for a level-3 score, and the long inline output examples are content that could be split into a separate file. It is better organized than the level-1 monolithic wall but lacks the clear one-level-deep reference split of level 3.

2 / 3

Total

8

/

12

Passed

Description

50%

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 concisely states what the skill does with a concrete data source and actions, but omits any 'when to use it' trigger guidance and relies on technical status/priority jargon rather than natural user phrases. It is competent but stops just short of being self-activating.

Suggestions

Add an explicit 'Use when...' trigger clause, e.g. 'Use when the user says 推进todo or asks for the next task to work on,' to raise completeness above 2.

Replace some technical jargon (in-progress/pending/P0-P9) with natural user-facing terms ('推进todo', '下一个任务', '按优先级排任务') to improve trigger-term quality.

Mention the additional concrete capabilities surfaced in the body — grouping tasks by priority and returning the next actionable task — for fuller specificity.

DimensionReasoningScore

Specificity

The description names a concrete domain ('从 todos.json 读取 in-progress 和 pending 任务') and two concrete actions (read/filter + '按优先级 P0-P9 优先级排序'), but it is not comprehensive — the body's grouping and 'next task' capabilities are absent. This matches 'names domain and some actions, but not comprehensive', not level 3 which requires multiple specific concrete actions.

2 / 3

Completeness

The 'what' is present (read and priority-sort tasks from todos.json), but there is no 'Use when...' clause or equivalent trigger guidance; the guidelines cap completeness at 2 in that case. It clearly exceeds level 1 (which requires missing or very weak what/when) but lacks the explicit 'when' needed for level 3.

2 / 3

Trigger Term Quality

It includes relevant keywords ('读取任务', '优先级', 'todos.json') but leans on technical jargon ('in-progress', 'pending', 'P0-P9') rather than natural user phrasings like '推进todo' (which only appears in the body). It has some relevant keywords but misses common natural variations, so it is not level 1 (no keywords) nor level 3 (good natural-term coverage).

2 / 3

Distinctiveness Conflict Risk

The niche (priority-sorted task reading from todos.json) is fairly specific and unlikely to conflict broadly, but the description provides no explicit triggers and could overlap with generic task-management skills. It is more specific than level 1 ('would conflict with many skills') but lacks the distinct explicit triggers required for level 3.

2 / 3

Total

8

/

12

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.

Validation16 / 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.