CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

77

Quality

97%

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

96%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.

An exemplary skill body: lean, tables where prose would bloat, executable commands with real gates, and a well-structured 11-step workflow with validation and approval checkpoints. The single gap is that the assets/ bundle files are invisible from the top-level index, requiring a hop through the workflow reference to discover the templates.

Suggestions

Add an 'assets/' entry (chapter_template.md, cheatsheet_template.md, master_skill_template.md) to the References section so every bundle file is discoverable from SKILL.md in one hop.

In the Step 6-8 row of the steps table, link the assets templates directly so the chapter-file writing step points at its templates without routing through references/conversion_workflow.md.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence throughout: no explanations of known concepts, dense tables for outputs/modes/steps/validator findings, and prose limited to skill-specific rationale and hard rules. Every token earns its place, matching the lean 5 anchor rather than the 4 anchor, which requires trimmable over-explanation.

5 / 5

Actionability

The 'Run it' block gives copy-paste-ready bash with real script paths and flags covering extraction, pre-flight estimation, validation gating, and plugin packaging, and explicitly guarantees the block works as written once two variables are filled. The only unscripted step (3, generation) is the agent's own synthesis work, delegated to templates and the workflow reference by design.

5 / 5

Workflow Clarity

The 11-step sequence is explicit with numbered checkpoints, two hard gates (Step 2.5 'wait for approval', Step 9.5 'errors block'), a feedback loop ('fix and re-run; never rewrite around a finding'), a pipeline diagram, mode routing, and a forcing-question checklist. This matches the 5 anchor's explicit validation, error-recovery loops, and checklists for complex processes.

5 / 5

Progressive Disclosure

All five reference files exist, are one level deep, and are clearly signaled with per-file descriptions ('Read it before running a conversion'). However, the bundle's assets/ templates (chapter_template.md, cheatsheet_template.md, master_skill_template.md) are never mentioned in SKILL.md and are only discoverable through references/conversion_workflow.md, a minor organization gap that matches the 4 anchor rather than fully easy navigation at 5.

4 / 5

Total

19

/

20

Passed

Description

96%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 model description: third-person voice, comprehensive and concrete on both inputs and outputs, with an explicit multi-scenario 'Use when' trigger clause. The only residual risk is mild overlap with sibling knowledge-base and summarization skills on generic 'study this document' requests.

DimensionReasoningScore

Specificity

The description enumerates input formats (PDF, EPUB, DOCX, HTML, Markdown, RST, AsciiDoc, RTF, MOBI/AZW), the extraction targets (named frameworks, principles, techniques, anti-patterns), and every output artifact (master SKILL.md, chapter files, glossary, patterns file, decision cheatsheet). This is comprehensive coverage with multiple concrete actions, matching the 5 anchor; it exceeds 4 because there are no gaps in the action inventory.

5 / 5

Completeness

The 'what' is fully specified (input formats, extraction activity, all output files) and the 'when' is an explicit 'Use when...' clause with four concrete trigger scenarios. Both are answered explicitly with concrete trigger phrases, matching the 5 anchor exactly; it is not 4 because the when-clause is specific, not merely present.

5 / 5

Trigger Term Quality

Natural user phrases ('study a document with an agent', 'turn internal docs or standards into a reusable knowledge base', 'package a compiled book skill') appear alongside file extensions (PDF, EPUB, DOCX, MOBI/AZW) and synonyms (books, docs, documentation, source collections). Coverage of natural terms including extensions matches the 5 anchor rather than 4, where a few natural terms would be missing.

5 / 5

Distinctiveness Conflict Risk

The niche (compiling written sources into agent skills) is distinct from generic document processing, but 'study a document with an agent' could also fire for simple summarize/read requests, and closely related skills in the same repo (write-a-skill, llm-wiki) cover adjacent triggers. This matches 'mostly distinct; minor overlap risk with closely related skills' (4) rather than the minimal-conflict 5 anchor.

4 / 5

Total

19

/

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

alirezarezvani/claude-skills

Path

engineering/book-to-skill/skills/book-to-skill/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.