Generate publication-ready R or Python volcano plot scripts from DEG analysis results with customizable thresholds, gene labeling, and color schemes.
77
72%
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-script/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 description excels at specificity and distinctiveness, clearly defining a specialized bioinformatics visualization skill. However, it lacks explicit trigger guidance ('Use when...') and relies on technical jargon that may not match how users naturally phrase requests. The description would benefit from expanding trigger terms and adding explicit usage conditions.
Suggestions
Add a 'Use when...' clause with trigger phrases like 'when the user asks to visualize differential expression results, create a volcano plot, or plot gene expression data'
Expand trigger terms to include common variations: 'differential expression', 'differentially expressed genes', 'gene expression visualization', 'DESeq2 results', 'edgeR output'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Generate publication-ready R or Python volcano plot scripts', 'DEG analysis results', 'customizable thresholds, gene labeling, and color schemes'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers 'what' (generate volcano plot scripts with customization options) but lacks an explicit 'Use when...' clause or trigger guidance. The when is only implied through the domain context. | 2 / 3 |
Trigger Term Quality | Includes domain-specific terms like 'volcano plot', 'DEG analysis', 'R', 'Python', but uses technical jargon ('DEG') that users might not say. Missing common variations like 'differential expression', 'gene expression plot', or 'visualize DEG results'. | 2 / 3 |
Distinctiveness Conflict Risk | Highly specific niche combining bioinformatics (volcano plots, DEG analysis) with scripting (R/Python). Unlikely to conflict with other skills due to the specialized domain terminology. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with strong actionability and workflow clarity. The CLI interface is thoroughly documented with executable examples and comprehensive error handling. However, the skill could be more concise by consolidating overlapping sections (workflow, output requirements, response template) and moving detailed response formatting guidance to a separate reference file.
Suggestions
Consolidate the 'Workflow', 'Output Requirements', and 'Response Template' sections which contain overlapping guidance about structuring responses
Move the detailed 'Response Template' and 'Output Requirements' sections to a separate RESPONSE_FORMAT.md reference file to reduce the main skill length
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains useful information but includes some redundancy - the workflow section, output requirements, and response template sections overlap significantly in their guidance about structuring responses. The fallback template and error handling sections could be consolidated. | 2 / 3 |
Actionability | Provides fully executable CLI commands with clear parameter documentation, a complete parameter table with defaults, and concrete examples. The quick check commands and usage example are copy-paste ready. | 3 / 3 |
Workflow Clarity | Clear 5-step workflow with explicit validation (step 2), fallback handling (step 5), and a structured fallback template. Error handling section covers NaN values, missing inputs, and scope violations with specific recovery actions. | 3 / 3 |
Progressive Disclosure | Content is reasonably organized with clear sections, but the skill is somewhat monolithic - the response template, output requirements, and workflow sections could potentially be split into a separate reference file. The references link exists but content organization could be tighter. | 2 / 3 |
Total | 10 / 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 | |
ca9aaa4
Table of Contents
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.