gene-structure-mapper
Visualize gene structure with exon-intron diagrams, domain annotations, and mutation position markers. Produces SVG, PNG, or PDF figures suitable for publication from a gene symbol input.
72
66%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Data analysis/gene-structure-mapper/SKILL.mdQuality
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted description with strong specificity and a clear, distinctive niche in bioinformatics visualization. The main weakness is the absence of explicit 'Use when...' guidance, which limits Claude's ability to know when to select this skill. Adding natural trigger terms and explicit usage conditions would significantly improve skill selection accuracy.
Suggestions
Add a 'Use when...' clause with trigger phrases like 'when the user asks to visualize a gene, create a gene diagram, show exon-intron structure, or map mutations on a gene'
Include additional natural keywords users might say: 'gene diagram', 'gene map', 'transcript visualization', 'protein domains'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Visualize gene structure with exon-intron diagrams, domain annotations, and mutation position markers' and specifies output formats (SVG, PNG, PDF) and input type (gene symbol). | 3 / 3 |
Completeness | Clearly answers 'what' (visualize gene structure, produce figures) but lacks an explicit 'Use when...' clause or equivalent trigger guidance to indicate when Claude should select this skill. | 2 / 3 |
Trigger Term Quality | Contains domain-specific terms like 'gene structure', 'exon-intron', 'domain annotations', 'mutation position' which are relevant but may miss common user phrasings like 'gene diagram', 'gene map', 'visualize mutations', or 'gene figure'. | 2 / 3 |
Distinctiveness Conflict Risk | Highly specific niche combining gene visualization, exon-intron diagrams, and mutation markers - unlikely to conflict with other skills due to the specialized bioinformatics domain. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides strong actionable guidance with excellent parameter documentation and concrete usage examples. However, it suffers from some verbosity through redundant sections (Features duplicates other content) and a generic workflow that doesn't provide gene-structure-specific validation steps. The content would benefit from tightening and making the workflow more concrete to the actual task.
Suggestions
Remove or consolidate the 'Features' section as it duplicates information already in 'Implementation Notes' and parameter descriptions
Replace the generic 5-step workflow with concrete gene-structure-specific steps (e.g., '1. Validate gene symbol format, 2. Query Ensembl API, 3. Verify response contains exon data, 4. Generate visualization')
Move 'Implementation Notes' to a separate IMPLEMENTATION.md file since it's developer-focused rather than usage-focused
Add explicit validation checkpoint after Ensembl API call before proceeding to visualization (currently validation is only in error handling, not workflow)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains some redundancy - the 'Features' section largely duplicates information from 'Implementation Notes' and parameter descriptions. The 'Output Requirements' and 'Response Template' sections add bureaucratic overhead that could be trimmed. | 2 / 3 |
Actionability | Provides fully executable command examples, complete parameter table with types and defaults, specific API endpoints with exact URLs, and concrete error messages. The quick check commands are copy-paste ready. | 3 / 3 |
Workflow Clarity | The workflow section is abstract and generic rather than specific to gene structure mapping. While there's a fallback template and error handling section, the main workflow lacks concrete validation checkpoints specific to the visualization task (e.g., verify API response before rendering). | 2 / 3 |
Progressive Disclosure | Content is reasonably organized with clear sections, but everything is in one file when implementation notes and detailed error handling could be split out. No references to external documentation for advanced topics like domain mapping accuracy or isoform handling. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- aipoch/medical-research-skills
- Commit
ca9aaa4
- 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.