CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

scikit-bio

Biological data toolkit. Sequence analysis, alignments, phylogenetic trees, diversity metrics (alpha/beta, UniFrac), ordination (PCoA), PERMANOVA, FASTA/Newick I/O, for microbiome analysis.

Quality

78%

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 ./skills/scikit-bio/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-organized, high-signal reference body: concrete code patterns, honest labeling of template examples, thorough validation and scientific-pitfall notes, and correctly deferred bulk API detail in a one-level-deep reference bundle. The main improvement levers are tightening the redundant bullet lists and moving some inlined API detail into the existing reference file.

Suggestions

Trim or collapse the 'When to Use This Skill' bullet list and per-section 'Key capabilities' bullets, which largely restate the description and the code that immediately follows.

Move version-migration detail (renames, removed APIs like the SSW wrapper) into a consolidated 'Deprecated/renamed APIs' section in references/api_reference.md, keeping only active patterns in SKILL.md.

Give the placeholder-based snippets (nj(distance_matrix), permanova(dm, grouping)) minimal self-contained constructions so the most common workflows are fully copy-paste executable.

DimensionReasoningScore

Conciseness

The body is code-heavy and dense with non-obvious version-specific facts ('renamed from otu_ids in 0.6.0', 'replaces the removed SSW wrapper', 'default 10 fails when n < 10 in 0.7.4'), with deprecation guidance properly quarantined in 'Important notes' rather than free-roaming. Minor trimming is possible — the 10-bullet 'When to Use' list restates the description and per-section 'Key capabilities' bullets partially duplicate the code — which fits the score-4 anchor (minor instances of over-explanation) rather than the lean score-5 anchor.

4 / 5

Actionability

Most snippets are executable with real signatures, literal sequences, seeds, and named parameters (e.g., the pair_align and ProteinEmbedding examples), but several use undefined placeholders such as 'nj(distance_matrix)', 'permanova(distance_matrix, grouping)', and 'counts_matrix' without construction. The skill transparently flags these as 'workflow templates'; that honest framing plus mostly concrete code fits the score-4 anchor, short of the uniformly copy-paste-ready score-5 anchor.

4 / 5

Workflow Clarity

Four explicit step chains in 'Common Workflows' (e.g., 'Read BIOM table → Calculate alpha/beta diversity → Ordination (PCoA) → Statistical testing (PERMANOVA)') plus pervasive validation guidance ('Reject empty samples explicitly', 'Align sample IDs first', 'Record seed and versions', 'Inspect warnings and retained variance'). Checkpoints are distributed in notes rather than embedded as gated validate-then-proceed steps in the workflows, so it matches the score-4 anchor (clear sequence, most checkpoints present) rather than the score-5 anchor with explicit feedback loops.

4 / 5

Progressive Disclosure

Both bundle references are real, clearly signaled, and one level deep: a dedicated 'Reference Documentation' section enumerates what references/api_reference.md (778 lines) covers, and the Overview links references/review.md for evidence and boundaries. The 470-line body is well-sectioned but still carries per-section API detail that could migrate to the reference file, placing it at the score-4 anchor ('good structure; most content appropriately placed; minor organization gaps') rather than the clean-overview score-5 anchor.

4 / 5

Total

16

/

20

Passed

Description

71%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 specific, jargon-rich description that comprehensively names the library's capabilities and carves out a distinctive microbiome-analysis niche. Its main weakness is the absence of any explicit 'Use when...' trigger clause, which both caps completeness and leaves some natural user phrasings unsurfaced.

Suggestions

Append an explicit trigger clause, e.g. 'Use when analyzing microbiome or amplicon data (16S/ASV tables), computing alpha/beta diversity or UniFrac distances, running PERMANOVA/ANOSIM, or building phylogenetic trees with scikit-bio.'

Add natural user phrasings and formats as trigger terms: 'beta diversity', '16S', 'amplicon', 'BIOM tables (.biom)', 'Newick (.nwk)', and 'QIIME 2' workflows.

Consider naming 'scikit-bio' in the description itself rather than only in the name field, to reduce confusion with other sequence-analysis libraries.

DimensionReasoningScore

Specificity

The description enumerates many concrete capabilities ('Sequence analysis, alignments, phylogenetic trees, diversity metrics (alpha/beta, UniFrac), ordination (PCoA), PERMANOVA, FASTA/Newick I/O'), matching the comprehensive multi-action anchor. Coverage spans the toolkit's core surface rather than leaving minor gaps, so it is not the score-4 anchor.

5 / 5

Completeness

The 'what' is clear and specific, but there is no 'Use when...' clause or equivalent explicit trigger guidance — only the weakly implied 'for microbiome analysis'. Per the judging guideline, a missing 'Use when' clause caps completeness at 3; 'when' is not explicit enough for 4.

3 / 5

Trigger Term Quality

Natural domain terms users would say are present ('alignments', 'phylogenetic trees', 'UniFrac', 'PERMANOVA', 'FASTA', 'microbiome analysis'), but common variations are missing — no '16S', 'amplicon', 'BIOM', 'QIIME', spelled-out 'beta diversity', or file extensions. Good coverage with a few natural terms missing fits the score-4 anchor, not the comprehensive score-5 anchor.

4 / 5

Distinctiveness Conflict Risk

UniFrac/PERMANOVA/microbiome signals a clear niche, but the package name is absent from the description itself and generic terms ('Sequence analysis', 'FASTA/Newick I/O') create minor overlap risk with general bioinformatics/sequence-library skills. Mostly distinct with minor overlap risk fits the score-4 anchor, not the minimal-conflict score-5 anchor.

4 / 5

Total

16

/

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

K-Dense-AI/scientific-agent-skills

Path

skills/scikit-bio/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.