CtrlK
BlogDocsLog inGet started
Tessl Logo

contextualize

A result may not fit where it lands: check every place it reaches and every intent it was meant to carry, show every misfit and omission on one sheet, and carry out the fixes the user settles.

43

Quality

54%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./epharmoge/skills/contextualize/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 content presents an unusual and internally consistent formal contract, with one strong worked example and a clean single reference file, but it buries its actionable guidance under a massively redundant Lean specification and restates the same protocol three times in different idioms. The result is verbose and hard to act on despite the underlying workflow being sound.

Suggestions

Move the Lean formal block to references/ (e.g., references/contract.lean), keeping a short summary of the flow and key invariants in SKILL.md — this would cut the body to well under a third of its current size.

Deduplicate the protocol statement: the Definition prose, the Lean block's comments, and the Rules section each restate the same contract; pick one authoritative statement and have the others reference it.

Add a short step-by-step procedure section (numbered steps for a pass: observe, judge, sheet, gate, perform, re-observe, complete) so an executor can follow the workflow without reconstructing it from the axioms.

DimensionReasoningScore

Conciseness

The body is ~490 lines whose bulk is a 435-line Lean 4 formal block that restates what the Definition prose and the Rules section each state again — heavy triple redundancy plus philosophical padding ("from Aristotle's notion of practical application"). Not 1 because the formal block carries unique contract content rather than explaining things Claude already knows, but it is noticeably, structurally verbose.

2 / 5

Actionability

The Protocol section's worked nightly-report sheet is genuinely concrete and instructive, but the dominant guidance is formal pseudocode — axioms like observe, mismatches, perform define what to judge without any executable steps. Anchor 3: some concrete guidance, incomplete, formal rather than executable. Not 4 because no commands or copy-paste-ready procedure exists outside the single example.

3 / 5

Workflow Clarity

A real sequence is present (observe reach → judge mismatches → perform relay → present sheet → gate on the person's turn → pass until NothingOpen) with a completion validation (observe-again after writes, non-monotone re-judgment). But checkpoints are implicit, scattered across the FLOW comment, Morphism list, and phase-transition notes rather than laid out as a followable procedure. Not 4 for that gap; not 2 because the sequence is coherent and the completion criterion is explicit.

3 / 5

Progressive Disclosure

The single reference (references/round-composition.md) exists, is one level deep, and is well-signaled from the Rules section with explicit read-when conditions — but the 435-line Lean block is exactly the kind of monolithic inline content that belongs in a separate file. Some structure with clear signaling, but the body itself is not appropriately split. Not 4 for the monolith; not 2 because what referencing exists is clean and navigable.

3 / 5

Total

11

/

20

Passed

Description

42%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 states three concrete actions but wraps them in abstract language with no use-when trigger guidance and no natural keywords a user would say. It reads as an evocative summary of the skill rather than a discoverability-oriented trigger description.

Suggestions

Add an explicit 'Use when...' clause naming concrete situations (e.g., 'Use when applying this session's output elsewhere, deploying a change, or fitting an artifact into a user's stated context').

Replace abstract phrases ('every place it lands', 'every intent it was meant to carry') with concrete artifact nouns users would actually say — report, config, schedule, document, code change.

Include natural trigger terms and synonyms users would utter when they need the skill (e.g., 'fit', 'apply', 'context', 'check this works in my situation').

DimensionReasoningScore

Specificity

The description lists three concrete actions — "check every place it reaches", "show every misfit and omission on one sheet", "carry out the fixes the user settles" — but its domain nouns ("a result", "where it lands", "every intent it was meant to carry") are abstract, leaving coverage incomplete. It sits at anchor 3 rather than 4 because the actions are named but their object is vague, not at 2 because the actions themselves are genuinely specific.

3 / 5

Completeness

The 'what' is stated (check, show on one sheet, carry out fixes) but there is no 'when' — no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 2 because the 'what' is present and reasonably clear, not 4 because the 'when' is wholly absent rather than merely weak.

3 / 5

Trigger Term Quality

The only candidate keywords ("result", "misfit", "fixes") are generic; there are no natural phrases or synonyms a user would actually say when needing this skill, and nothing names the artifacts or situations involved. Not 1 because it is not pure jargon, but clearly below the 'some relevant keywords' bar of 3.

2 / 5

Distinctiveness Conflict Risk

The misfit-sheet-and-settled-fixes framing carves a distinct niche, but the abstract wording ("a result may not fit where it lands") could plausibly trigger for general review, verification, or refactoring skills. Somewhat specific with residual overlap risk — anchor 3, not 4 since the boundaries are never named.

3 / 5

Total

11

/

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