book-to-skill

Converts books, documentation folders, and source collections (PDF, EPUB, DOCX, HTML, Markdown, RST, AsciiDoc, RTF, MOBI/AZW) into structured agent skills — extracting named frameworks, principles, techniques, and anti-patterns into a master SKILL.md plus on-demand chapter files, a glossary, a patterns file, and a decision cheatsheet. Use when the user wants to study a document with an agent, apply an author's frameworks while working, turn internal docs or standards into a reusable knowledge base, or package a compiled book skill as a claude-skills plugin.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

92%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-engineered skill body: copy-paste-ready run block, an eleven-step workflow with explicit validation gates and feedback loops, and clean one-level-deep progressive disclosure backed by real bundle files. The only drag is mild motivational prose in the intro and Philosophy sections.

Suggestions

Trim the opening narrative and the 'workarounds all fail' paragraph; the Philosophy section can keep its named principles ('Extract structure, not summaries', 'Preserve the author's precision') and drop the surrounding justification prose to push conciseness toward a 5.

The intro paragraph 'A book is crystallized expertise: frameworks, principles, techniques that took years to develop. Read once, forgotten.' is persuasive writing aimed at the user rather than instruction for Claude — consider cutting or moving it to a README.

Dimension	Reasoning	Score
Conciseness	Largely lean with efficient tables and concrete commands, but the opening narrative ('A book is crystallized expertise ... The workarounds all fail — PDF search returns page numbers instead of answers') and parts of the Philosophy section are motivational padding Claude does not need — efficient with minor over-explanation rather than the level-5 'every token earns its place'.	4 / 5
Actionability	The 'Run it' block is copy-paste ready and stated to work end-to-end with real variables, the validator-finding table maps rules to meaning, and the forcing-question library gives recommended answers — concrete executable guidance covering the common conversion case.	5 / 5
Workflow Clarity	Steps 0–11 are clearly sequenced with explicit validation checkpoints ('wait for approval' at 2.5, 'Validate. Errors block.' at 9.5) and a feedback loop ('Fix and re-run; never rewrite around a finding'), satisfying the destructive/batch feedback-loop requirement.	5 / 5
Progressive Disclosure	SKILL.md is an overview with one-level-deep, clearly signaled references ('the full step-by-step procedure ... is in references/conversion_workflow.md'), a dedicated References section listing all five files, and the referenced bundle files (references/, scripts/, assets/) all exist on disk — easy navigation with no nested-reference chains.	5 / 5
	Total	19 / 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.

An exemplary description: concrete capabilities, enumerated input formats, explicit 'Use when' triggers covering several natural phrasings, and a distinct niche. Both what and when are answered clearly and specifically.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions with comprehensive coverage: 'extracting named frameworks, principles, techniques, and anti-patterns into a master SKILL.md plus on-demand chapter files, a glossary, a patterns file, and a decision cheatsheet' and 'package a compiled book skill as a claude-skills plugin' — not the level 4 'minor gaps' anchor.	5 / 5
Completeness	Explicitly answers both what ('Converts ... into structured agent skills — extracting ... into a master SKILL.md plus ...') and when ('Use when the user wants to study a document with an agent, apply an author's frameworks while working ...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Comprehensive natural-term coverage with synonyms and file extensions: 'PDF, EPUB, DOCX, HTML, Markdown, RST, AsciiDoc, RTF, MOBI/AZW' plus natural triggers like 'study a document with an agent', 'apply an author's frameworks while working', 'turn internal docs or standards into a reusable knowledge base'.	5 / 5
Distinctiveness Conflict Risk	Clear niche (book/document-to-skill conversion) with distinct triggers, enumerated file formats, and a plugin-packaging use case; minimal overlap with other skills.	5 / 5
	Total	20 / 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: alirezarezvani/claude-skills
Path: engineering/book-to-skill/skills/book-to-skill/SKILL.md
Commit: 19392f7

Reviewed: ~6 hours 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.