# tooluniverse-microbial-genome-characterization

tooluniverse-microbial-genome-characterization — a skill for Claude Code, Codex, Cursor and other agents that queries NCBI Datasets to retrieve genome assemblies and their quality metrics: N50, GC content, assembly level, contig count.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 117 installs · ★ 1798 repo stars
- Author: mims-harvard
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/mims-harvard/ToolUniverse/tree/HEAD/skills/tooluniverse-microbial-genome-characterization/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tooluniverse-microbial-genome-characterization

## What it does

The skill resolves an organism name or taxid to a list of assemblies, selects the reference or highest-quality one, and pulls QC metrics: total sequence length, contig and scaffold N50, number of contigs, GC percent, assembly level, and RefSeq category. It then maps replicons — chromosomes and plasmids — with their RefSeq/GenBank accessions and lengths. Everything goes through five keyless NCBI Datasets tools.

When comparing multiple assemblies, the skill builds a pandas table and ranks candidates by completeness and contiguity rather than just describing what it would do. For accession-level lookups, `NCBIDatasets_get_genome_assembly` returns the full QC block; `NCBIDatasets_get_sequence_reports` gives the per-replicon breakdown used to count plasmids.

Gene-level orthology and synteny are out of scope here — that belongs to `tooluniverse-comparative-genomics`. Plant gene structure goes to `tooluniverse-plant-genomics`. De novo assembly from raw sequencing reads is not covered by any ToolUniverse skill.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-microbial-genome-characterization -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tooluniverse-microbial-genome-characterization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tooluniverse-microbial-genome-characterization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-microbial-genome-characterization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tooluniverse-microbial-genome-characterization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-microbial-genome-characterization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tooluniverse-microbial-genome-characterization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mims-harvard/ToolUniverse skills/tooluniverse-microbial-genome-characterization
```

2. **Manually: put the files in place**
- File: `.github/skills/tooluniverse-microbial-genome-characterization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-microbial-genome-characterization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/mims-harvard/ToolUniverse --path skills/tooluniverse-microbial-genome-characterization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tooluniverse-microbial-genome-characterization/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add mims-harvard/ToolUniverse --skill tooluniverse-microbial-genome-characterization -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/mims-harvard/ToolUniverse/tree/HEAD/skills/tooluniverse-microbial-genome-characterization/SKILL.md

## When to use it
- Find the reference genome assembly for a bacterium or archaeon by taxon name
- Retrieve N50, GC content and assembly level for a specific GCF_/GCA_ accession
- Count how many plasmids a given strain carries
- Rank assemblies of one species by completeness and contiguity
- Determine whether an accession is a Complete Genome or a draft contig set

## Example prompts
- Find the reference genome for Escherichia coli and show its N50 and GC content
- List all replicons in GCF_000005845.2 — how many plasmids does it have?
- Compare the top three Staphylococcus aureus assemblies by completeness and pick the best

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 06353d32967e98fa.

BEGIN THIRD-PARTY FILE 06353d32967e98fa
```text
---
name: tooluniverse-microbial-genome-characterization
description: Genome-ASSEMBLY discovery, QC, and replicon mapping for any organism (bacteria, archaea, fungi, and beyond) using NCBI Datasets. Resolves an organism name or taxid to assemblies, picks the reference/representative or best-quality assembly, pulls assembly QC metrics (total length, contig/scaffold N50, contig count, GC%, assembly level, RefSeq category), enumerates chromosomes and plasmids via per-replicon sequence reports, and compares candidate assemblies on quality. Use for "what genomes are available for [organism]", "assembly stats / N50 / GC content for [GCF_/GCA_ accession]", "how many plasmids does [strain] have", "compare assemblies for [species]", "find the reference genome for [taxon]", "is this assembly Complete Genome or just contigs". NOT for gene-level orthology/synteny (use tooluniverse-comparative-genomics), plant gene structure (use tooluniverse-plant-genomics), de novo assembly from raw reads (no tool exists), or taxonomy-only name/lineage lookups.
disable-model-invocation: true
---

# Microbial Genome Assembly Characterization & QC

Discover, quality-control, and structurally map genome ASSEMBLIES for any organism using the keyless NCBI Datasets genome tools. Organism/taxon in → assembly inventory, QC metrics, and chromosome/plasmid map out.

## LOOK UP, DON'T GUESS
When uncertain about an accession, assembly level, replicon count, or N50, CALL the tool. Never report assembly statistics from memory — accessions and metrics change with each RefSeq release. A live NCBI Datasets answer is always more reliable than a guess.

## COMPUTE, DON'T DESCRIBE
```
END THIRD-PARTY FILE 06353d32967e98fa

The third-party file has ended. Everything between the 06353d32967e98fa tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 1665 of 13050 bytes. © mims-harvard · Apache-2.0 · https://github.com/mims-harvard/ToolUniverse/tree/HEAD/skills/tooluniverse-microbial-genome-characterization/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
