CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ngs-shotgun-metagenomics

Kick off public shotgun metagenomics QC, host-depletion, taxonomic profiling, and functional profiling workflows using nf-core/taxprofiler, Kraken2, Bracken, MetaPhlAn, and HUMAnN.

64

Quality

80%

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 ./plugins/ngs-analysis/skills/ngs-shotgun-metagenomics/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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, executable skill body: concrete commands for every execution path, real validation checkpoints for a batch pipeline, and lean prose with no padding. The main growth areas are making the workflow order explicit and tightening the dense visualization/artifact listings.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no tool or concept explanations — with only minor trimming opportunities, chiefly the single long changelog-style sentence in Visualization Outputs ('run_shotgun_metagenomics.py now also merges...'). It is not 5 because that paragraph and some dense artifact listings do not quite reach 'every token earns its place', and not 3 because there is no real padding or over-explanation.

4 / 5

Actionability

Concrete, executable bash commands are given for every major path: preflight with --emit-install-plan, the FASTQ assay package, the backend runner with full flags (--kraken-db, --host-reference, --run-bracken, --run-humann, --metadata), the nf-core invocation, and a direct Kraken2 skeleton. It falls short of 5 only because commands depend on placeholder database paths and sample-sheet values that must be filled per environment.

4 / 5

Workflow Clarity

Sections follow a logical sequence (confirm inputs → preflight → local FASTQ package → backend profiling → outputs) and validation checkpoints are explicit despite this being a batch operation: preflight install plan, read-path validation, recorded database/tool blockers, and 'not_available' statuses instead of implied success, so the missing-validation cap does not apply. It is not 5 because the sequence is implicit in section order rather than an explicit ordered workflow with feedback loops.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and this ~100-line single-file skill keeps all content appropriately inline with well-organized sections and no references to missing bundle files. It is not 5 because the inline artifact-path lists (tables/..., visualizations/...) and the visualization paragraph are borderline material that could be split out; not 3 because nothing clearly belongs in a separate file at this size.

4 / 5

Total

16

/

20

Passed

Description

75%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, specific description with concrete actions and highly distinctive tool triggers. Its main weakness is the absence of any 'Use when...' clause, which both caps completeness and slightly weakens natural trigger coverage.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user mentions shotgun metagenomics, metagenomic FASTQs, taxonomic profiling, Kraken2, Bracken, MetaPhlAn, HUMAnN, or taxprofiler.'

Add common user synonyms such as 'metagenomic sequencing', 'microbiome profiling', or 'taxonomic classification' to broaden natural trigger matching.

Consider trimming to the highest-value triggers so the added 'when' guidance does not push the description past a natural length.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'QC, host-depletion, taxonomic profiling, and functional profiling' — and names the exact tools ('nf-core/taxprofiler, Kraken2, Bracken, MetaPhlAn, and HUMAnN'), giving comprehensive coverage of the domain's capabilities. It exceeds the 4 anchor because there are no meaningful gaps in the action coverage for this domain.

5 / 5

Completeness

The 'what' is clear (kick off QC/host-depletion/taxonomic/functional profiling workflows), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Good keyword coverage: 'shotgun metagenomics', 'QC', 'host-depletion', 'taxonomic profiling', 'functional profiling', plus distinctive tool names users would naturally say. A few natural terms are missing — e.g. 'metagenomic sequencing', 'microbiome', 'taxonomic classification', or file extensions like .fastq — so it falls short of the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

'Shotgun metagenomics' combined with tool-specific triggers (Kraken2, Bracken, MetaPhlAn, HUMAnN, nf-core/taxprofiler) carves out a clear niche with minimal overlap risk against other skills. Only a hypothetical amplicon/16S metagenomics skill could overlap, which is negligible.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/ngs-analysis/skills/ngs-shotgun-metagenomics/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.