CtrlK
BlogDocsLog inGet started
Tessl Logo

inquire

A task rests on missing context or unchecked assumptions: collect every piece of context the AI can reach on its own, then hand back what it cannot reach as the user's own unknown.

49

Quality

62%

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 ./aitesis/skills/inquire/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 unusual, carefully specified dialogical protocol with genuine progressive disclosure to two real reference files, but the body is dominated by an inline ~300-line Lean formalization and multiple restatements of the same rules at high token cost. A reader can extract the intended workflow only by assembling it from Definition, formal comments, and Rules; no worked example grounds the behavior.

Suggestions

Move the Lean formalization block into a reference file (e.g. `references/formal-model.md`) and keep SKILL.md to the Definition summary, Protocol, Mode Activation, Intensity table, and Rules, cutting the heavy repetition between these sections.

Add a short worked example of one relay: a sample uncertainty, its reach (sources tried, sources not reached, where the ground falls short), and the everyday-language hand-back, so the abstract rules are grounded in a concrete instance.

State the operative workflow as an explicit numbered sequence (inventory → collect → record reach → relay → read answers) in one place, instead of diffusing it across the FLOW comments, MORPHISM list, and Protocol prose.

DimensionReasoningScore

Conciseness

The ~450-line body restates the same contract many times over — the Definition prose, the FLOW/MORPHISM comments, the Lean axiom doc comments, TOOL GROUNDING's operation strings, the Protocol section, and the Rules all repeat the same collection/relay/settlement rules in slightly different registers — making it noticeably verbose with several padded, redundant sections. It avoids anchor 1 only because it never explains concepts Claude already knows; the padding is self-repetition rather than filler.

2 / 5

Actionability

There is real concrete guidance — the Intensity table with levels and formats, the Protocol's user-facing realization instructions, the explicit skip conditions in Mode Activation, and pointers to the real bundle files `references/judgments.md` and `references/round-composition.md` — but it is incomplete: no worked example of a relay, no concrete instance of an uncertainty with its reach, and the bulk of the document is a formal specification of judgments rather than instructions. This matches the anchor for 'some concrete guidance but incomplete; missing key details' rather than anchor 4's mostly-executable guidance.

3 / 5

Workflow Clarity

A sequence is present (scan → collect → read → relay → fuse, restated in FLOW, MORPHISM, and the Protocol) and the CONVERGENCE section defines what evidence each completion must show, but the sequence is diffused across dense prose, formal comments, and a Lean recursion rather than given as a followable step list, and checkpoints are implicit. It does not reach anchor 4's 'clear sequence with most checkpoints present' because a reader must reconstruct the operative order from several sections.

3 / 5

Progressive Disclosure

The two bundle files (`references/judgments.md`, `references/round-composition.md`) exist, are referenced from the body at the points where they matter, and are one level deep. However, roughly 300 lines of Lean formalization sit inline in SKILL.md — content that belongs in a separate reference file — which matches the anchor 'references present but content that should be separate is inline' rather than anchor 4's 'most content appropriately placed'.

3 / 5

Total

11

/

20

Passed

Description

62%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 well-formed: it states a clear trigger condition up front and describes two concrete, distinctive behaviors in third person without padding. Its main gaps are the absence of a 'Use when...' style trigger phrase with natural synonyms and slightly abstract phrasing of the actions.

DimensionReasoningScore

Specificity

The description names its domain ('missing context or unchecked assumptions') and two concrete actions — 'collect every piece of context the AI can reach on its own' and 'hand back what it cannot reach as the user's own unknown' — but the actions are stated abstractly rather than as specific operations, and coverage is not comprehensive. It sits above anchor 2 (which has only generic actions) but below anchor 4 (which lists several specific actions with minor gaps).

3 / 5

Completeness

Both parts are present: the leading condition 'A task rests on missing context or unchecked assumptions' explicitly states when to use the skill, and the remainder states what it does (collect reachable context, hand back the unreachable as the user's own unknown). It does not reach anchor 5 because the 'when' is phrased as a condition rather than a concrete 'Use when...' trigger clause with explicit trigger phrases, fitting anchor 4 where 'when' could be more explicit or specific.

4 / 5

Trigger Term Quality

'missing context' and 'unchecked assumptions' are phrases a user might naturally say, giving some relevant keywords, but common variations and synonyms ('gather context', 'clarify requirements', 'unknowns', 'verify assumptions') are absent. This matches the anchor with 'some relevant keywords but missing common variations or synonyms' and does not reach the good-coverage anchor.

3 / 5

Distinctiveness Conflict Risk

The niche — collecting context to the limit of the AI's own reach before asking the user anything — is a distinctive behavior with distinct triggers, so it is mostly distinguishable from other skills. There is minor overlap risk with closely related research/planning skills that also 'gather context', keeping it below anchor 5.

4 / 5

Total

14

/

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.