CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

sketch

Something has to be made that the user cannot describe but would recognize on sight: they can then point at a version they met and say 'this is the form, for this purpose', seeing where each is.

Quality

40%

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 ./hypotyposis/skills/sketch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

23%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 rigorous, internally consistent formal contract whose workflow is more precisely specified than most skills, but it is delivered at extreme token cost and in a register that buries the executable procedure. A reader gets the contract's guarantees yet almost no concrete, copy-followable guidance for producing an actual round, and nearly all of it sits inline in SKILL.md instead of in the references layer.

Suggestions

Move the Lean formal block (FLOW, MORPHISM, the namespace development) into references/ (e.g. references/contract.lean) and keep in SKILL.md a plain-language statement of the protocol's core loop and the occasions on which the contract should be loaded, cutting the always-loaded body by an order of magnitude.

Add a worked example — one full round showing the intent relay, two or three concrete versions, the standing, and the opening — so the abstract contract is anchored to something executable.

Restate the core sequence as a short numbered procedure in everyday language (check activation → relay intent → produce → present round → read the turn → carry out asks → branch) before any formal vocabulary appears, so the workflow does not have to be mined from the Lean development.

DimensionReasoningScore

Conciseness

The body is ~43KB (roughly 11k tokens) loaded on every activation, dominated by a Lean 4 formal apparatus (Turn/Cite/Coord/Occ, structural recursion, classical choice) that re-encodes ordinary conversational state management, with single doc comments running past 100 words (e.g. the notActivated, Reaches, and ClosingSupported axioms). Though the material is original rather than explanation of known concepts, the magnitude and density of the padding place this at anchor 1 ('severely verbose… heavily padded') rather than 2.

1 / 5

Actionability

There are no commands, tools, or worked examples of what a relay, version, or round looks like in practice; guidance like "Compose each round so the reader can act without reassembly" and "realize each in a medium in which the qualities the person's judgment concerns can be encountered" stays at the high-hint level. The TOOL GROUNDING entries (e.g. the intentRelay and present strings) are semi-operational checklists, which keeps this above anchor 1 ('only describes rather than instructs'), but the specific steps to execute are missing — anchor 2.

2 / 5

Workflow Clarity

A real sequence is present — FLOW fixes activation check → relay → gather → produce → round → per-utterance branch → closing, and checkpoints are explicit in the contract (every version checked against the reference before it is shown, failed writes recorded with reasons, the record built only after the closing turn's asks are observed). But the sequence is expressed in formalism dense enough that an executor must reverse-engineer it, matching anchor 3 (sequence present, but its checkpoints and steps are implicit in the formalism rather than clearly operationalized); it is not 4 because 'clear sequence' is untenable for this readability.

3 / 5

Progressive Disclosure

The one reference (references/round-composition.md, verified present) is clearly signaled, one level deep, and occasion-bound, but ~550 lines of formal contract are inlined monolithically in SKILL.md where the rubric expects an overview with detail split out. This matches anchor 2 ('content that clearly belongs in separate files is inlined'); it is not 3 because the inlined monolith, not mere organization gaps, is the dominant structure.

2 / 5

Total

8

/

20

Passed

Description

28%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 is written in third person and captures a genuinely distinctive niche, but it describes a philosophical scenario rather than what the skill does or when to invoke it. It reads as prose from the body of the skill, not as a trigger-facing description, and would rarely be matched by a user's actual words.

Suggestions

State the skill's concrete actions in third person (e.g. 'Produces and revises concrete versions of an undesigned artifact — figures, pages, mockups — until the user recognizes one as the right form'), so the 'what' is explicit rather than implied by the scenario.

Add an explicit trigger clause with natural terms: "Use when the user asks for something they can't describe but would know on sight — a sketch, mockup, prototype, look-and-feel, or 'I'll know it when I see it' work."

Front-load the natural keywords (sketch, mockup, prototype, iteration by recognition) in the opening sentence so description-based triggering can match them.

DimensionReasoningScore

Specificity

Phrases like "something has to be made that the user cannot describe but would recognize on sight" and "point at a version they met" describe a scenario without naming any action the skill performs (no 'sketches', 'generates', 'presents versions'). This matches anchor 2 (domain named, actions minimal or generic): the domain of form-finding-by-recognition is conveyed, but no concrete capability is stated. It is not 1 because the scenario is concrete and differentiated, and not 3 because no 1-2 skill actions are actually listed.

2 / 5

Completeness

The 'when' is explicit ("that the user cannot describe but would recognize on sight") but the 'what' is only implied — nothing states the AI produces and iterates concrete versions. This matches anchor 2 (only 'when' present without a clear 'what'); the missing explicit 'Use when...' trigger guidance caps it at 3, and the vague 'what' holds it at 2.

2 / 5

Trigger Term Quality

"Recognize on sight" is the only fragment matching what a user would naturally say; the phrases users actually use for this need — "sketch", "prototype", "mockup", "I'll know it when I see it" (the last appears only in the body, not the description) — are absent. This lands at anchor 2 (one or two generic keywords, missing the natural phrases), above 1 only because 'recognize on sight' is genuine user idiom.

2 / 5

Distinctiveness Conflict Risk

The "cannot describe but would recognize" niche is conceptually distinct from generic creation skills, but the description is abstract enough to overlap with any design/iteration skill and offers no concrete trigger phrases to separate it. Anchor 3 (somewhat specific but could still overlap with similar skills); not 4 because no distinct triggers are stated.

3 / 5

Total

9

/

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 (582 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

jongwony/epistemic-protocols

Path

hypotyposis/skills/sketch/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.