CtrlK
BlogDocsLog inGet started
Tessl Logo

023-assumption-analysis

Use when a framed and root-caused problem needs its assumptions made explicit before design or planning begins — explicit Assumptions, Unknowns, and a Validation plan. This should trigger when an issue's Assumption Analysis point of view needs evaluation, or when a maintainer directly asks to surface hidden assumptions and unknowns before committing to an approach. Part of Plinth Toolkit

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, appropriately concise instruction skill with concrete guidance, a clearly sequenced workflow, and exemplary one-level-deep progressive disclosure to a real reference file. Minor improvements: consolidate the triplicated statement of the five core points, and include one worked example of a falsifiable assumption / unknown / validation item in the body.

DimensionReasoningScore

Conciseness

The body is lean with no explanations of concepts Claude already knows, but the same five points appear three times across 'What is covered', Constraints, and the Workflow ('State each assumption as a falsifiable claim' appears in both the MUST list and step 2). This is minor over-repetition rather than the noticeable padding of anchor 3, so it sits at anchor 4.

4 / 5

Actionability

Instruction-only skill with concrete, executable guidance: 'state each assumption as a falsifiable claim believed true but not yet verified', 'rank... by impact if wrong and by current confidence, prioritizing high-impact, low-confidence items', and an explicit no-invention guardrail. Below anchor 5 because the body lacks a worked example of a well-formed assumption, unknown, or validation step (examples are deferred to the reference file).

4 / 5

Workflow Clarity

Six clearly sequenced steps from reading the reference through reporting, with an error-recovery guardrail ('flag the gap for a clarifying question instead') and a final step that flags items left open. It falls short of anchor 5 because there is no explicit verify/re-validate feedback loop (e.g., revisiting the ranking after a validation step resolves an unknown), only the single guardrail.

4 / 5

Progressive Disclosure

A clear ~60-line overview with a single one-level-deep reference that exists in the bundle (references/023-assumption-analysis.md), signaled both as a MUST-read constraint and as a linked '## Reference' section. Content is appropriately split between overview and detail with easy navigation, matching the anchor 5 structure; the reference does not nest further references.

5 / 5

Total

17

/

20

Passed

Description

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

A strong description with an explicit, multi-clause 'Use when' trigger, concrete named deliverables, and correct third-person voice. Its main weakness is reliance on toolkit-internal jargon ('framed and root-caused', 'point of view needs evaluation') that a user outside the workflow would not naturally say.

DimensionReasoningScore

Specificity

Names the domain and several concrete deliverables — 'explicit Assumptions, Unknowns, and a Validation plan' — with only minor coverage gaps (e.g., ranking and validation-plan detail are implied rather than listed as actions). It sits above anchor 3 (only 1-2 concrete actions) but below anchor 5 (comprehensive multi-action coverage) because the actions are stated as outputs rather than enumerated capabilities.

4 / 5

Completeness

Clearly answers both: what — 'explicit Assumptions, Unknowns, and a Validation plan' — and when — 'Use when a framed and root-caused problem needs its assumptions made explicit... This should trigger when... or when a maintainer directly asks to surface hidden assumptions and unknowns'. Explicit 'Use when' clause with concrete trigger phrases matches the anchor 5 example; it is not anchor 4 because the when-clause is explicit and multi-scenario rather than only weakly specific.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'surface hidden assumptions and unknowns', 'before committing to an approach', 'Assumption Analysis'. However, phrases like 'framed and root-caused problem' and 'point of view needs evaluation' are toolkit-internal jargon a user would not naturally say, keeping it below anchor 5's comprehensive natural-term coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (assumption/unknown surfacing prior to design, 'Part of Plinth Toolkit') with distinct trigger phrases; minor overlap risk remains with closely related analysis skills in the same toolkit (e.g., context mapping). It does not reach anchor 5 because the trigger partially relies on the toolkit's own workflow vocabulary.

4 / 5

Total

17

/

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
jabrena/plinth
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.