CtrlK
BlogDocsLog inGet started
Tessl Logo

ljg-book

Book reader that reconstructs a book as x -> f -> f(x): the problem it addresses, the author's central answer, and how that answer changes judgment or action. USE WHEN the user gives a book title, PDF, excerpt, or asks 拆书, 分析这本书, 这本书在讲什么, 压缩一本书, or book. Defaults to a saved org note. NOT FOR chapter summaries, framework audits, papers, single-idea deep dives, or field ranking.

76

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is lean, concrete, and well-sequenced with a genuine verification checklist — strong on conciseness, actionability, and workflow clarity. The main weakness is progressive disclosure: the routing table depends on `ReadingGuide.md`, which is not bundled, leaving a dangling reference alongside the correctly-signalized `references/template.org`.

Suggestions

Bundle or correct the `ReadingGuide.md` reference: the routing table marks it as required reading, but it is absent from `references/` (only `template.org` is present). Either ship the file or point the routing step at an existing path.

Verify every inline path reference resolves to a real bundle file (e.g. `ReadingGuide.md` vs. `references/template.org`) so the one-level-deep navigation is complete and unbroken.

DimensionReasoningScore

Conciseness

The body is dense and purposeful — it never explains concepts Claude already knows (no 'what a book is' padding) and every section addresses the fragile x→f→f(x) judgment. The apparent overlap between Gotchas and the Completion checklist is deliberate (failure-mode prevention vs. acceptance verification), not verbosity.

3 / 3

Actionability

Concrete, copy-paste-ready specifics for an instruction-only skill: file name `{YYYYMMDDTHHMMSS}--拆书-{书名}__book.org`, timestamp command `date +%Y%m%dT%H%M%S`, save path `~/Documents/notes/`, `#+begin_example` blocks ≤80 chars, 900–1600汉字 target, and an enumerated fixed top-level section structure. Per the rubric, absence of code is not penalized when guidance is this actionable.

3 / 3

Workflow Clarity

Clear sequence: routing table (input → required reading → output) → completion target → understanding-resistance scan → 6-step Quick Reference → explicit read-back verification (生成后读回确认 with 12 acceptance checks). The completion checklist functions as a validation/feedback checkpoint, and note-writing is non-destructive so no destructive-op cap applies.

3 / 3

Progressive Disclosure

SKILL.md is a well-organized overview and `references/template.org` is correctly signaled and one level deep — but the routing table repeatedly marks `ReadingGuide.md` as required reading ('查到可靠材料后读 `ReadingGuide.md`'), and that file is absent from the bundle (only `template.org` exists). A referenced path that does not exist is a broken navigation pointer, which keeps this below a 3.

2 / 3

Total

11

/

12

Passed

Description

100%Weight 40%Scale 1-3

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: it states a concrete three-part method with a defined output, gives an explicit USE WHEN clause with natural Chinese and English triggers, and adds a NOT FOR exclusion list that sharpens the niche. Third-person voice is maintained throughout.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: 'reconstructs a book as x -> f -> f(x): the problem it addresses, the author's central answer, and how that answer changes judgment or action' plus a concrete default output ('Defaults to a saved org note'). These are specific, defined sub-actions rather than vague domain hand-waving. Voice is third person ('reconstructs', 'addresses'), so no voice penalty applies.

3 / 3

Completeness

Explicitly answers both what ('reconstructs a book as x -> f -> f(x)...') and when with an explicit 'USE WHEN the user gives a book title, PDF, excerpt...' trigger clause, matching the score-3 anchor that requires both an explicit what and an explicit when.

3 / 3

Trigger Term Quality

The USE WHEN clause covers natural terms a user would actually say — 'book title, PDF, excerpt' plus colloquial Chinese triggers '拆书, 分析这本书, 这本书在讲什么, 压缩一本书, or book' — giving good coverage across both English and Chinese phrasings.

3 / 3

Distinctiveness Conflict Risk

A clear, narrow niche (book reconstruction into x→f→f(x) saved as an org note) with distinct triggers, sharpened by an explicit exclusion list ('NOT FOR chapter summaries, framework audits, papers, single-idea deep dives, or field ranking') that makes conflict with adjacent skills unlikely.

3 / 3

Total

12

/

12

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.

Validation15 / 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
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.