SkillAgentSearch skills...

bio-format-conversion

Convert between sequence file formats (FASTA, FASTQ, GenBank, EMBL) using Biopython Bio.SeqIO

Install / Use

npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-format-conversion

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

83/100

Supported Platforms

Universal

Our assessment of bio-format-conversion

bio-format-conversion scores 83/100 on our quality scale, 3086th of 4,698 Development & Engineering skills we index.

Its SKILL.md is 5.8 KB long, well organised into 19 sections with 11 code examples: a solid amount of guidance for an agent.

With 3,034 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
20/20
Description
12/15
Adoption
15/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-11-07 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 86/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

bio-format-conversion compared with similar skills

All 4 of these similar skills score higher than bio-format-conversion; compare them before choosing.

SkillScoreStarsUpdatedFormat
bio-format-conversion (this skill)by FreedomIntelligence833.0k4mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md

Frequently asked questions

How do I install bio-format-conversion?
Run npx skills add FreedomIntelligence/OpenClaw-Medical-Skills --skill bio-format-conversion. The install tabs above show the steps for each supported agent.
Which AI agents does bio-format-conversion work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is bio-format-conversion safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 86/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is bio-format-conversion still maintained?
The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

name: bio-format-conversion description: Convert between sequence file formats (FASTA, FASTQ, GenBank, EMBL) using Biopython Bio.SeqIO. Use when changing file formats or preparing data for different tools. tool_type: python primary_tool: Bio.SeqIO

Version Compatibility

Reference examples tested with: BioPython 1.83+, samtools 1.19+

Before using code patterns, verify installed versions match. If versions differ:

  • Python: pip show <package> then help(module.function) to check signatures

If code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying.

Format Conversion

"Convert this file to a different format" → Read records in one format, optionally add missing annotations, and write in the target format.

  • Python: SeqIO.convert() for direct conversion, or SeqIO.parse() + SeqIO.write() when modifications are needed (BioPython)
  • CLI: seqkit seq (SeqKit) for FASTA/FASTQ; samtools view for SAM/BAM/CRAM

Convert sequence files between formats using Biopython's Bio.SeqIO module.

Required Import

from Bio import SeqIO

Core Function

SeqIO.convert() - Direct Conversion

Convert between formats in a single call. Most efficient method.

count = SeqIO.convert('input.gb', 'genbank', 'output.fasta', 'fasta')
print(f'Converted {count} records')

Parameters:

  • in_file - Input filename or handle
  • in_format - Input format string
  • out_file - Output filename or handle
  • out_format - Output format string

Returns: Number of records converted

Common Conversions

| From | To | Notes | |------|-----|-------| | GenBank | FASTA | Loses annotations, keeps sequence | | FASTA | GenBank | Need to add molecule_type | | FASTQ | FASTA | Loses quality scores | | FASTA | FASTQ | Need to add quality scores | | GenBank | EMBL | Usually works directly | | Stockholm | FASTA | Alignment to sequences |

Code Patterns

Simple Conversion

SeqIO.convert('input.gb', 'genbank', 'output.fasta', 'fasta')

GenBank to FASTA

SeqIO.convert('sequence.gb', 'genbank', 'sequence.fasta', 'fasta')

FASTQ to FASTA (drop quality)

SeqIO.convert('reads.fastq', 'fastq', 'reads.fasta', 'fasta')

FASTA to GenBank (requires molecule_type)

Goal: Convert FASTA to GenBank format, which requires molecule_type annotation.

Approach: Stream records through a generator that injects the missing annotation, then write.

Reference (BioPython 1.83+):

records = SeqIO.parse('input.fasta', 'fasta')
def add_molecule_type(records):
    for record in records:
        record.annotations['molecule_type'] = 'DNA'
        yield record

SeqIO.write(add_molecule_type(records), 'output.gb', 'genbank')

FASTA to FASTQ (add dummy quality)

Goal: Convert FASTA to FASTQ by assigning uniform placeholder quality scores.

Approach: Stream records through a generator that adds phred_quality to each, then write as FASTQ.

Reference (BioPython 1.83+):

def add_quality(records, quality=30):
    for record in records:
        record.letter_annotations['phred_quality'] = [quality] * len(record.seq)
        yield record

records = SeqIO.parse('input.fasta', 'fasta')
SeqIO.write(add_quality(records), 'output.fastq', 'fastq')

Batch Convert Multiple Files

Goal: Convert all files of one format in a directory to another format.

Approach: Glob for input files, apply SeqIO.convert() to each, and report per-file counts.

Reference (BioPython 1.83+):

from pathlib import Path

for gb_file in Path('.').glob('*.gb'):
    fasta_file = gb_file.with_suffix('.fasta')
    count = SeqIO.convert(str(gb_file), 'genbank', str(fasta_file), 'fasta')
    print(f'{gb_file.name}: {count} records')

Convert with Modifications

from Bio.Seq import Seq
from Bio.SeqRecord import SeqRecord

def uppercase_record(rec):
    return SeqRecord(rec.seq.upper(), id=rec.id, description=rec.description)

records = SeqIO.parse('input.fasta', 'fasta')
modified = (uppercase_record(rec) for rec in records)
SeqIO.write(modified, 'output.fasta', 'fasta')

Alignment Format Conversion

from Bio import AlignIO

AlignIO.convert('alignment.sto', 'stockholm', 'alignment.phy', 'phylip')

Format Compatibility Matrix

Can convert directly (no modifications needed):

  • GenBank <-> EMBL
  • FASTA -> any format (may need annotations added)
  • Any format -> FASTA (always works, may lose data)
  • FASTQ -> FASTA

Requires adding data:

  • FASTA -> FASTQ (need quality scores)
  • FASTA -> GenBank (need molecule_type)

May lose data:

  • GenBank -> FASTA (loses features, annotations)
  • FASTQ -> FASTA (loses quality scores)
  • Any rich format -> FASTA

Common Errors

| Error | Cause | Solution | |-------|-------|----------| | ValueError: missing molecule_type | FASTA to GenBank | Add molecule_type annotation | | ValueError: missing quality scores | FASTA to FASTQ | Add phred_quality to letter_annotations | | KeyError: 'phred_quality' | Wrong FASTQ variant | Try 'fastq-sanger', 'fastq-illumina' |

Decision Tree

Converting formats?
├── Simple conversion (no data changes)?
│   └── Use SeqIO.convert() directly
├── Need to add annotations?
│   └── Parse, modify records, then write
├── Need to transform sequences?
│   └── Parse, apply transformation, then write
└── Multiple files?
    └── Loop with SeqIO.convert() or batch generator

Related Skills

  • read-sequences - Parse sequences for custom conversion logic
  • write-sequences - Write converted sequences with modifications
  • batch-processing - Convert multiple files at once
  • compressed-files - Handle compressed input/output during conversion
  • alignment-files - For SAM/BAM/CRAM conversion, use samtools view

Related Skills

View on GitHub
GitHub Stars3.0k
CategoryDevelopment
Updated3mo ago
Forks413

Languages

Python

Trust signals

86/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 info