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.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

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, actionable instruction skill with a clear multi-step workflow and proper progressive disclosure via a real one-level reference. It is slightly verbose in its source-preference guidance and lacks an explicit validation feedback loop, which cap conciseness and workflow clarity just below the top.

Suggestions

Tighten the source-preference and avoidance lists in 'Research Rules' into a shorter allow/deny pair to reclaim tokens without losing the quality signal.

Add an explicit verification checkpoint near the end of the workflow (e.g., re-check that every factual claim has a citation link before saving) to lift workflow clarity to the top anchor.

Consider moving the inline 'Quality Bar' bullets into the reference or trimming overlap with note_framework.md to sharpen the overview/detail split.

Dimension	Reasoning	Score
Conciseness	Dense and assumes Claude's competence without explaining basic concepts, but the source-preference list ('publisher pages, author interviews, official talks, academic reviews...') and avoidance list ('low-effort summaries, unsourced listicles, scraped review farms...') could be trimmed slightly while preserving clarity.	4 / 5
Actionability	Concrete, specific guidance throughout — explicit filename pattern ('YYYYMMDD-book-notes-<book-title-slug>.md'), a real reference to load ('references/note_framework.md'), and a detailed Required Output checklist — with only minor gaps (e.g., no explicit Douban parsing detail), acceptable for an instruction-only skill.	4 / 5
Workflow Clarity	A clear 7-step numbered sequence with honesty checkpoints ('If the full book text is unavailable, state that limitation') and a thin-results guard ('If search results are thin, say so'), but no explicit validate→fix→retry feedback loop, which keeps it just below the top anchor.	4 / 5
Progressive Disclosure	Well-organized overview body with clearly signaled, one-level-deep reference ('Load references/note_framework.md for the note structure, quality bar, and visual ideas'), and the referenced file is confirmed present in the bundle, giving clean navigation without nested references.	5 / 5
	Total	17 / 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 with explicit what/when structure, rich bilingual trigger terms, and a distinct Douban-book-notes niche. The only minor weakness is that the concrete action set is effectively a single generative task rather than a broad menu of operations.

Dimension	Reasoning	Score
Specificity	Names one concrete action ('Generate a source-backed, shareable Chinese Markdown reading note') and enumerates many specific note components (metadata, external research, argument, evidence, logic, assumptions, insights, transferability, reflection), but the underlying action set is essentially one generative task rather than multiple distinct operations, leaving minor coverage gaps relative to a fully comprehensive action list.	4 / 5
Completeness	Explicitly answers both what ('Generate a source-backed, shareable Chinese Markdown reading note from a Douban book URL') and when ('Use when the user provides a Douban book link and asks for 读书笔记, book notes...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural trigger coverage across two languages — '读书笔记, book notes, book summary, reading reflection, 图文并茂笔记, or a Markdown article' plus 'Douban book URL/link' — giving users multiple synonyms they would actually say.	5 / 5
Distinctiveness Conflict Risk	Clear narrow niche (Douban book URLs, Chinese reading notes) with distinct triggers that would rarely collide with other skills, keeping conflict risk minimal.	5 / 5
	Total	19 / 20 Passed

Validation

100%

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: digoal/blog
Path: skills/douban-book-notes/SKILL.md
Commit: 3b9c83d

Reviewed: 3 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.