CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pysam

Genomic file toolkit. Read/write SAM/BAM/CRAM alignments, VCF/BCF variants, FASTA/FASTQ sequences, extract regions, calculate coverage, for NGS data processing pipelines.

61

Quality

77%

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 ./backend/cli/skills/biology/pysam/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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 library skill with exemplary progressive disclosure and executable examples throughout. The main costs are redundant reference-pointer sections and generic capability bullet lists that pad token usage, and the absence of inline validation checkpoints in the body's workflows.

Suggestions

Collapse the per-section "Reference:" blocks, the "### references/" list, and the "Getting Help" routing table into a single navigation point to cut redundant tokens.

Trim the "Common operations" and "Common workflows" bullet lists, which restate capabilities already covered by the code examples and reference documents.

Add one inline workflow with an explicit validation checkpoint (e.g., create index → verify it exists → fetch region → assert read count) so error recovery is visible without opening common_workflows.md.

DimensionReasoningScore

Conciseness

The body is mostly efficient (terse code examples, tight Key Concepts and Pitfalls sections), but there is noticeable redundancy: the four references are pointed to three separate times (per-section "Reference:" blocks, the "### references/" list, and the "Getting Help" routing table), and each "Common operations/workflows" bullet list restates generic pysam capabilities Claude can largely infer. This fits anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") better than anchor 4, where over-explanation would be only minor.

3 / 5

Actionability

Guidance is fully executable and copy-paste ready: `uv pip install pysam`, complete `AlignmentFile`/`VariantFile`/`FastaFile` fetch snippets, concrete index-creation calls (`pysam.index()`, `pysam.faidx()`, `pysam.tabix_index()`), and runnable `pysam.samtools.*` command examples with a try/except error-handling pattern. This matches the top anchor — specific examples cover the common cases.

5 / 5

Workflow Clarity

Preconditions and pitfalls are stated (index-before-fetch, "Without an index, use fetch(until_eof=True)", iterator scope, partial overlaps) and one try/except example exists, but there is no end-to-end workflow with explicit validation checkpoints — the integrated workflows are delegated to references/common_workflows.md without inline sequencing or verify/fix/retry loops. This is anchor 3 ("sequence present but checkpoints missing or implicit") rather than anchor 4's "most checkpoints present".

3 / 5

Progressive Disclosure

SKILL.md is a genuine overview with detail appropriately split into four one-level-deep reference files, all of which exist in references/ and are clearly signaled per-section with content summaries of what each contains. Navigation is easy (overview, capability sections, key concepts, pitfalls, resources); the triple-repeated pointers are a conciseness issue, not a structural one, so this matches the top anchor rather than anchor 4's "minor organization gaps".

5 / 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 concise, highly specific description with strong trigger terms and a clearly distinct niche, undermined only by the missing explicit 'Use when...' guidance, which caps completeness at 3. Adding a trigger clause with common synonyms would lift it to the level of the good overall examples.

Suggestions

Add an explicit trigger clause, e.g. "Use when working with sequencing alignments (.bam/.cram), variant files (.vcf/.bcf), or reference sequences (.fasta/.fastq), or when calculating coverage or extracting genomic regions."

Include natural synonyms users say such as "sequencing reads", "genomics", or "bioinformatics pipelines" alongside the format names.

Drop or tighten the generic opener "Genomic file toolkit." since the action list already conveys the domain.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive format coverage: "Read/write SAM/BAM/CRAM alignments, VCF/BCF variants, FASTA/FASTQ sequences, extract regions, calculate coverage". Each action is specific and executable in nature, matching the top anchor; nothing is vague beyond the brief "Genomic file toolkit" opener, which merely names the domain.

5 / 5

Completeness

The "what" is clearly answered (specific read/write/extract/coverage actions on named formats), but there is no explicit "Use when..." clause; the trailing "for NGS data processing pipelines" only weakly implies the "when". The judging guideline caps completeness at 3 for a missing 'Use when...' clause or equivalent explicit trigger guidance.

3 / 5

Trigger Term Quality

Good natural keyword coverage — users would say "SAM", "BAM", "CRAM", "VCF", "FASTA", "FASTQ", "coverage", "NGS" — but a few natural terms are missing (e.g., "sequencing reads", "bioinformatics", file extensions like ".bam"/".vcf"). Per the boundary guidance this sits between anchor 3 and 5: better than "some relevant keywords" yet not the fully comprehensive synonym-plus-extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The format names (SAM/BAM/CRAM, VCF/BCF, FASTA/FASTQ) form a clear genomic-file niche with distinct, unambiguous triggers that virtually no other skill would claim. This matches the "clear niche with distinct triggers; minimal conflict risk" anchor and is clearly better than the "minor overlap risk" anchor 4.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/biology/pysam/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.