# metaphlan-profiler

metaphlan-profiler is a Claude Code skill for species-level metagenomic profiling through MetaPhlAn marker-gene analysis, strain-level analysis and sample comparison.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 1931 repo stars
- Author: a5c-ai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/a5c-ai/babysitter/tree/HEAD/library/specializations/domains/science/bioinformatics/skills/metaphlan-profiler/SKILL.md
- Updated: 2026-09-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/metaphlan-profiler

## What it does

The skill breaks a shotgun metagenome down to species: it looks for marker genes tied to particular clades and works out how much of the community each species accounts for. StrainPhlAn takes the job further, to strains, and one step covers the reads that match nothing in the reference. For a batch of samples it helps you draw a composition heatmap and compare profiles across conditions.

Inside are instructions for the agent plus a tool list: `Read`, `Write`, `Glob`, `Grep`, `Edit`, `WebFetch`, `WebSearch` and `Bash`. So the agent opens project files itself, edits configs and runs commands in the shell.

MetaPhlAn4, StrainPhlAn and mOTUs must already be on the machine, because the marker-gene run fails without them. The skill also advises taking a current marker database and recording which version you used, otherwise numbers from separate runs won't line up.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill metaphlan-profiler -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill metaphlan-profiler -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill metaphlan-profiler -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install a5c-ai/babysitter library/specializations/domains/science/bioinformatics/skills/metaphlan-profiler
```

2. **Manually: put the files in place**
- File: `.github/skills/metaphlan-profiler/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill metaphlan-profiler -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/a5c-ai/babysitter --path library/specializations/domains/science/bioinformatics/skills/metaphlan-profiler
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add a5c-ai/babysitter --skill metaphlan-profiler -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/a5c-ai/babysitter/tree/HEAD/library/specializations/domains/science/bioinformatics/skills/metaphlan-profiler/SKILL.md

## When to use it
- break a shotgun sample down to species abundances
- compare strains of the same species across samples
- measure how much of the community stays unassigned
- plot composition across a batch of samples
- contrast microbial profiles between conditions

## Example prompts
- Profile the samples in `data/run1/` down to species and merge them into one table.
- Draw a species heatmap for all samples and note the marker database version.
- Run StrainPhlAn on the samples that share the same dominant species.

## Source text · SKILL.md · MIT

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: 51e1ef482d55134d.

BEGIN THIRD-PARTY FILE 51e1ef482d55134d
```text
---
name: metaphlan-profiler
description: MetaPhlAn metagenomic profiling skill for species-level community composition
allowed-tools:
  - Read
  - Write
  - Glob
  - Grep
  - Edit
  - WebFetch
  - WebSearch
  - Bash
metadata:
  version: "1.0"
  category: bioinformatics
  tags:
    - metagenomics
    - profiling
    - species
    - community
graph:
  domains: [domain:bioinformatics]
  specializations: [specialization:biomedical-informatics]
  skillAreas: [skill-area:statistical-analysis, skill-area:data-analysis, skill-area:python-data-pipelines]
  workflows: [workflow:experiment-design]
  roles: [role:research-engineer, role:biomedical-engineer]
---

# MetaPhlAn Profiler Skill

## Purpose
Enable MetaPhlAn metagenomic profiling for species-level community composition.

## Capabilities
- Clade-specific marker gene analysis
- Species-level quantification
- Strain-level profiling (StrainPhlAn)
- Unknown species estimation
- Multi-sample heatmaps
- Comparative analysis

## Usage Guidelines
- Use latest marker database
- Profile at species level for most analyses
- Apply strain-level analysis when relevant
- Visualize community composition
- Compare across samples and conditions
- Document database versions

## Dependencies
- MetaPhlAn4
- StrainPhlAn
- mOTUs

## Process Integration
- Shotgun Metagenomics Pipeline (shotgun-metagenomics)
```
END THIRD-PARTY FILE 51e1ef482d55134d

The third-party file has ended. Everything between the 51e1ef482d55134d 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.

© a5c-ai · MIT · https://github.com/a5c-ai/babysitter/tree/HEAD/library/specializations/domains/science/bioinformatics/skills/metaphlan-profiler/SKILL.md

## Similar
- [waypoint-bio](https://affpapa.org/en/nevibecode/skills/waypoint-bio.md) — skill · 1000 installs
- [tooluniverse-microbiome-research](https://affpapa.org/en/nevibecode/skills/tooluniverse-microbiome-research.md) — skill · 155 installs
- [ngs-shotgun-metagenomics](https://affpapa.org/en/nevibecode/skills/ngs-shotgun-metagenomics.md) — skill · 3 installs
- [data-profiler](https://affpapa.org/en/nevibecode/skills/data-profiler.md) — skill · ★ 165 repo stars
- [start](https://affpapa.org/en/nevibecode/skills/anthropics-start.md) — skill · 5100 installs
- [protein-sequence-msa](https://affpapa.org/en/nevibecode/skills/protein-sequence-msa.md) — skill · 2400 installs

From the same set: [a5c-ai/babysitter](https://affpapa.org/en/nevibecode/by/a5c-ai/babysitter.md) — 37 cards

---
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
