CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gsea

Run GSEA on a ranked gene list and produce the enrichment table, running-score table, and enrichment plots.

Quality

72%

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/gsea/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 strong, well-structured reference-style skill: executable commands for both modes, clear scope boundaries, error codes with a triage doc, and a testing recipe. Main weaknesses are the inlined exhaustive argument tables that duplicate the CLI reference and a referenced test dataset that is missing from the bundle.

Suggestions

Trim the plot-mode argument table in SKILL.md to the most-used flags (e.g., --running_file, --enrich_file, --plot_output, --top_n, --geneSetID, --plot_format) and point to references/cli-guide.md or --help for the full styling list.

Ship tests/data/sample_deg_results.csv in the bundle (or correct the path) so the documented smoke test 'Rscript scripts/main.R --input tests/data/sample_deg_results.csv ...' is actually runnable.

Add one explicit checkpoint between analysis and plot mode, e.g., 'Verify Table/enrichGSEA.csv and Table/gsea_running_scores.csv exist before running plot mode' to close the workflow validation gap.

DimensionReasoningScore

Conciseness

The body is well organized with no conceptual over-explanation, but roughly 75 lines are inlined argument tables, including ~55 rows of granular plot-cosmetic flags ('--legend_just_y', '--grid_minor_color', '--NES_label_hjust') that duplicate the CLI reference and could be trimmed or moved to references/cli-guide.md.

3 / 5

Actionability

Both usage modes are given as fully executable copy-paste commands with a concrete input CSV example, enumerated outputs, and a test recipe. However, the smoke-test command and Scope section reference 'tests/data/sample_deg_results.csv', which is not present in the bundle, so the advertised minimal test cannot be run as-is.

4 / 5

Workflow Clarity

Mode selection is unambiguous ('Passing only --input runs analysis mode', 'plot mode takes precedence; analysis mode is skipped and a warning is logged'), and the Testing section provides explicit validation (expected output files, header-only CSV edge case, exit code 0). Minor gap: no explicit checkpoint telling the user to verify analysis outputs exist before invoking plot mode, though error codes cover missing files.

4 / 5

Progressive Disclosure

The 'When to read external files' table at the top is an exemplary navigation aid, and all four referenced targets (references/algorithm.md, scripts/main.R, references/troubleshooting.md, references/cli-guide.md) exist one level deep. The exhaustive plot-mode argument table inlined in SKILL.md is content that belongs in the already-existing cli-guide.md, keeping this short of a 5.

4 / 5

Total

15

/

20

Passed

Description

66%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 concise, third-person, concrete description that names specific deliverables and a distinct bioinformatics niche. Its main deficiency is the missing 'when to use' trigger clause, plus the absence of the expanded term 'gene set enrichment analysis' that would broaden natural-language matching.

Suggestions

Append an explicit trigger clause, e.g., 'Use when the user has a ranked or differentially expressed gene list and asks for gene set enrichment analysis, GSEA plots, or pathway enrichment results.'

Spell out the acronym once ('GSEA (gene set enrichment analysis)') so users who type the full method name match the description.

Mention plot-only regeneration ('or regenerate enrichment plots from existing enrichGSEA.csv / gsea_running_scores.csv') to cover the skill's second mode and further sharpen distinctiveness.

DimensionReasoningScore

Specificity

Concrete actions and outputs are named explicitly ('Run GSEA on a ranked gene list', 'produce the enrichment table, running-score table, and enrichment plots'), matching the 'several specific actions; minor gaps' anchor. It is not a 5 because the plot-only mode from existing CSVs — a documented capability of the skill — is not covered.

4 / 5

Completeness

The 'what' is clear (run GSEA, produce the three named deliverables) but there is no 'Use when...' clause or equivalent explicit trigger guidance, so completeness is capped at 3 per the rubric guideline. It is above 2 because the 'what' half is concrete and unambiguous.

3 / 5

Trigger Term Quality

'GSEA', 'ranked gene list', 'enrichment table', and 'enrichment plots' are natural terms a user would say, matching 'good keyword coverage; a few natural terms missing'. It is not a 5 because the expanded phrase 'gene set enrichment analysis' and common synonyms like 'pathway analysis' or 'fgsea' are absent, which costs matches on users who spell out the method name.

4 / 5

Distinctiveness Conflict Risk

GSEA on a ranked gene list is a clear methodological niche with distinct triggers, matching 'mostly distinct; minor overlap risk with closely related skills'. It is not a 5 because the description does not distinguish this from adjacent enrichment analyses (e.g., over-representation analysis or ssGSEA), leaving minor overlap risk with a generic enrichment-analysis skill.

4 / 5

Total

15

/

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/gsea/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.