CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

grasp

Something in play — code, a document, a result — the user can't follow yet or nods along to unsure: they can then say their understanding serves their purpose, on a map checked with them.

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

42%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 an ambitious formal contract whose operational core — a checked map of understanding, rounds grounded in cited material, person-only closure — is sound and even elegant, but it is buried in ~390 lines of Lean scaffolding that duplicates the prose rules several times over. The executable guidance that exists is specific yet delivered without a single worked example, and the whole formal apparatus should live in a reference file rather than the main body.

Suggestions

Move the Lean block to references/contract.md (or similar) and keep SKILL.md to the operational prose: activation conditions, the round/map structure, the verification rules, and a pointer to the formalism for occasions that need it.

Add one worked example — a short sample target, the first-round map with 2-3 aspects, a fact with its cited material, and the person's reading — so the round format is copy-paste-imagined rather than inferred from a 500-word sentence.

De-duplicate the repeated judgments (acknowledgment-is-not-a-reading, only-a-person-closes, no-recording) by stating each once and cross-referencing, and break the `.present` grounding entry into discrete, scannable rules.

DimensionReasoningScore

Conciseness

The body is ~430 lines, of which roughly 390 are an inlined Lean 4 formal block whose axiom doc comments repeatedly restate judgments that also appear in FLOW, MORPHISM, TOOL GROUNDING, and the Rules section (e.g. "an acknowledgment of your explanation is acceptance, not the person's own reading" appears at least four times). Anchor 2 fits: several padded and redundant sections; it is not anchor 1 because it does not explain concepts Claude already knows — the redundancy is bespoke rather than filler — and not anchor 3 because the duplication is pervasive, not occasional.

2 / 5

Actionability

There is genuinely specific guidance — "cite concrete locations in the target — file and line where it is code", checks write to "a scratch space outside the target's tree", contradictions must show "their words quoted; the narrowest material... never your own explanation" — but no worked example or template of an actual round or map, and the central instructions are compressed into a single ~500-word run-on sentence in the `.present` entry. Anchor 3 fits: some concrete guidance but incomplete, with key details (what output looks like) missing.

3 / 5

Workflow Clarity

The sequence (gather → check → map → present → fuse → close) is present in the FLOW and MORPHISM comments and encoded in `grasp`/`start`, and a feedback loop exists (checks run before rounds, results return through `consult`), but it is implicit: the reader must reverse-engineer the Lean formalism, and no explicit ordered steps or checkpoints are laid out for the executor. Anchor 3 fits; not 2 (the sequence is complete, not gappy) and not 4 (checkpoints are implicit rather than "most present").

3 / 5

Progressive Disclosure

The body has clear section headers and one well-signaled, one-level-deep reference (`references/round-composition.md`, a real file with explicit when-to-read conditions), but roughly 90% of the content — the Lean formal contract — is inlined in SKILL.md where it belongs in a separate reference file. Anchor 3's "content that should be separate is inline" matches exactly; not 2 because the structure is not minimal and the reference is not buried, and not 4 because the inlining is wholesale rather than a minor gap.

3 / 5

Total

11

/

20

Passed

Description

36%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 gestures at a genuinely interesting niche — verified comprehension of a target the user can't yet follow — but expresses it in abstract, philosophical language. It names target types and a natural trigger phrase ("can't follow"), yet provides no concrete actions and no explicit "Use when..." trigger clause, leaving both what and when only partially legible.

Suggestions

State the concrete action in plain verbs, e.g. "Builds a map of what the user does and doesn't understand about a target in context (code, a document, a result), checks each claimed understanding against the target's material, and runs verification checks where reachable."

Add an explicit trigger clause: "Use when the user says they can't follow, don't understand, or are unsure they truly understand something already in play — code, a document, a result — and want verified comprehension rather than a one-off explanation."

Drop the hedged, indirect phrasing ("nods along to unsure") in favor of the direct words users actually say ("I don't get this", "can you walk me through it", "does this actually do what I think")

DimensionReasoningScore

Specificity

The description names the domain ("code, a document, a result") but the actions are minimal and abstract — "a map checked with them" is metaphorical rather than a concrete verb like extract, verify, or render. It is not entirely vague (anchor 1) because target types and an action sketch are present, but it lacks the 1-2 concrete actions needed for anchor 3.

2 / 5

Completeness

The "what" ("they can then say their understanding serves their purpose, on a map checked with them") is vague, and the "when" ("can't follow yet or nods along to unsure") is only weakly implied with no explicit 'Use when...' clause. Anchor 2 fits best: a vague what with a weakly implied when; anchor 3 does not fit because the what is not clear.

2 / 5

Trigger Term Quality

"can't follow", "code", "document", and "a result" are natural terms a user might say when needing this skill, but common variations like "explain", "walk me through", or "I don't understand this" are missing. Coverage is moderate, matching anchor 3 rather than anchor 2 (which has only one or two generic keywords) or anchor 4 (good coverage with few missing).

3 / 5

Distinctiveness Conflict Risk

The comprehension-verification framing ("the user can't follow yet... their understanding serves their purpose") carves a niche distinct from file-manipulation skills, but the abstract wording could still overlap with generic explanation/teaching behavior. Anchor 3 fits; not 2 (the comprehension framing is not broad like "helps with document files") and not 4 (no distinct concrete triggers are given).

3 / 5

Total

10

/

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

jongwony/epistemic-protocols

Path

katalepsis/skills/grasp/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.