CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

strategic-reading

Read a book, article, transcript, or case study through the lens of a specific strategic problem you're facing. Produces an applied playbook that maps the source onto the problem and gives short/medium/long-term recommendations. NOT for general book summaries.

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/strategic-reading/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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-constructed instruction-only skill body: lean, concrete, and sequenced, with real error-recovery guidance and a fully specified output artifact. The residual gaps are minor — implicit validation checkpoints, an unspecified CLI write command, and three stub sections that exist only to satisfy a conformance test.

Suggestions

Replace "put_page via the standard CLI flow" with the actual command(s) so Phase 5 is fully executable without consulting other skills.

Fold the three conformance-test stub sections (Contract, Output Format, Anti-Patterns) into a single brief note or the body sections they point to, removing the duplicated pointer text.

Add one explicit mid-process checkpoint, e.g. "Before Phase 3, confirm the strategic problem is specific enough to triage against; if vague, ask the user" — to make validation as explicit as the failure handling.

DimensionReasoningScore

Conciseness

The body is dense and purposeful — a concrete output template, a five-phase process tree, and a quality bar with a worked example — with only minor trimmable material, matching the 4 anchor ("efficient; minor instances of over-explanation"): the three stub sections ("Contract", "Output Format", "Anti-Patterns") that exist only "for the conformance test" and rhetorical flourishes ("devastatingly relevant", "reading with a mission") add tokens without adding guidance.

4 / 5

Actionability

Concrete, executable guidance dominates: "pdftotext -layout", "Read first 2000 chars of each chapter", HIGH/MEDIUM/LOW triage rules, explicit output paths ("projects/<slug>/playbook.md"), and a full markdown template for the artifact; it falls short of the 5 anchor only on minor gaps such as "put_page via the standard CLI flow" (no actual command given) and EPUB extraction being delegated to another skill's SKILL.md.

4 / 5

Workflow Clarity

The five phases are clearly sequenced with concrete parameters per phase, and the "When it fails" section provides genuine feedback loops ("revision_conflict or write_pending (exit 10): re-read and merge, or poll gbrain write-request <request_id>"); a point below the 5 anchor because mid-process checkpoints (e.g., confirming the strategic problem is well-defined before deep reading, or verifying the written page) are implicit rather than explicit validation steps.

4 / 5

Progressive Disclosure

The body is well-organized with clear section headers and clearly signaled one-level-deep cross-references ([conventions/quality.md], [_brain-filing-rules.md], book-mirror and perplexity-research SKILL.mds); no bundle files exist in this skill (references/, scripts/, assets/ are absent), and the inline brain-page template is core content that belongs in SKILL.md, so this matches the 4 anchor — the conformance-test stub sections at the end are minor organizational clutter that keeps it from a 5.

4 / 5

Total

16

/

20

Passed

Description

70%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, specific description with a clear niche and an explicit disambiguation boundary, weakened primarily by the absence of positive trigger guidance ("use when...") and an incidental second-person phrase that triggers the voice penalty. Adding a positive use-when clause would likely lift completeness and trigger-term quality.

Suggestions

Add an explicit positive trigger clause, e.g. "Use when the user supplies a long text plus a specific problem to solve, or asks to read something 'through the lens of' a current fight, negotiation, or decision."

Remove the second-person phrasing ("a specific strategic problem you're facing") in favor of third person ("a specific strategic problem the user is facing") to avoid the voice penalty.

Consider naming common source formats users would mention (EPUB, PDF, podcast transcript) to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

The description enumerates concrete inputs ("book, article, transcript, or case study") and several specific actions ("read... through the lens of a specific strategic problem", "produces an applied playbook", "gives short/medium/long-term recommendations"), which is comprehensive coverage comparable to the 5 anchor; however, the second-person phrasing "a specific strategic problem you're facing" incurs the rubric's mandatory 1-point voice penalty, bringing the score to 4.

4 / 5

Completeness

The "what" is clear and concrete, but the "when" is only negatively implied via "NOT for general book summaries" — there is no positive "Use when..." clause or equivalent trigger guidance in the description, which the judging guidelines explicitly cap at 3.

3 / 5

Trigger Term Quality

Natural keywords like "book", "article", "transcript", "case study", "strategic problem", and "playbook" give good coverage of terms a user would plausibly say, matching the 4 anchor ("good keyword coverage; a few natural terms missing") — e.g., no mention of EPUB/PDF or phrases like "apply this to my situation" inside the description itself.

4 / 5

Distinctiveness Conflict Risk

The combination of a distinctive lens ("through the lens of a specific strategic problem") with an explicit negative boundary ("NOT for general book summaries") carves out a clear niche with minimal conflict risk, matching the 5 anchor; without the boundary statement it would risk overlap with generic summarization skills.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 3 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

skills/strategic-reading/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.