aiming-lab/autoresearchclaw/flux-analyzer
Claude Code and agent skill by aiming-lab/autoresearchclaw
- community
Checking that the SKILL.md file is still in the repository.
Analyse FBA flux distributions to extract biological insights. Covers gene essentiality, phenotypic phase planes, flux sampling, pathway-level aggregation, secretion product prediction, and production of publication- quality figures.
Install
npx vskill@latest install aiming-lab/autoresearchclaw/flux-analyzerSKILL.md
Overview
The flux-analyzer skill transforms raw FBA output into actionable biological knowledge. It operates on FBA result files and the COBRApy model to produce gene essentiality maps, phenotypic phase planes (PPP), flux sampling distributions, pathway-level summaries, and product secretion profiles.
This skill is the metabolic-modelling analogue of event reconstruction and phenomenology summary stage in the ColliderAgent pipeline: it turns numbers into biology.
Workflow
Step 1 — Load Model and FBA Results
Step 2 — Gene Essentiality Analysis
Essential genes are those whose deletion reduces growth to below 5% of wild-type — a widely used lethality criterion.
Step 3 — Reaction Essentiality Analysis
Step 4 — Phenotypic Phase Plane (PPP)
The PPP maps growth rate over a 2D grid of two nutrient uptake rates, revealing metabolic phase transitions (aerobic growth, mixed-acid fermentation, etc.).
Step 5 — Flux Sampling
Flux sampling explores the full space of feasible steady-state flux distributions, revealing which reactions have wide vs. narrow feasible ranges.
Step 6 — Pathway-Level Flux Aggregation
Group reactions by metabolic subsystem and compute total absolute flux per pathway — a proxy for pathway activity.
Step 7 — Secretion Product Prediction
Identify exchange reactions carrying positive flux (secretion) at optimal growth — these are by-products and potential products of interest.
Key Conventions
| Analysis | Lethality Threshold | Standard Reference | |
|---|---|---|---|
| Single gene deletion | growth < 5% WT | Joyce & Palsson, 2006 | |
| Double gene deletion (synthetic lethal) | growth < 5% WT | Deutscher et al., 2008 | |
| Reaction deletion | growth < 5% WT | Consistent with gene deletion | |
| PPP nutrient grid | 0–20 mmol/gDW/h, 50 steps | COBRApy default | |
| Flux sampling (OptGP) | n = 1000, thinning = 100 | Megchelenbrink et al., 2014 |
Output File Conventions
| File | Content | |
|---|---|---|
gene_essentiality.csv | Per-gene growth fraction and essentiality flag | |
double_gene_essentiality.csv | Pairwise synthetic lethality matrix | |
reaction_essentiality.csv | Per-reaction growth fraction and essentiality flag | |
phenotypic_phase_plane.pdf | 2D heatmap of growth vs. two nutrients | |
flux_samples.csv | Raw 1000-sample flux matrix | |
flux_sampling_violin.pdf | Violin plot of key reaction distributions | |
pathway_flux_summary.csv | Total absolute flux per metabolic subsystem | |
pathway_activity.pdf | Bar chart of top 15 active pathways | |
secretion_profile.csv | All secreted by-products at optimal growth |
Common Failure Modes
- PPP returns all zeros: objective reaction ID does not match model; check
model.objective.expression for correct reaction ID.
- Flux sampling ACHR crashes:
optgp(default) is more stable for large
models; for models with >5000 reactions use processes=1 to debug.
- No secretion products: model may be forced to be strictly aerobic with
all carbon converted to CO2; verify exchange bounds allow secretion (ub = 1000 on exchange reactions).
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingexternal/agents/Biology-Agent/skills/flux-analyzer/SKILL.md
Popularity
- Repository stars
- 14,030
- Repository forks
- 1,639
- 7-day trend score
- 48
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 15 Aug 2026, 2 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/aiming-lab/autoresearchclaw/flux-analyzer)