CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

propose-hypotheses

Execute complete FPF cycle from hypothesis generation to decision

Quality

69%

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 ./antigravity/skills/propose-hypotheses/SKILL.md

The canonical home for this skill is propose-hypotheses in NeoLabHQ/context-engineering-kit

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 is a well-structured orchestration workflow: lean, sequential, with explicit validation checkpoints, a user-interaction loop, feedback loop on the decision, and a completion checklist. Its main weaknesses are un-verifiable external task references, repeated per-step boilerplate, and 'check that...' validation steps that don't specify the mechanism.

Suggestions

Make each 'check that...' validation concrete, e.g., 'If any files remain in .fpf/knowledge/L1/, re-run verification for those hypotheses' or an explicit ls command, and specify how to recover when an expected artifact is missing.

Factor the repeated 'Launch fpf-agent with sonnet[1m] model / Description / Prompt' scaffolding into a stated convention once, then reference it per step to trim boilerplate.

Fix minor formatting inconsistencies (missing blank line before the '---' between Steps 8 and 9) and, if the task files live in the same plugin, consider a brief one-line note of what each task file does so the overview navigates without opening them.

DimensionReasoningScore

Conciseness

The body is efficient: each step gives only the agent prompt, write location, and postcondition with no explanation of concepts Claude already knows, matching the score-4 anchor of efficient with minor trim opportunities. It is not a 5 because the boilerplate 'Launch fpf-agent with sonnet[1m] model' and '**Description**'/'**Prompt**' scaffolding repeat verbatim across six steps and could be factored out, and some prompt template text (e.g., the reply-table skeletons) is slightly padded.

4 / 5

Actionability

Guidance is mostly executable: exact mkdir/touch commands, per-step agent prompts with concrete file paths ('.fpf/knowledge/L0/<hypothesis-id>.md', 'Read ${CLAUDE_PLUGIN_ROOT}/tasks/verify-logic.md and execute'), specified output locations, and clearly marked substitution points. It is not a 5 because verification instructions like 'check that files are moved' do not state how to check (e.g., an ls/glob command or what to do on failure), and the referenced task files cannot be confirmed from the bundle.

4 / 5

Workflow Clarity

The sequence is explicit (Steps 1a through 9) with a conditional loop (Step 4) that has a stated exit condition, per-phase validation checkpoints ('**Wait for all agents**, then check that files are moved to `.fpf/knowledge/L1/` or `.fpf/knowledge/invalid/`'), a postcondition after the destructive scaffold step, a decision-modification feedback loop in Step 9, and a completion checklist. This matches the score-5 anchor of clear sequence, explicit validation steps, feedback loops, and checklists; it is not a 4 because validation presence spans every phase rather than having only minor gaps.

5 / 5

Progressive Disclosure

The SKILL.md stays a lean orchestration overview and delegates per-phase detail to one-level-deep, clearly signaled task files ('Read ${CLAUDE_PLUGIN_ROOT}/tasks/... and execute') with well-organized sections and an artifacts listing, matching the score-4 anchor of good structure with mostly clear references and minor gaps. It is not a 5 because no references/, scripts/, or assets/ bundle exists here so the referenced task files cannot be verified or navigated from the skill itself, and section formatting is slightly inconsistent (a missing blank line before the Step 8/9 separator).

4 / 5

Total

17

/

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 conveys a terse 'what' but relies on an unexplained acronym ("FPF") and provides no 'when to use' guidance or natural trigger terms. Its brevity is commendable, but it fails the completeness and trigger-term standards set by the good examples.

Suggestions

Add an explicit trigger clause, e.g., 'Use when the user asks to generate or evaluate competing hypotheses, compare options from first principles, or needs a structured decision with a recorded rationale.'

Spell out the framework on first use ('First Principles Framework (FPF)') so users who don't know the acronym can still match the description to their need.

Include natural synonyms users would actually say — 'competing hypotheses', 'evaluate options', 'decision rationale' — to improve trigger term coverage and distinctiveness from generic reasoning skills.

DimensionReasoningScore

Specificity

The phrase "Execute complete FPF cycle from hypothesis generation to decision" names the domain (FPF) and two concrete action endpoints ("hypothesis generation", "decision"), matching the score-3 anchor of domain plus 1-2 concrete actions but not comprehensive. It is not a 4 because the intermediate actions (verify logic, validate evidence, audit trust) are absent from the description, and not a 2 because "hypothesis generation" and "decision" are more concrete than the purely generic 'Processes PDF files' example.

3 / 5

Completeness

The description has a clear 'what' ("Execute complete FPF cycle from hypothesis generation to decision") but no 'when' — there is no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. It is not a 2 because the 'what' is reasonably concrete rather than vague; it cannot be a 4 without any explicit 'when'.

3 / 5

Trigger Term Quality

The only candidate keywords are "hypothesis generation" and "decision", with the undefined acronym "FPF" being jargon users would not naturally say. This matches the score-2 anchor of one or two generic keywords missing the natural phrases users say; it is not a 3 because there is no coverage of common variations or synonyms (e.g., brainstorming, evaluate options, first-principles reasoning).

2 / 5

Distinctiveness Conflict Risk

The niche term "FPF" and hypothesis-driven framing give it some specificity, but "hypothesis generation to decision" overlaps broadly with general reasoning, brainstorming, and decision-analysis skills, matching the score-3 anchor of somewhat specific but still able to overlap. It is not a 4 because no distinct trigger phrases are given to separate it from those adjacent skills.

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

NeoLabHQ/context-engineering-kit

Path

antigravity/skills/propose-hypotheses/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.