CtrlK
BlogDocsLog inGet started
Tessl Logo

book-note-writer

生成深度读书笔记的专用 Skill。输入书籍的豆瓣链接(或书名+作者),自动搜索书籍信息、高质量书评、学术评价等素材,结合 Claude 的深度思考,生成图文并茂、观点鲜明、适合分享的读书笔记,以 Markdown 格式保存到项目 markdown/ 目录。触发条件:用户提供豆瓣链接、提到"读书笔记"、"书评"、"帮我分析这本书"、"写一篇XX书的笔记",或任何希望深度理解一本书的场景。即使用户只说"帮我写一下这本书的感悟",也应使用本 skill。

68

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

70%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, actionable research-and-writing workflow with excellent validation checkpoints and fallback handling. The main weaknesses are mild verbosity in stylistic guidance and a missed progressive-disclosure opportunity: an existing reference file is duplicated inline rather than linked.

Suggestions

Replace the inlined high-quality-source priority list in Step 1.2 with a link to the existing references/high-quality-sources.md (e.g. 'See [high-quality-sources.md](references/high-quality-sources.md)') to avoid duplication and fix the missing reference signal.

Trim repeated stylistic coaching ('有温度', '通俗易懂', '适合分享') and the per-section word-count annotations in the template to reduce padding Claude doesn't need.

Note that web_fetch/web_search are shown as pseudocode; if real tool signatures exist, make the calls copy-paste ready, otherwise briefly justify the shorthand.

DimensionReasoningScore

Conciseness

Mostly targeted instructional content, but stylistic coaching Claude already grasps ('有温度', '通俗易懂', '适合分享') is repeated and per-section word-count prescriptions pad the template; could be tightened without losing clarity.

3 / 5

Actionability

Provides concrete search-query templates, file-path/naming examples, a YAML frontmatter template, and a full output structure — mostly executable, with minor gaps (web_fetch/web_search shown as pseudocode rather than real signatures, SVG guidance abstract).

4 / 5

Workflow Clarity

Steps 0–5 are clearly sequenced with explicit '✅ 检查点' confirm-gates, fallback branches for cold books / no-results / Douban failure, a confirm-before-save guard, and a final quality checklist — strong feedback loops throughout.

5 / 5

Progressive Disclosure

Good section structure exists, but a reference file (references/high-quality-sources.md) is present yet never linked from the body, and its source-priority content is duplicated inline — content that should be offloaded is not clearly signaled.

3 / 5

Total

15

/

20

Passed

Description

95%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 strong, specific description that clearly conveys both capability and trigger conditions with natural user phrasing. Minor specificity gap from the open-ended '等素材', but otherwise comprehensive and distinct.

DimensionReasoningScore

Specificity

Lists several concrete actions (accept Douban links or title+author, auto-search book info/reviews/academic commentary, generate illustrated opinionated notes, save to markdown/), with a slightly open-ended '等素材' keeping it just shy of comprehensive.

4 / 5

Completeness

Explicitly answers both what (search materials, generate notes, save as Markdown to markdown/) and when (a dedicated '触发条件' clause listing concrete trigger phrases), matching the top anchor.

5 / 5

Trigger Term Quality

Comprehensive natural-language triggers users would actually say — '读书笔记', '书评', '帮我分析这本书', '写一篇XX书的笔记', '帮我写一下这本书的感悟', plus '豆瓣链接' — with good synonym coverage.

5 / 5

Distinctiveness Conflict Risk

'深度读书笔记生成' is a clear niche with distinctive triggers (豆瓣链接, 读书笔记, 书评) and a specific output target, giving minimal overlap risk with other skills.

5 / 5

Total

19

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
digoal/blog
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.