CtrlK
BlogDocsLog inGet started
Tessl Logo

grasp

Something in play — code, a document, a result, quotable in context — needs to be actually understood; the user can't follow it yet or nods along unsure: verify understanding step by step.

40

Quality

51%

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

Fix and improve this skill with Tessl

tessl review fix ./katalepsis/skills/grasp/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

36%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 contains a genuinely specified protocol, but it is buried inside a monolithic Lean 4 formalization that consumes the vast majority of the token budget while duplicating the prose rules, and no worked example shows what a round, probe, or trace actually looks like. An executor must reverse-engineer the operational sequence from type-theoretic definitions.

Suggestions

Move the Lean formalization to a reference file (e.g. references/formal-model.md) and keep only the FLOW summary, morphism outline, and markdown rules in SKILL.md — this would address both the conciseness padding and the inlined-content progressive-disclosure problem at once.

Add one worked example round: a sample target, the three derived entry labels, a concrete scenario probe with its Qc/Qs form, and the resulting trace — giving executors copy-adaptable concrete patterns instead of abstract type definitions.

Restate the operational sequence as numbered plain-language steps with explicit checkpoints (entry selection → probe → adjudication → coverage → closure, including what happens on a missed or contradicting answer), so the workflow doesn't require decoding settle/gateFor/advance.

DimensionReasoningScore

Conciseness

The body is ~680 lines dominated by a ~630-line Lean 4 formalization whose dense, self-referential notation restates what the prose Rules section already encodes (e.g. "Task priority and answer handling are defined below, in settle and advance respectively") — noticeably padded relative to what a working protocol needs, though the outer markdown sections are reasonably tight and it doesn't explain concepts Claude already knows.

2 / 5

Actionability

Some concrete guidance exists — "Derive up to three first-turn labels", the named intents (Orientation, Rationale, Impact, Approval, Transfer), "cite concrete locations in the target — file and line where it is code", the Intensity table, and the pointer to references/round-composition.md — but there are no worked examples of an entry label, probe, or round, and actual execution depends on decoding Lean definitions, leaving the guidance incomplete.

3 / 5

Workflow Clarity

A rough sequence is present (the FLOW comment "Orient silently → present intent-scented entries and route adequacy → Stop. Fuse the next utterance → ... → advance → present the resulting Round", plus the grounding Op list), but the real transition logic lives in opaque Lean functions (settle, gateFor, advance) with no plain-language numbered steps, checkpoints, or error-recovery loops an executor can follow — many gaps, steps poorly defined.

2 / 5

Progressive Disclosure

The single bundle reference (references/round-composition.md, verified to exist) is well-signaled and one level deep ("Read references/round-composition.md before composing when..."), and the body has headers, a table, and bullets — but the ~630-line Lean formalization is exactly the content that belongs in a separate reference file and is inlined monolithically, so organization is only partial.

3 / 5

Total

10

/

20

Passed

Description

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

The description names a genuine niche (verifying the user's own comprehension of an in-context target) and states an explicit trigger condition, but it delivers almost no concrete capabilities and omits the natural vocabulary users would use to invoke it. It reads as an evocative characterization rather than a capability statement.

Suggestions

List 2-3 concrete actions after the domain, e.g. "Derives intent-scented entry points, poses scenario-based comprehension probes, and certifies a verified-understanding trace" — this would lift specificity from anchor 2 to anchor 4.

Add natural trigger synonyms users would actually say, such as "Use when the user asks to explain, walk through, or help them understand a result they can't follow".

State the what/when pair explicitly in third person: what the skill does ("Guides the user through step-by-step verification of their understanding") followed by a "Use when..." clause, instead of merging both into one descriptive sentence.

DimensionReasoningScore

Specificity

The domain is named ("code, a document, a result, quotable in context") but the only action stated is the generic "verify understanding step by step" — no concrete actions such as probing, tracing, or citing locations are listed, matching the 'names the domain but actions are minimal or generic' anchor rather than the 1-2-concrete-actions level.

2 / 5

Completeness

The 'when' is fairly explicit (the user can't follow it or nods along unsure), but the 'what' is vague — a single generic action with no concrete capability list — which keeps it below the level where both what and when are solidly present.

3 / 5

Trigger Term Quality

It includes natural phrases a user might echo ("can't follow it yet", "nods along unsure") but misses common variations users actually say — "explain", "walk me through", "help me understand" — so keyword coverage is partial rather than good.

3 / 5

Distinctiveness Conflict Risk

The target domain spans essentially any artifact in context (code, documents, results) and "verify understanding" overlaps with general explanation and teaching behaviors; the user-can't-follow framing gives it a stated niche but broad overlap remains with similar skills.

3 / 5

Total

11

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (682 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
jongwony/epistemic-protocols
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.