CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gsva-analysis-and-visualization

Use this skill to run GSVA or ssGSEA pathway-level differential analysis from a bulk expression matrix and a sample group file, then generate a heatmap from the saved GSVA result object. Trigger keywords: GSVA, ssGSEA, pathway enrichment, KEGG pathway analysis, MSigDB. NOT for: gene-level differential expression, single-cell analysis, methylation analysis, clinical diagnosis.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./awesome-med-research-skills/Data Analysis/gsva-analysis-and-visualization/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

A well-structured, highly actionable CLI skill body with clear mode semantics, validated workflow steps, and a genuine error-recovery loop. Its main weaknesses are token bulk (full argument table inline, authoring checklist) and a systematic break in its demo path: every reference to tests/ files points at resources absent from the bundle.

Suggestions

Ship the referenced test bundle (tests/data/expr_matrix.csv, tests/data/group.csv, tests/run_tests.R, tests/test_skill.R) or rewrite the Usage, Testing, and 'When to Read External Files' sections to use user-supplied file placeholders — the canonical example currently fails on first run.

Move the bulk of the 40-row Arguments table into references/cli-guide.md and keep only the frequently-tuned flags (mode, input, groups, method, output_dir) inline to cut tokens.

Delete or relocate the 'Implementation Checklist' and academic 'References' sections; they are authoring-time artifacts and known literature that add context cost without execution value.

DimensionReasoningScore

Conciseness

The body is mostly efficient — dense tables, no concept-explainer padding — but it can be tightened: the 40-row Arguments table duplicates detail that references/cli-guide.md exists for, and the authoring-time 'Implementation Checklist' ('get_script_dir() defined before any call to it', 'Documented parameters match script') plus the academic citation list add tokens that do not help execution. Not a 2 because there is no padded explanation of concepts Claude already knows.

3 / 5

Actionability

Commands are copy-paste ready (Rscript scripts/main.R with full flags), input formats are shown as concrete CSV examples, and the Error Handling table gives per-code solutions. The gap: the headline Usage example and Testing section depend on tests/data/expr_matrix.csv, tests/data/group.csv, tests/run_tests.R, and tests/test_skill.R, none of which exist in the bundle, so the canonical command fails out of the box. Still mostly executable rather than high-level, so above anchor 3.

4 / 5

Workflow Clarity

The Workflow section opens with explicit validation (check files, validate columns and matching sample names, validate CLI ranges), states the visualize-mode prerequisite with its error code, and the Error Handling table provides an error-to-fix-to-rerun recovery loop. Anchor 5 is withheld because the documented verification path (tests/run_tests.R and its expected outputs) references files missing from the bundle.

4 / 5

Progressive Disclosure

The 'When to Read External Files' table maps situations to real, one-level-deep references (references/algorithm.md, cli-guide.md, troubleshooting.md, scripts/main.R all verified present), and the Method Selection Guide and error sections point onward clearly. Minor gaps: the body references a bundled tests/data/ directory and test scripts that do not exist, and the full argument table is inlined where cli-guide.md could carry the bulk.

4 / 5

Total

15

/

20

Passed

Description

83%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 concrete actions with their inputs and outputs, provides explicit enumerated trigger keywords and negative scope boundaries. The only notable gaps are a few missing natural trigger terms (heatmap, gene set enrichment) and the broadness of 'pathway enrichment' relative to sibling enrichment skills.

DimensionReasoningScore

Specificity

The description names two concrete, input-specified actions ('run GSVA or ssGSEA pathway-level differential analysis from a bulk expression matrix and a sample group file', 'generate a heatmap from the saved GSVA result object'), but coverage stops short of the limma comparison and saved output tables. It is more specific than the anchor-3 example yet not comprehensive enough for anchor 5.

4 / 5

Completeness

It explicitly answers both what (run GSVA/ssGSEA pathway-level differential analysis from a bulk expression matrix and sample group file, then generate a heatmap from the saved result object) and when, via an enumerated 'Trigger keywords:' list plus a 'NOT for' exclusion list. Equivalent explicit trigger guidance is present, so the missing-'Use when' cap does not apply.

5 / 5

Trigger Term Quality

'GSVA, ssGSEA, pathway enrichment, KEGG pathway analysis, MSigDB' are natural terms a user would say, giving good keyword coverage. Not a 5 because common variations like 'heatmap', 'gene set enrichment', and 'enrichment scores' are missing even though visualization is a core mode.

4 / 5

Distinctiveness Conflict Risk

The niche is clear with highly distinctive primary triggers (GSVA, ssGSEA) and an explicit NOT-for fence against gene-level DE, single-cell, methylation, and clinical use. Minor overlap remains because 'pathway enrichment' and 'KEGG pathway analysis' are broad terms shared with other enrichment skills.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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

awesome-med-research-skills/Data Analysis/gsva-analysis-and-visualization/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.