CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

douban-book-notes

Generate a source-backed, shareable Chinese Markdown reading note from a Douban book URL. Use when the user provides a Douban book link and asks for 读书笔记, book notes, book summary, reading reflection, 图文并茂笔记, or a Markdown article that combines book metadata, high-quality external research, the author's argument, evidence, logic, assumptions, insights, transferability, and personal reflection saved under the current project's markdown directory.

68

Quality

86%

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

78%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 instruction-only skill: lean sections, a concrete workflow with fallbacks, specific output requirements, and correct use of a single clearly-signaled one-level reference. The main opportunities are small: deduplicate the two overlapping caution lines, add an explicit citation-format example, and add a final verification step against the Required Output checklist before saving.

Suggestions

Add a final workflow step to verify the saved note against the Required Output checklist (all sections present, ≥2 visuals, bibliography) before finishing — this would also give workflow_clarity an explicit validation loop.

Include one concrete example of the expected citation format (e.g., a sample inline link with source title) so the 'direct citations with links' rule is unambiguous.

Consolidate the overlapping caution in Research Rules ("If search results are thin...") and Quality Bar ("Do not overstate certainty...") into one place to trim tokens.

DimensionReasoningScore

Conciseness

The ~50-line body is lean and directive throughout — no explanations of concepts Claude already knows, no padding, and every section adds skill-specific requirements (source hierarchy, fact/interpretation/inference separation, required output sections). Minor trims are possible: the caution about thin sources in Research Rules overlaps with the Quality Bar's uncertainty line, and the metadata field enumeration in step 1 ("title, author, translator if any, publisher, publication year, ISBN...") is partly obvious. This puts it at anchor 4 (efficient with minor over-explanation) rather than the perfectly earned-token profile of anchor 5.

4 / 5

Actionability

Concrete, executable guidance for an instruction-only skill: a specific filename pattern ("YYYYMMDD-book-notes-<book-title-slug>.md"), the save directory ("markdown/" with create-if-missing), exact wording examples ("资料显示", "评论者认为", "我的判断是"), a visual count requirement ("at least two useful visuals in Markdown, Mermaid, ASCII table, or inline SVG"), and an explicit pointer to the framework reference. It stays at 4 rather than 5 because a few execution details are left implicit — e.g., no example of the citation/link format expected and no example of a Douban URL or its ID structure — leaving minor gaps.

4 / 5

Workflow Clarity

A clear 7-step numbered sequence from URL parsing to saving the file, with contingency checkpoints present: "If the full book text is unavailable, state that limitation" (step 4) and "If search results are thin, say so and write a more cautious note instead of padding" (Research Rules). It is not a destructive or batch operation, so no cap applies. It misses anchor 5 because these are contingent fallbacks rather than an explicit validate-then-proceed loop — e.g., no step to verify the saved file's structure against the Required Output checklist before finishing.

4 / 5

Progressive Disclosure

The body is well organized into short, clearly-headed sections (Goal, Workflow, Research Rules, Required Output, Quality Bar) and moves the detailed note structure into a single one-level-deep reference that is clearly signaled and purpose-labeled: "Load references/note_framework.md for the note structure, quality bar, and visual ideas." The referenced file exists and contains exactly what the pointer promises (a full Markdown note template and analysis guidance), so navigation is clean with no nesting.

5 / 5

Total

17

/

20

Passed

Description

87%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 description with an explicit 'Use when...' clause, bilingual natural triggers, and a concrete, specific statement of what it produces and where it saves the output. It is written in third person and avoids fluff; the main gap is missing common Chinese trigger variants ("豆瓣", "读后感").

Suggestions

Add natural Chinese trigger variants users would say: "豆瓣", "豆瓣读书链接", and "读后感" alongside the existing 读书笔记/book notes terms.

Trim the long enumeration of note components ("evidence, logic, assumptions, insights, transferability...") — it inflates length without adding trigger value; the body already specifies the output structure.

DimensionReasoningScore

Specificity

The description names the concrete action ("Generate a source-backed, shareable Chinese Markdown reading note from a Douban book URL") plus specifics like language, shareability, output format, and save location ("saved under the current project's markdown directory"). It sits at anchor 4 rather than 5 because it covers essentially one composite action rather than multiple discrete concrete actions, and the long inventory of note components ("the author's argument, evidence, logic, assumptions, insights, transferability") reads more like scope description than a list of actions.

4 / 5

Completeness

It explicitly answers both questions: what ("Generate a source-backed, shareable Chinese Markdown reading note... combining book metadata, high-quality external research...") and when ("Use when the user provides a Douban book link and asks for 读书笔记, book notes, book summary, reading reflection...") with concrete trigger phrases. This matches the anchor-5 example pattern almost exactly; anchor 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Good natural keyword coverage in both English and Chinese: "读书笔记", "book notes", "book summary", "reading reflection", "图文并茂笔记", "a Douban book link". It misses common Chinese variations a user would naturally say — "豆瓣" (the site's Chinese name), "读后感", "豆瓣读书" — which keeps it below the comprehensive synonym/variant coverage of anchor 5, but it is well above the sparse keyword coverage of anchor 3.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Douban book URLs → structured Chinese reading notes) with distinct triggers; the "Douban book link" requirement means generic note-taking or writing skills would not fire. Only the broadest phrases like "book summary" without a Douban link create minor overlap, which is far below the anchor-4 threshold of meaningful overlap with closely related skills.

5 / 5

Total

18

/

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

digoal/blog

Path

skills/douban-book-notes/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.