CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deepread

Use when the user asks to deeply read a book, article, PDF, or document set; extract claims and evidence; build a knowledge map; or learn through Feynman explanation and recall. Covers quick, deep, map, Feynman, and whole-book reading modes.

73

Quality

92%

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

The canonical home for this skill is deepread in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

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.

The body is a lean, highly actionable instruction set: a five-mode selection table, a seven-step workflow with explicit validation and a learning feedback loop, exact output schemas (ledger fields, confidence labels, output template), and clean offloading of detailed map/Feynman procedures to two real one-level-deep reference files. Its only flaw is mild redundancy between the trigger section, Anti-Patterns, and Cross-References.

DimensionReasoningScore

Conciseness

The body is dense and operational — mode table, field-level ledger spec, exact confidence labels — with zero padding or explanations of concepts Claude already knows. Minor redundancy keeps it below the 5 anchor: the 'Use This Skill When' bullets restate the frontmatter description, Cross-References repeats the earlier 'Do not use this skill for discovering sources' line, and several Anti-Patterns (e.g. 'Do not quote data without its unit, time range, population...') restate the step-5 checks. It is clearly above the 3 anchor, which requires unnecessary explanation.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: a mode-selection table with deliverables, atomic-unit definitions for the argument tree, an exact evidence-ledger field table, four fixed confidence labels, a Good/Bad central-claim example, and a numbered 9-item default output template. Per the rubric's scoring note, absence of code is not penalized when the guidance is this concrete, so it meets the 5 anchor ('specific examples cover the common cases') rather than the 4 anchor with minor gaps.

5 / 5

Workflow Clarity

A clear 7-step sequence with explicit validation checkpoints — step 1 verifies extraction usability and instructs stopping claims that depend on missing material, step 5 runs a concrete reasoning checklist — and a genuine feedback loop in step 7 (closed-book explanation, compare to ledger, locate the first missing link, repair only that gap, transfer question). This matches the 5 anchor's 'explicit validation steps; feedback loops', not the 4 anchor where checkpoints are only mostly present; no destructive or batch operations apply.

5 / 5

Progressive Disclosure

SKILL.md is a clear overview that defers detailed procedures to two real, well-signaled, one-level-deep references: `references/knowledge-map.md` (pointed to in the mode table) and `references/feynman.md` (pointed to in the mode table and step 7); both files exist and contain no nested references. Detailed mode procedures are appropriately split out of the main body, matching the 5 anchor's clean structure and navigation.

5 / 5

Total

19

/

20

Passed

Description

88%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 description with an explicit 'Use when' trigger clause and multiple concrete capabilities that clearly bound the skill's reading-and-learning niche. Its only weakness is that a few natural trigger phrases (close reading, mind map) live in the body rather than the description, and generic 'PDF'/'document' phrasing creates minor overlap with summarization skills.

Suggestions

Fold the natural synonyms users actually say — e.g. 'close reading' and 'mind map' — into the description so the frontmatter alone matches those triggers.

Add a brief disambiguator in the description (e.g. 'for comprehension and recall, not conventional summaries or source discovery') to reduce overlap with summarization/research skills on generic 'read this PDF' requests.

DimensionReasoningScore

Specificity

The description lists multiple concrete, distinct capabilities — "extract claims and evidence", "build a knowledge map", "learn through Feynman explanation and recall" — plus a full mode enumeration ("quick, deep, map, Feynman, and whole-book reading modes"). This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage'; nothing is generic like 'helps with documents', so it is not the 4 anchor, which requires minor coverage gaps.

5 / 5

Completeness

It explicitly answers both questions with concrete trigger phrases: "Use when the user asks to deeply read a book, article, PDF, or document set; extract claims and evidence; build a knowledge map; or learn through Feynman explanation and recall". Both what and when are explicit and specific, matching the 5 anchor rather than the 4 anchor where the 'when' could be more explicit.

5 / 5

Trigger Term Quality

Natural terms are well covered: "deeply read a book, article, PDF, or document set", "knowledge map", "Feynman explanation", "claims and evidence", "recall". A few natural phrases a user would plausibly say — e.g. "close reading" or "mind map" (both appear only in the body, not the description) — are missing, which fits the 4 anchor ('Good keyword coverage; a few natural terms missing') rather than the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The deep-reading/argument-reconstruction/learning niche is clear with distinct triggers ("Feynman explanation", "knowledge map"), but generic file triggers like "PDF" or "document set" carry minor overlap risk with summarization or extraction skills when a user asks to 'read a PDF'. This fits 'Mostly distinct; minor overlap risk with closely related skills' better than the 5 anchor's minimal-conflict niche, and far better than the 3 anchor's broad overlap.

4 / 5

Total

18

/

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

research/deepread/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.