CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

preview

The user is about to commit to one of several directions they cannot judge from descriptions: they can then say what each means for their purpose, on what ground, and which one they take.

Quality

48%

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

Quality

Content

35%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 novel and internally consistent behavioral specification with explicit ordering constraints and discard-verification, but it buries that in a ~520-line Lean formalism restated multiple times with no concrete worked example. A reader must reconstruct both the procedure and the intended output shape from extremely dense abstract prose.

Suggestions

Cut the redundancy: keep either the FLOW comment or the MORPHISM comment — not both — and let the Lean definitions carry the rest; each removed restatement is hundreds of tokens that compete with session context.

Add one compact worked example to make the skill actionable: a sample spec relay, one short vignette probe per candidate, and a two-axis rendered map with cells and their footings, so 'narration', 'map row', and 'cell footing' have concrete referents.

Move the Lean formalization and/or the TOOL GROUNDING operation glossary into references/ (e.g. references/formal-spec.md, referenced from a short 'Contract' section), keeping SKILL.md as an overview with the protocol steps and rules.

DimensionReasoningScore

Conciseness

The ~550-line body restates the same protocol at least four times — the prose Definition paragraph, the FLOW comment, the MORPHISM comment, and the Lean definitions, plus a Core Principle section recap — and single strings run to hundreds of words (the `present` grounding entry alone is ~450 words of nested clauses). It avoids explaining known concepts, so it is above score 1, but the heavy redundancy and baroque run-on prose fit 'Noticeably verbose; several unnecessary explanations or padded sections' rather than score 3's 'mostly efficient'.

2 / 5

Actionability

For an instruction-only skill the guidance must still be concrete, yet there is not a single worked instance: no example vignette narration, no sample rendered map row, no example round or dialogue fragment. The Lean block is a formal specification whose judgments are explicitly 'black boxes... yours to make', i.e. pseudocode-grade specification rather than executable guidance, which fits 'Minimal concrete guidance; high-level hints but missing the specific steps to execute'; it is below score 3 because behavioral rules, however detailed, are never instantiated into something copy-adaptable.

2 / 5

Workflow Clarity

A real sequence exists (gather → relay_spec → instantiate → carry → present → fuse → constitute → harvest → cleanup → assemble) and validation checkpoints for the destructive discard step are explicit ('the verification step closing the same sequence — each path verified absent', 'harvest read before discard'), so it is above score 2. But the sequence is scattered across three redundant restatements (FLOW, MORPHISM, the `preview` definition) and expressed in dense 100+ word sentences, leaving the reader to reassemble it — fitting 'Steps listed but [clarity gaps]; sequence present but checkpoints missing or implicit' at score 3 rather than score 4's 'clear sequence'.

3 / 5

Progressive Disclosure

The one bundle file (references/round-composition.md) exists, is one level deep, and is clearly signaled with a concrete conditional trigger ('Read references/round-composition.md before composing when terminology must remain stable, wording must be carried unchanged...'), so it is above score 2. But the body is a monolithic wall of formal specification where large parts (the Lean block, TOOL GROUNDING) are inlined in SKILL.md rather than split out, fitting 'Some structure but could be better organized; content that should be separate is inline' at score 3 rather than score 4.

3 / 5

Total

10

/

20

Passed

Description

37%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 has an explicit and distinctive trigger condition, but it describes the situation and the person's outcome rather than what the skill does, and it contains almost none of the natural phrases a user would say when needing it. It reads as protocol formalism rather than a capability-and-trigger statement.

Suggestions

State the skill's concrete actions in the description, e.g. 'Builds cheap, disposable placeholder previews (narrated vignettes or temp-isolated mockups) of each candidate direction and presents a per-axis contrast map of what each future would rest on'.

Add an explicit trigger clause with natural user phrasings: 'Use when the user must choose between design directions, architecture forks, UX shapes, or plan branches and says they cannot tell the options apart from descriptions (e.g. "I'd have to see it", "what would each actually look like")'.

Keep the distinct pre-commitment framing but anchor it with synonyms users actually say — 'decide between options', 'compare approaches', 'pick a direction' — so it triggers reliably instead of competing with generic decision-support skills.

DimensionReasoningScore

Specificity

The description names the domain ('about to commit to one of several directions they cannot judge from descriptions') but never states what the skill actually does — building disposable placeholder previews, rendering a contrast map, discarding probes — only the person's end state: 'they can then say what each means for their purpose, on what ground, and which one they take'. This matches the anchor 'Names the domain but actions are minimal or generic'; it is above score 1 because the domain is concrete rather than pure abstraction, and below score 3 because no 1–2 concrete skill actions are listed.

2 / 5

Completeness

The 'when' is explicitly present as an equivalent trigger clause ('The user is about to commit to one of several directions they cannot judge from descriptions'), so the missing-'Use when' cap of 3 is not what binds here; what binds is that the 'what' is only weakly implied — the skill's actions (relay a reading, build placeholder probes, show a map, discard) never appear, so the description is the inverse of the score-3 anchor ('clear what, weak when'). It is below score 4 because a clear 'what' is missing, and above score 2 because the 'when' is explicit rather than absent.

3 / 5

Trigger Term Quality

Relevant keywords exist ('commit', 'directions', 'judge from descriptions') but the natural phrases a user would actually say — 'I can't decide between these options', 'what would each look like', 'compare approaches', 'I'd have to see it' — are absent. This fits 'One or two generic keywords; missing the natural phrases users say'; it is above score 1 (some domain terms are present) and below score 3 (no common variations or synonyms of user phrasing are included).

2 / 5

Distinctiveness Conflict Risk

The scenario ('cannot judge from descriptions', pre-commitment direction choice) is a genuinely narrow niche, but the abstract, scenario-shaped phrasing with no concrete trigger terms leaves it overlapping with generic decision-support or comparison skills. This fits 'Somewhat specific but could still overlap with similar skills'; below score 4 because the absence of distinct trigger phrases makes reliable discrimination unlikely, above score 2 because the domain is not broad.

3 / 5

Total

10

/

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

Warning

Total

15

/

16

Passed

Repository

jongwony/epistemic-protocols

Path

proplasma/skills/preview/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.