gene-info

Retrieves comprehensive gene information including PubMed publication counts, NCBI summaries, and Ensembl transcript data. Supports batch processing and file input. Invoke when the user asks for gene details, publication statistics, or needs to analyze a list of genes.

Quality

71%

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/Evidence Insight/gene-info/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 Usage and Output Format sections are genuinely useful and executable, but they are buried under a large amount of generic templated boilerplate that adds little value and inflates token cost. Path inconsistencies and non-specific validation guidance weaken the workflow.

Suggestions

Remove or collapse the generic templated sections (When to Use, Key Features, Implementation Details, Recommended Workflow, Output Contract, Validation and Safety Rules, Deterministic Output Rules, Completion Checklist) that restate what Claude already knows and duplicate the description.

Standardize the script path across all examples — the body mixes 'scripts/fetch_gene_info.py' and '.trae/skills/gene-info/scripts/fetch_gene_info.py', which is not a real bundle path.

Replace the generic validation boilerplate with tool-specific checkpoints for the batch workflow, e.g. validating the gene-list file format before running and retrying on NCBI/Ensembl rate-limit errors.

Dimension	Reasoning	Score
Conciseness	The body is noticeably padded with templated boilerplate ('When to Use', 'Key Features', 'Implementation Details', 'Recommended Workflow', 'Output Contract', 'Validation and Safety Rules', 'Deterministic Output Rules', 'Completion Checklist') that restates generic guidance Claude already knows and duplicates the description.	2 / 5
Actionability	The Usage section provides concrete, copy-paste-ready commands covering single gene, keyword, batch, file input, export, sequence, and homology cases, but paths are inconsistent ('scripts/...' vs '.trae/skills/gene-info/scripts/...').	4 / 5
Workflow Clarity	A sequenced Recommended Workflow plus Quick Validation and Failure Handling exist, but for a batch operation the checkpoints are generic boilerplate rather than tool-specific feedback loops (e.g., validate the gene list format, retry on NCBI rate limits).	3 / 5
Progressive Disclosure	Section headers and real script references (scripts/fetch_gene_info.py, scripts/validate_skill.py verified present) provide some structure, but all detail is inlined in one file and the templated wrapper is muddled with the genuine tool content rather than cleanly separated.	3 / 5
	Total	12 / 20 Passed

Description

92%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 clearly states both the capability and the invocation triggers using concrete database sources. Trigger term coverage is good but could add a few more natural synonyms.

Dimension	Reasoning	Score
Specificity	The description lists multiple concrete actions — 'PubMed publication counts, NCBI summaries, and Ensembl transcript data' plus 'batch processing and file input' — giving comprehensive coverage in third person.	5 / 5
Completeness	It explicitly answers what ('Retrieves comprehensive gene information including...') and when ('Invoke when the user asks for gene details, publication statistics...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	'gene details, publication statistics, or needs to analyze a list of genes' are natural user phrases, but common synonyms like 'gene info/symbols' and file extensions are missing.	4 / 5
Distinctiveness Conflict Risk	The gene-information niche with named databases (PubMed, NCBI, Ensembl) and distinct triggers creates a clear, specialized scope with minimal overlap risk.	5 / 5
	Total	19 / 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
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Evidence Insight/gene-info/SKILL.md
Commit: 63c61d3

Reviewed: 8 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.