youdaonote

有道云笔记官方 skill，支持笔记 CRUD（创建/读取/更新/删除）、待办管理、网页剪藏、笔记搜索、文件夹管理等基础操作。如需构建知识库或 Wiki，请使用 youdaonote-llm-wiki skill 而非本 skill。

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./SKILLs/youdaonote/SKILL.md

Quality

Content

76%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 highly actionable and well-structured with a strong setup validation flow, but it loses points on workflow clarity because destructive operations (delete) lack validation checkpoints, and it carries minor redundancy around the create-vs-save warning.

Suggestions

Add a validation/confirmation checkpoint before destructive operations (e.g. verify the fileId via `read` or list confirmation before `delete`), which would lift the workflow-clarity cap.

Consolidate the repeated "禁止用 create 保存 Markdown" warning into a single prominent pitfall callout to reduce token redundancy.

Consider splitting the full 命令速查 / todo subcommand reference into a bundled reference file to keep SKILL.md a leaner overview, improving progressive disclosure for this multi-task skill.

Dimension	Reasoning	Score
Conciseness	Mostly lean operational guidance (command tables, exact flags, copy-paste bash) that assumes Claude's competence and avoids explaining concepts, with minor redundancy — the "禁止用 create 保存 Markdown" warning recurs three times and the 命令速查 table overlaps later detailed sections.	4 / 5
Actionability	Fully executable throughout: concrete commands with exact flags and JSON payloads (e.g. `youdaonote -s ydn save --file note.json`, the contentFile/parentId JSON examples) cover the common cases in copy-paste-ready form.	5 / 5
Workflow Clarity	The 前置条件 setup flow has a clear decision tree with validation checkpoints (list → detect error → install/upgrade → re-run), but destructive note operations like `delete <fileId>` have no validation/confirmation checkpoint, so per the destructive-operations cap workflow clarity cannot exceed 3.	3 / 5
Progressive Disclosure	No bundle files exist, so all content is inline, but it is organized into clearly signaled sections (前置条件, 全局参数, 命令速查, 笔记管理, 网页剪藏, CLI 未安装处理, 故障排查, 注意事项) with a quick-reference table serving as an overview; structure is good with only minor organization gaps.	4 / 5
	Total	16 / 20 Passed

Description

71%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 specific and well-scoped to a named product with strong capability enumeration and an explicit sibling-skill boundary, but it omits a positive 'Use when...' trigger clause, capping completeness and leaving trigger phrasing implicit.

Suggestions

Add an explicit 'Use when...' trigger clause (e.g. "Use when the user wants to manage Youdao Cloud notes, todos, or clip web pages") so the 'when' is stated, not just implied by the negative boundary.

Include natural synonyms and product-specific terms users say (e.g. '有道云笔记', '笔记', '待办事项', '剪藏网页') to broaden trigger-term coverage.

Reinforce the positive trigger alongside the existing wiki-skill boundary so the description answers both what and when in a single sentence.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete capability areas — "笔记 CRUD（创建/读取/更新/删除）、待办管理、网页剪藏、笔记搜索、文件夹管理" — giving comprehensive coverage of distinct actions rather than vague language.	5 / 5
Completeness	The 'what' is clearly stated via the enumerated CRUD/待办/剪藏/搜索/文件夹 operations, but there is no explicit 'Use when...' trigger clause — the 'when' is only weakly implied through a negative boundary, so per the missing-trigger cap it stays at 3.	3 / 5
Trigger Term Quality	Natural domain keywords are present (笔记、待办、网页剪藏、搜索、文件夹) that a user would actually say, but coverage lacks synonyms/file-extension equivalents and is not framed as explicit trigger phrases.	4 / 5
Distinctiveness Conflict Risk	It names a specific product niche (有道云笔记 official) and explicitly resolves the one closely-related sibling ("如需构建知识库或 Wiki，请使用 youdaonote-llm-wiki skill 而非本 skill"), leaving only minor overlap risk with that related skill.	4 / 5
	Total	16 / 20 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
relative_links	Relative link issues: 2 missing	Warning

	Total	14 / 16 Passed

Repository: netease-youdao/LobsterAI
Path: SKILLs/youdaonote/SKILL.md
Commit: 100d3f7

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.