CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hypogenic

Automated LLM-driven hypothesis generation and testing on tabular datasets. Use when you want to systematically explore hypotheses about patterns in empirical data (e.g., deception detection, content analysis). Combines literature insights with data-driven hypothesis testing. For manual hypothesis formulation use hypothesis-generation; for creative ideation use scientific-brainstorming.

56

Quality

71%

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 ./backend/cli/skills/chemistry/hypogenic/SKILL.md
SKILL.md
Quality
Evals
Security

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 body is highly actionable with executable CLI and Python examples and well-sequenced multi-step workflows, but it reads like a ported README rather than an agent skill: it is padded with duplicated statistics, BibTeX citations, and repo metadata, omits validation checkpoints in its batch generation/inference flows, and inlines content that should live in its own references while pointing at directories that don't exist.

Suggestions

Cut README-style filler: drop the three full BibTeX blocks (link-only citations suffice), the Repository Structure and Community/Contributions sections, and merge the duplicated 'Proven Results' and 'Expected Outcomes' statistics into one short section — this alone would remove ~150 lines of the conciseness problem.

Add validation checkpoints to the batch workflows: after generation, verify output/hypotheses.json exists and is well-formed before inference; before pdf_preprocess.py, confirm the GROBID service is responding; and fold the Troubleshooting items into their respective steps as fix-and-retry loops.

Move the full config.yaml example out of the body into the existing references/config_template.yaml (keeping only a minimal skeleton inline with a pointer), and remove or actually create the scripts/ and assets/ directories the 'Local Resources' section describes.

DimensionReasoningScore

Conciseness

The ~645-line body is noticeably verbose with padded sections: the same git-clone commands appear three times, 'Proven Results' and 'Expected Outcomes' repeat overlapping statistics, three full BibTeX citations plus a 'Community & Contributions' section (stars, contributor counts) and a repository-structure dump are README filler that adds nothing an agent needs, and a full config.yaml example is inlined despite references/config_template.yaml existing. Not anchor 1 because it rarely explains concepts Claude already knows — most material is task-specific and accurate.

2 / 5

Actionability

Mostly executable: Quick Start commands, concrete Python API calls, a working extract_label() implementation, and step-by-step custom-task instructions. Falls short of anchor 5 because the CLI 'Key parameters' subsectiones describe parameters ('Task configuration file path', 'Model selection') without naming the actual flags, and multi_hyp_inference imports from the repo's examples/ without explaining how to obtain it inline.

4 / 5

Workflow Clarity

Sequences are clearly laid out ('Creating Custom Tasks' Steps 1-5, 'Literature Processing' Steps 1-3, three worked scenarios), but validation checkpoints are absent: nothing tells the agent to verify hypotheses.json was produced, check GROBID is up before pdf_preprocess.py, or confirm label formats match before running inference — the Troubleshooting section exists but is not embedded as feedback loops in the batch generation/inference workflow, which caps this at 3 per the batch-operations rule.

3 / 5

Progressive Disclosure

The one real bundle reference is clearly signaled and one level deep ('Refer to references/config_template.yaml for a complete example configuration' — the file exists), but large content that belongs in reference files is inlined anyway (three BibTeX blocks, repository structure, a duplicate config example), and the 'Local Resources' section describes scripts/ and assets/ directories that do not exist in the bundle. Some structure and good section headers, but organization gaps keep it at anchor 3.

3 / 5

Total

12

/

20

Passed

Description

82%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: it states what the skill does and when to use it in concrete, third-person-voiced (mostly) terms, includes natural trigger phrases, and explicitly disambiguates from adjacent skills. The only notable deduction is the second-person 'Use when you want to...' phrasing, which the rubric penalizes on specificity.

DimensionReasoningScore

Specificity

Concrete actions are named ('hypothesis generation and testing on tabular datasets', 'Combines literature insights with data-driven hypothesis testing') with domain examples, which on its own sits at anchor 4 ('lists several specific actions; minor gaps'), but the second-person phrasing 'Use when you want to systematically explore...' triggers the rubric's -1 voice penalty, landing it at 3. Not anchor 2 because the actions and domain are far more concrete than 'names the domain but actions are minimal'.

3 / 5

Completeness

Explicitly answers what ('Automated LLM-driven hypothesis generation and testing on tabular datasets') and when ('Use when you want to systematically explore hypotheses about patterns in empirical data (e.g., deception detection, content analysis)') with concrete trigger examples. Matches anchor 5; not 4 because the 'when' clause is already explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'hypothesis generation', 'hypothesis testing', 'deception detection', 'content analysis', 'empirical data' — phrases a researcher would plausibly say. Falls short of anchor 5 because there are few synonyms or variations (e.g., 'hypotheses', 'empirical patterns' appear only implicitly) and no broader natural phrasings beyond the two domain examples.

4 / 5

Distinctiveness Conflict Risk

Clear niche (automated, LLM-driven, systematic hypothesis testing) and it proactively disambiguates from the two most confusable sibling skills: 'For manual hypothesis formulation use hypothesis-generation; for creative ideation use scientific-brainstorming.' Minimal conflict risk; matches anchor 5.

5 / 5

Total

17

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (661 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/chemistry/hypogenic/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.