hypothesis-generation

Structured hypothesis formulation from observations. Use when you have experimental observations or data and need to formulate testable hypotheses with predictions, propose mechanisms, and design experiments to test them. Also owns explicit HypoGeniC-style or automated LLM-driven hypothesis generation/testing requests inside this single skill. For open-ended ideation use scientific-brainstorming.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./bundled/skills/hypothesis-generation/SKILL.md

Quality

Content

60%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 body is well-structured and actionable with a clear multi-step workflow and properly signaled bundle references, but it is noticeably verbose due to repeated overflow-prevention guidance and inline LaTeX detail that duplicates the formatting guide.

Suggestions

Collapse the three repeated \newpage/overflow sections into a single concise 'Page overflow' note and point to assets/FORMATTING_GUIDE.md for the rest.

Move the detailed colored-box usage and citation-count breakdown into assets/FORMATTING_GUIDE.md, keeping SKILL.md to a short pointer.

Trim the testability/falsifiability/parsimony glossary in step 5 to a one-line reference to references/hypothesis_quality_criteria.md rather than re-explaining each criterion.

Dimension	Reasoning	Score
Conciseness	Noticeably verbose: page-overflow/ newpage guidance is repeated near-verbatim across 'Page Break Strategy', 'Critical Overflow Prevention', and 'Page Overflow Prevention', and the testability/falsifiability/parsimony glossary explains concepts Claude already knows.	2 / 5
Actionability	Provides concrete, executable specifics — named box environments (hypothesisbox1-5, predictionbox), citation count targets, and a full xelatex/bibtex compilation sequence — with only minor gaps (no full worked LaTeX example).	4 / 5
Workflow Clarity	A clear 8-step sequence (Understand → Literature Search → ... → Present) is well ordered with a quality-evaluation checkpoint; no destructive/batch operations so the validation cap does not apply, though explicit validation feedback loops are absent.	4 / 5
Progressive Disclosure	Good one-level-deep structure: three references/ and three assets/ files are signaled inline and catalogued in a Resources section; the main gap is that extensive LaTeX box/overflow detail is inlined when assets/FORMATTING_GUIDE.md already exists for it.	4 / 5
	Total	14 / 20 Passed

Description

87%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 strong: it states concrete capabilities, gives explicit 'Use when ...' triggers, scopes HypoGeniC ownership, and disambiguates from scientific-brainstorming. Minor keyword synonym gaps keep trigger_term_quality and specificity just below 5.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — 'formulate testable hypotheses with predictions', 'propose mechanisms', 'design experiments to test them', 'HypoGeniC-style ... hypothesis generation/testing' — with only minor coverage gaps relative to the comprehensive 5-anchor.	4 / 5
Completeness	Explicitly states both what ('Structured hypothesis formulation ... propose mechanisms, and design experiments') and when ('Use when you have experimental observations or data and need to formulate testable hypotheses ...'), with concrete trigger phrases.	5 / 5
Trigger Term Quality	Natural trigger phrases like 'experimental observations or data', 'testable hypotheses', 'mechanisms', and 'HypoGeniC-style' match what a user would say, though a few common synonyms are missing.	4 / 5
Distinctiveness Conflict Risk	Clear niche (scientific hypothesis generation), owns 'HypoGeniC-style' requests explicitly, and draws a boundary ('For open-ended ideation use scientific-brainstorming'), minimizing conflict risk.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: foryourhealth111-pixel/Vibe-Skills
Path: bundled/skills/hypothesis-generation/SKILL.md
Commit: d5ae560

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.