volcano-plot-labeler
Automatically label top significant genes in volcano plots using a force-directed repulsion algorithm to prevent label overlap.
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/volcano-plot-labeler/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.
The description excels at specificity and distinctiveness with clear technical capabilities in a specialized domain. However, it lacks explicit trigger guidance ('Use when...') and could benefit from additional natural keywords users might employ when requesting this functionality.
Suggestions
Add a 'Use when...' clause with trigger terms like 'volcano plot', 'label genes', 'gene annotation', 'differential expression visualization'
Include common user phrases such as 'overlapping labels', 'RNA-seq results', 'DESeq2 output', or 'gene expression plot'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists specific concrete actions: 'label top significant genes', 'volcano plots', 'force-directed repulsion algorithm', 'prevent label overlap'. These are precise, technical capabilities. | 3 / 3 |
Completeness | Clearly answers 'what' (label genes in volcano plots with repulsion algorithm), but lacks explicit 'Use when...' clause or trigger guidance for when Claude should select this skill. | 2 / 3 |
Trigger Term Quality | Contains good domain terms like 'volcano plots', 'genes', 'label overlap', but missing common variations users might say like 'gene expression', 'differential expression', 'plot labels', 'annotation'. | 2 / 3 |
Distinctiveness Conflict Risk | Highly specific niche combining volcano plots, gene labeling, and force-directed algorithms. Unlikely to conflict with other skills due to the specialized bioinformatics/visualization 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 excellent actionable guidance with executable commands, clear parameter documentation, and good error handling. However, it suffers from verbosity in meta-instructions (response templates, output requirements) that don't add value for Claude, and the workflow section is too abstract rather than specific to the volcano plot labeling task.
Suggestions
Remove or significantly condense the 'Response Template' and 'Output Requirements' sections - these are generic meta-instructions Claude doesn't need
Rewrite the 'Workflow' section to be specific to volcano plot labeling steps rather than generic task execution guidance
Consider moving the detailed parameter table and error handling to a separate REFERENCE.md file to keep SKILL.md focused on quick-start usage
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains some redundancy - the workflow section, output requirements, and response template sections add significant overhead that Claude doesn't need. The fallback template and response template are verbose meta-instructions that could be condensed. | 2 / 3 |
Actionability | Provides fully executable bash commands with clear parameter tables, concrete examples with actual column names, and copy-paste ready usage patterns. The algorithm section clearly explains the labeling logic. | 3 / 3 |
Workflow Clarity | The workflow section is abstract ('Confirm objective, required inputs...') rather than specific to volcano plot labeling. However, error handling includes good validation checkpoints and the fallback template provides clear recovery steps. | 2 / 3 |
Progressive Disclosure | Content is reasonably organized with clear sections, but it's somewhat monolithic at ~150 lines. The response template and output requirements sections could be split to a separate reference file. No external file references for advanced customization. | 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.