CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ground

A framework, analogy, or earlier design is carried to a case, or an abstraction tested: the user can say what carries each conclusion, what would break it, and if it holds, is blocked, or is open.

Quality

56%

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 ./analogia/skills/ground/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 skill encodes an intricate but genuinely worked-out reasoning protocol, yet buries it in a ~560-line Lean formalization plus several prose layers that restate the same rules, with no worked example to make it actionable. The bundle navigation is mostly sound, but the main body violates its own progressive-disclosure principle by inlining the formal contract and leaving best-practices.md unlinked.

Suggestions

Move the Lean formal block to a reference file (e.g. references/contract.md) and keep a concise prose overview plus the per-judgment pointers in SKILL.md, deduplicating rules stated four times across FLOW, MORPHISM, CONVERGENCE, Protocol, and Rules.

Add one worked example — a small framework applied to a concrete case showing the drafted question, two or three correspondences with fit claims, a check with its defeater and warrant, and the rendered assessment — so the protocol has an executable instantiation.

Link references/best-practices.md from the body (it is currently orphaned) and consolidate the five scattered 'Direction: references/judgments.md §...' citations into one clearly signaled pointer.

DimensionReasoningScore

Conciseness

At 631 lines, the body heavily pads one protocol across several restatements: the ~560-line Lean block, the FLOW/MORPHISM/CONVERGENCE comment blocks, the Protocol section, and the Rules section each repeat the same rules (e.g. 'warrant tracks evidence, never assent' and 'the question stands only on the person's turn' each appear four or more times). It sits between anchors 1 and 2: it does not explain concepts Claude already knows, but 'several unnecessary... padded sections' (anchor 2) clearly applies, while the sheer scale of redundant restatement across four layers pushes it toward — but not fully into — anchor 1.

2 / 5

Actionability

The protocol specifies its steps in detail (the question→collect→construct→check→warrant→judge→surface chain, per-operation user-facing text in TOOL GROUNDING, and what each judgment must consider), which is more than high-level hints. But it is specification rather than practice: the Lean block is elaborate pseudocode with axiom placeholders, and there is no worked example showing correspondences, a check, or a rendered assessment, so key details of what to actually produce are missing — the score-3 anchor ('pseudocode instead of executable code; missing key details'). It is not 2 because the per-operation grounding text does give concrete guidance on what to present, and not 4 because no example or template instantiates any of it.

3 / 5

Workflow Clarity

A clear seven-stage sequence is present and repeated (MORPHISM chain, pass/step definitions, Protocol, Op enumeration), and validation-like checkpoints exist (one check per bearing claim, reachable checks run before presenting). However, the workflow is spread across four redundant restatements in dense formal notation, and the checkpoints remain implicit in practice — no walkthrough shows the sequence executing, and an implementer must reconcile Lean comments with prose rules to extract it. This fits anchor 3 (sequence present, checkpoints missing or implicit) rather than 4, whose clear single sequence with concrete commands is nowhere offered.

3 / 5

Progressive Disclosure

References exist and are mostly well-signaled — references/judgments.md is cited five times with section pointers, and references/round-composition.md has a clear load trigger — all one level deep. But the ~560-line Lean formal block is inlined in SKILL.md where it clearly belongs in a separate reference file, and references/best-practices.md is orphaned (never cited from the body). This matches anchor 3 (references present and signaled, but content that should be separate is inline); it is above 2 because real structure and navigation exist, and below 4 because of the monolithic formal block and the dead bundle file.

3 / 5

Total

11

/

20

Passed

Description

53%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 identifies a distinctive niche and its end-state deliverable, but reads as a convoluted outcome clause rather than a plain statement of actions with explicit trigger guidance. The missing "Use when..." clause and unnatural syntax are the main weaknesses.

Suggestions

Add an explicit 'Use when...' clause naming concrete triggers, e.g. 'Use when applying a framework or pattern to a new case, porting a design from a sibling project or earlier version, or testing whether an abstraction holds across its cases.'

Restate the 'what' as plain third-person actions: 'Audits whether a framework, analogy, earlier design, or abstraction carries over to a target case — reports, for each conclusion, the source relation that carries it, what would break it, and whether it holds, is blocked, or is undetermined.'

Include natural user phrasings and synonyms ('does this apply here', 'carrying over', 'port', 'migration', 'structural mismatch') so the trigger terms match what users actually say.

DimensionReasoningScore

Specificity

The description names its domain ("a framework, analogy, or earlier design is carried to a case, or an abstraction tested") and states the concrete deliverable ("what carries each conclusion, what would break it, and if it holds, is blocked, or is open"), but these are 1–2 implicit actions rendered as an outcome clause rather than a list of concrete actions, and coverage is not comprehensive. It fits the score-3 anchor (domain and 1–2 concrete actions, not comprehensive) better than 4, which expects several specific listed actions, and better than 2, since the domain and the per-conclusion audit output are clearly named rather than minimal or generic.

3 / 5

Completeness

The 'what' is present — an audit of mappings producing per-conclusion carriers, breakers, and verdicts — but the 'when' is only weakly implied by the opening conditional clause, with no explicit "Use when..." guidance, which caps completeness at 3 per the rubric guideline. It is not 2 because the 'what' is substantive rather than vague, and not 4 because no explicit trigger clause exists at all.

3 / 5

Trigger Term Quality

Relevant keywords a user might plausibly say are present ("framework", "analogy", "earlier design", "abstraction", "tested", "holds"), but common natural trigger phrases and synonyms are missing — nothing like "apply X to Y", "port", "migration", "carry over a design", or "does this pattern fit". This matches the score-3 anchor (some relevant keywords, missing common variations or synonyms); it is above 2 because the terms are domain-relevant rather than generic, and below 4 because the unnatural syntax ("is carried to a case", "is blocked, or is open") obscures the natural phrasings.

3 / 5

Distinctiveness Conflict Risk

The niche — auditing what an analogical or structural mapping licenses about a target, with per-conclusion Licensed/Blocked/Undetermined verdicts — is a clear, mostly distinct territory unlikely to fire for document, code, or general-analysis skills. Minor overlap risk remains with general reasoning/review skills because broad words like "framework", "abstraction", and "conclusion" appear without sharper signature trigger terms, which keeps it below 5.

4 / 5

Total

13

/

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

Warning

Total

15

/

16

Passed

Repository

jongwony/epistemic-protocols

Path

analogia/skills/ground/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.