CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

biopython-alignment

Sequence alignment and alignment file processing with Biopython (Bio.Align/Bio.AlignIO), triggered when you need global/local pairwise alignment, MSA read/write/format conversion, or alignment statistics/filtering.

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 ./scientific-skills/Data Analysis/biopython-alignment/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body delivers executable, well-commented examples for the core alignment tasks, but suffers from redundant sections and a complete failure to surface its own bundle: neither references/alignment.md nor scripts/msa_conservation.py is mentioned anywhere. Tightening the duplicated sections and adding navigation to the bundle would raise both conciseness and progressive disclosure.

Suggestions

Add explicit pointers to the bundle files, e.g., "Full API details: [references/alignment.md](references/alignment.md)" and "Ready-to-run conservation script: scripts/msa_conservation.py", so the 362-line reference is discoverable from the body.

Merge "Key Features" into "When to Use" (or cut it) — the two sections cover nearly identical ground — and trim "Implementation Details" entries that restate what the example code demonstrates, moving extended API behavior into the reference file.

Add a short example for MSA writing/format conversion and threshold filtering, since both are advertised capabilities with no code.

DimensionReasoningScore

Conciseness

Mostly efficient, but "Key Features" bullets substantially restate "When to Use", and "Implementation Details" re-explains what the example code already shows (e.g., "aligner.align(a, b) returns an iterable of alignments sorted by score; use [0]"). This duplication is more than the minor trimming of anchor 4, though there is no padded conceptual tutorial that would warrant 2.

3 / 5

Actionability

Provides a complete, runnable script with imports and three worked examples (global protein alignment, local DNA fragment extraction, MSA conservation). It stops short of 5 because MSA write/format conversion and threshold filtering — advertised in "When to Use" and "Key Features" — have no example code.

4 / 5

Workflow Clarity

Each task is demonstrated with unambiguous, self-contained code, and the body follows a clear section order (When to Use → Features → Dependencies → Examples → Details). Missing an explicit step sequence or verification checkpoint for the multi-task flow keeps it below 5; there is no destructive/batch operation that would cap it at 3.

4 / 5

Progressive Disclosure

The bundle provides references/alignment.md (a 362-line API reference) and scripts/msa_conservation.py, but the body never links to either file, so the references are buried rather than clearly signaled. Meanwhile, API detail that belongs in the reference (PairwiseAligner behavior, gap-score conventions) is inlined under Implementation Details — matching the "references present but not clearly signaled; content that should be separate is inline" anchor.

3 / 5

Total

14

/

20

Passed

Description

87%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 with concrete actions, an explicit trigger clause, and a well-scoped niche. Its only weakness is slightly incomplete coverage of the skill's own advertised capabilities (no mention of substitution matrices or gap-penalty tuning) and missing file-extension keywords.

Suggestions

Add substitution-matrix and gap-penalty tuning to the capability list so the description covers all advertised key features.

Include file-format extensions (e.g., .fasta, .clustal, .stockholm) as trigger terms for users who name files rather than tasks.

DimensionReasoningScore

Specificity

Lists several concrete actions — "global/local pairwise alignment, MSA read/write/format conversion, or alignment statistics/filtering" — with named modules (Bio.Align/Bio.AlignIO). It falls short of 5 only because substitution-matrix/gap-penalty tuning, a claimed key feature of the skill, is absent from the description.

4 / 5

Completeness

Explicitly answers both: what ("Sequence alignment and alignment file processing with Biopython") and when ("triggered when you need global/local pairwise alignment, MSA read/write/format conversion, or alignment statistics/filtering"). The trigger clause is explicit and concrete, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "sequence alignment", "global/local", "MSA", "format conversion", "Biopython". Missing file extensions (.fasta, .clustal, .stockholm) and layman synonyms ("align sequences"), which keeps it below the comprehensive synonym-plus-extension bar of 5.

4 / 5

Distinctiveness Conflict Risk

Scoped to a clear niche by naming the exact library and submodules (Bio.Align/Bio.AlignIO), so it is distinguishable from sibling Biopython or general sequence-analysis skills with minimal conflict risk.

5 / 5

Total

18

/

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

scientific-skills/Data Analysis/biopython-alignment/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.