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

72%

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 ./plugin-variants/gbrain-daily/skills/strategic-reading/SKILL.md

The canonical home for this skill is strategic-reading in garrytan/gbrain

SKILL.md
Quality
Evals
Security

Quality

Content

67%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-structured, mostly lean instruction skill: concrete output template, clearly sequenced five-phase workflow with explicit error-recovery, and useful negative-space routing ('What this skill is NOT'). The main costs are three contentless boilerplate sections that exist only to satisfy a conformance test, and a few process steps that defer to unspecified external flows rather than being self-contained.

Suggestions

Remove or merge the 'Contract', 'Output Format', and 'Anti-Patterns' stub sections — they carry no instructions and exist only for a conformance test; fold any real requirements into existing sections.

Add an explicit pre-write validation step in Phase 5 (e.g., verify every recommendation cites the source and quotes number 5-10) to close the quality-bar feedback loop.

Inline the minimal 'put_page' standard CLI flow (or a one-line command example) so the final write step is executable without external context.

DimensionReasoningScore

Conciseness

Most of the body is lean and assumes competence — the process tree, output template, and quality bar carry real information with no padding about concepts Claude already knows. However, the 'Contract', 'Output Format', and 'Anti-Patterns' sections are contentless boilerplate ('The full behavior contract is documented in the body sections above; this section exists for the conformance test'), which is more than a minor trim job — the body could be tightened by removing or merging them.

3 / 5

Actionability

Guidance is concrete for an instruction-only skill: a full brain page template with named sections, triage thresholds ('Read first 2000 chars of each chapter'), concrete commands ('pdftotext -layout', 'gbrain write-request <request_id>'), and specific error handling ('revision_conflict or write_pending (exit 10)'). Not anchor 5 because key steps defer to unstated external knowledge — 'put_page via the standard CLI flow', EPUB extraction 'see book-mirror SKILL.md', and 'render to PDF via skills/brain-pdf' are not self-contained.

4 / 5

Workflow Clarity

The five phases (ingest → triage → deep read → synthesize → write) are clearly sequenced with decision rules (HIGH full reads, MEDIUM partial, LOW skipped), and 'When it fails' provides a real feedback loop (re-read and merge, or poll the write-request). Not anchor 5 because there is no explicit validation step verifying the output against the quality bar (e.g., checking every recommendation cites the source) before writing the page.

4 / 5

Progressive Disclosure

The body is well organized with clear section headers, an appropriately-inlined output template (~40 lines of core content), and clearly signaled one-level references to sibling skills and conventions via markdown links; no bundle files exist (references/, scripts/, assets/ absent) so nothing is nested. Not anchor 5 because the three conformance-test stub sections add navigational noise, and several references (../conventions/quality.md, ../_brain-filing-rules.md, skills/book-mirror/SKILL.md) are external to the skill and unverifiable from the bundle itself.

4 / 5

Total

15

/

20

Passed

Description

66%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 in third person that names its niche, inputs, and output shape, with an explicit negative boundary. Its main weakness is the missing explicit 'Use when' trigger guidance within the description text itself, and a few natural trigger phrases that live only in the frontmatter triggers list.

Suggestions

Append an explicit trigger clause to the description, e.g. 'Use when the user asks to read a source through the lens of a specific problem, apply a book/article to their situation, or extract a playbook from a text.'

Fold one or two of the frontmatter trigger phrases ('apply this to my problem', 'what can I learn from this about') into the description so natural user phrasings surface during skill matching.

Briefly differentiate from sibling analysis skills (e.g., whole-life book personalization) to reduce residual overlap risk.

DimensionReasoningScore

Specificity

The description names several concrete actions — 'Read a book, article, transcript, or case study through the lens of a specific strategic problem', 'Produces an applied playbook that maps the source onto the problem', 'gives short/medium/long-term recommendations' — with clear input types. It falls short of anchor 5 because it omits parts of the actual output scope (e.g., counter-tactics, direct quotes, brain page writing) and uses third person correctly throughout.

4 / 5

Completeness

The 'what' is clear and concrete (applied playbook with short/medium/long-term recommendations), but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description — only the negative boundary 'NOT for general book summaries', which weakly implies when. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3; the separate frontmatter when_to_use field is outside the evaluated description text.

3 / 5

Trigger Term Quality

Natural terms a user would say are present: 'book', 'article', 'transcript', 'case study', 'strategic problem', 'through the lens of', 'playbook', 'recommendations'. Not anchor 5 because common phrasings users actually say — 'apply this to my problem', 'what can I learn from this', 'extract a playbook from' — exist in the frontmatter triggers list but not in the description itself.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — problem-focused applied analysis, explicitly demarcated by 'NOT for general book summaries' — so conflict with generic summarization skills is low. Not anchor 5 because the description itself does not distinguish this from closely related sibling skills (e.g., personalized-but-not-problem-focused book analysis), leaving minor overlap risk.

4 / 5

Total

15

/

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

plugin-variants/gbrain-daily/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.