CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ljg-book

Explain a whole book to readers without specialist knowledge: what it follows, how its main threads connect, where it ends, and how its evidence or events change understanding. Keep the book's specific content; a general lesson alone is not enough. USE WHEN given a book title, PDF, EPUB, excerpt, or asked 拆书, 分析这本书, 这本书在讲什么, 压缩一本书, or book. Defaults to a saved Org note. NOT FOR chapter summaries, papers, formal reviews, or single-concept deep dives.

Quality

84%

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

63%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 skill body is well-structured with a clear routing table, explicit output conventions, and a genuinely rigorous validation loop (script validator plus real-Emacs read-back with honest-reporting requirements). Its weaknesses are the missing ReadingGuide.md — a required reference that does not exist in the bundle — and essayistic middle sections whose writing-craft guidance could be more compact and directive.

Suggestions

Ship the missing ReadingGuide.md (referenced as 必读 in every routing row and as the source of Completion 细则) or remove/replace the reference with content actually present in the bundle.

Rewrite the essayistic writing-craft sections (e.g., 让一个念头有机会走完, 用问题的缺口拉动阅读) as tight directive bullets so each rule is checkable rather than philosophical, reducing token cost.

State where ReadingGuide.md lives (e.g., references/ReadingGuide.md) so the path is unambiguous when the file is added.

DimensionReasoningScore

Conciseness

The body avoids generic filler (no explaining what books or PDFs are) and sections like the routing table and Completion are dense, but essayistic passages such as "长短交替形成节奏,均匀的句长会让注意力走平" and "好奇心需要一个空隙才能产生;问题和答案贴在一起,等于没有提问" are abstract writing-craft prose that could be tightened into directives. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than score 4, since whole sections read as philosophy rather than economical instruction.

3 / 5

Actionability

Concrete, checkable guidance is present throughout: the input-to-output routing table, the exact default path "~/Context/" with filename pattern and "date +%Y%m%dT%H%M%S", constraints like "每个图块或表格不超过 80 显示列" and "通常一到四句", the validator command "bun {skill_dir}/scripts/validate_note.ts ... --coverage ...", and named Emacs checks (denote-retrieve-filename-identifier, org-lint). This fits 'Mostly executable guidance; concrete code or commands with minor gaps' — the gaps being that much of the middle guidance is qualitative and the cited ReadingGuide.md with the completion details is not in the bundle.

4 / 5

Workflow Clarity

The routing table sequences the task (read source, read ReadingGuide.md, save Org note), and Completion provides explicit validation checkpoints with a feedback loop ("运行下方验证器,修复结构或记录缺项,逐条读回 warning") plus a revise-and-re-read loop in the evaluation section. This matches 'Clear sequence with most checkpoints present; minor validation gaps' — the main gap is that ReadingGuide.md, the designated must-read for every routing path, is missing from the bundle, leaving part of the sequence unresolvable.

4 / 5

Progressive Disclosure

The bundle structure is mostly sound — one-level references to references/template.org, references/coverage-map.md, and scripts/validate_note.ts all exist — but "ReadingGuide.md", cited twice as required reading and as the location of completion details, is not present in the bundle, making a central reference dangling. This is worse than score 4's 'minor organization gaps': a required navigation target is broken, fitting 'references present but not clearly signaled' in the sense that the referenced material cannot actually be reached.

3 / 5

Total

14

/

20

Passed

Description

100%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 exemplary: it states concrete capabilities, an explicit USE WHEN clause with natural bilingual trigger terms and file formats, a default output artifact, and explicit NOT FOR exclusions that fence off adjacent skills. Every dimension lands on the top anchor without verbosity.

DimensionReasoningScore

Specificity

Multiple concrete actions are stated: "Explain a whole book to readers without specialist knowledge", "what it follows, how its main threads connect, where it ends, and how its evidence or events change understanding", "Keep the book's specific content", and "Defaults to a saved Org note". This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; it goes beyond score 4 by covering the task, its quality bar, and its output artifact, with no notable gaps.

5 / 5

Completeness

Both what and when are explicitly answered: the 'what' is the whole-book explanation with specific scope requirements, and the 'when' is an explicit "USE WHEN given a book title, PDF, EPUB, excerpt..." clause plus a "NOT FOR chapter summaries, papers, formal reviews, or single-concept deep dives" exclusion. This is the score-5 anchor 'Clearly and explicitly answers both what AND when with concrete trigger phrases'; score 4 would mean the when-clause was weaker or less specific, which it is not.

5 / 5

Trigger Term Quality

Triggers cover natural phrases and file formats a user would actually say: "book title, PDF, EPUB, excerpt, or asked 拆书, 分析这本书, 这本书在讲什么, 压缩一本书, or book". This matches 'Comprehensive coverage of natural terms including synonyms and file extensions' (Chinese colloquial phrases plus PDF/EPUB and English 'book'); score 4 would require natural terms still missing, and none are obvious.

5 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (whole-book explanation for non-readers) with distinct triggers like "拆书" and "压缩一本书", and the explicit NOT FOR list separates it from chapter summaries, papers, and reviews. This matches 'Clear niche with distinct triggers; minimal conflict risk'; overlap with generic summarization skills is explicitly fenced off, so score 4's 'minor overlap risk' understates it.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

lijigang/ljg-skills

Path

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