hypothesis-generation

Structured scientific hypothesis formulation from observations; use when you have experimental observations or preliminary data and need testable hypotheses with predictions, mechanisms, and validation experiments.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Protocol Design/hypothesis-generation/SKILL.md

Quality

Content

50%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 core technical content is specific and actionable, but it is weighed down by a generic boilerplate preamble, lacks a validation loop in the LaTeX build, and references bundle files that are absent from the package.

Suggestions

Delete the generic preamble (the unnumbered When to Use / Key Features / Dependencies / Example Usage / Implementation Details sections that duplicate sections 1-5) to remove padding and improve conciseness.

Add an explicit compile-time validation feedback loop (e.g., 'if xelatex reports errors, fix the offending box/citation and re-run until clean') to the report build workflow.

Either include the referenced references/*.md and assets/* files in the bundle or remove the dangling references so progressive-disclosure navigation resolves.

Dimension	Reasoning	Score
Conciseness	A large generic templated preamble (When to Use / Key Features / Dependencies / Example Usage / Implementation Details) duplicates the real numbered sections and adds filler like the empty 'Quick Validation' block, constituting several unnecessary padded sections.	2 / 5
Actionability	Provides mostly executable, copy-paste-ready commands (schematic generation, cp/xelatex/bibtex sequence) and a full LaTeX structure snippet, with minor gaps from externally-owned or missing scripts/assets.	4 / 5
Workflow Clarity	The 8-step workflow is clearly sequenced, but the fragile LaTeX compile step lacks any validation/fix feedback loop, which caps workflow clarity at 3 per the destructive/batch-operations rule.	3 / 5
Progressive Disclosure	References are well-signaled and one-level-deep in prose, but the referenced references/, scripts/, and assets/ directories do not exist, so all referenced paths are broken and navigation fails.	3 / 5
	Total	12 / 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.

A strong, specific description that concretely states capabilities and gives explicit use-when guidance with natural trigger phrases. Minor keyword-synonym gaps are the only weakness.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete actions (formulating testable hypotheses, generating predictions, mechanisms, validation experiments), with minor coverage gaps versus the comprehensive 5-anchor.	4 / 5
Completeness	Explicitly answers both what (structured hypothesis formulation with predictions/mechanisms/validation experiments) and when ('use when you have experimental observations or preliminary data and need...').	5 / 5
Trigger Term Quality	Good natural keyword coverage ('experimental observations', 'preliminary data', 'testable hypotheses') but missing common synonyms and a few terms a researcher might say.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (scientific hypothesis generation) with distinct, domain-specific triggers and minimal overlap with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning
referenced_paths_exist	Referenced path issues: 24 missing	Warning

	Total	14 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Protocol Design/hypothesis-generation/SKILL.md
Commit: 63c61d3

Reviewed: 10 hours 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.