cc-bioinfo · analysis-execution skill · v1.0.4
A framework that does the work —
and proves that it did.
Hand it the design and it builds its own conda environment, writes the analysis, fixes its own errors, produces publication-grade figures and keeps going to an SCI manuscript draft — plenty of skills can say that much now. What it adds is the other half: every step's output must really exist on disk, data must be downloaded rather than generated, a failed quality audit hard-stops the run, and key decisions wait for you. Going to clinic will not interrupt it, and when you come back you can see exactly what it did.
What is bio-analyze?
bio-analyze is a structured knowledge framework: it encodes bioinformatics best practice as structured workflows with hard quality gates, guiding AI through an end-to-end analysis from raw-data quality control to a SCI manuscript draft. It is the downstream execution skill of the cc-bioinfo platform, and one defining characteristic is that the framework itself contains no executable code — it is a 350 KB structured knowledge base, and the analysis code is generated on the spot by the AI and executed in your environment. It sets up a separate Conda environment for every project — projects are isolated from each other and tool versions never clash; during execution it summarises each phase against earlier results and stops for your judgment when results contradict expectations instead of blindly running to the end.
- 84,000+ lines of encoded domain knowledge across 34 knowledge files
- 6 standardized omics pipelines, plus knowledge-base coverage for ATAC-seq, WGCNA and Mendelian randomization
- 26 hours — the longest single uninterrupted run recorded in a real study
- 1,200+ automated tests passing, verified by double mutation testing with zero survivors
How is it different from general skills on Claude Code and similar agents?
Anyone doing bioinformatics today has dozens of skills and platforms to hand, and "no code, runs the analysis for you" is no longer a difference — everyone says it. bio-analyze sits somewhere else: a skill library teaches an AI how to do it right; this one proves the AI actually did it, and did not mislead you. That difference only shows when results look bad, a download fails, or the AI wants a shortcut — and those are exactly the moments that decide whether a paper can be submitted.
| The moment things go wrong | General skill / skill library | bio-analyze |
|---|---|---|
| A data download fails | The AI may generate a "dataset" with a random-number function and carry on — we hit this in our own studies | A provenance layer checks at every step whether input was downloaded or generated; generating simulated data is a critical error that hard-stops |
| The AI says "QC is done" | Saying so is enough; nobody checks | Validators check the artefacts really exist on disk — no positive evidence means failure — enforced by exit codes, not by a reminder in a prompt |
| Results carry a hidden problem | A batch effect rides all the way to the figures | A five-dimension quality audit is inserted before biological interpretation; any critical finding hard-stops and waits for you |
| A critical judgment | Cell-type annotation gets the same effort as renaming a file | Four thinking tiers: nine critical scenarios force a full reasoning chain, then stop for your confirmation |
| The session breaks | A new conversation remembers nothing; you re-explain | A state machine records progress to sub-step level; one command resumes exactly — two API outages in a real run resumed losslessly |
| The result looks bad | Easily dressed up as a positive conclusion | Thresholds and a conclusion wording ceiling are preregistered and locked before work starts; negative results go into the manuscript as they are |
It does not win on breadth and is not trying to: skill libraries cover far more disciplines and tools; this one focuses on six omics pipelines. Nor is it locked to the platform — as a skill it can be installed into Claude Code and run on its own; what the platform adds is a resident, per-project isolated environment, multi-user isolation and a complete audit trail (see How to choose).
Evidence, not adjectives
- Self-repair: in Case 1 a coordinate liftover mapped only 24%; it found that positions had been written in scientific notation, rewrote them as integers and reran to 99.96%. Thirty million false positives traced to p-values stored as strings — also diagnosed by itself, nobody taught it.
- Honesty: in the same study, after screening 1,915 plasma proteins with zero mediators, the manuscript says "downstream markers, not upstream mediators"; where instruments were weak it says "weak instruments", not "no effect".
- The boundary: in Case 7 it executed at publication grade yet raised no challenge to the direction in three days — gates stop fabrication, not a wrong question. That is the place a human cannot be removed from.
- Stamina: the longest single uninterrupted run in a real study was about 26 hours.
So what is left for you to do
Hand to it
- Installing R, Python or Bioconductor — it builds the environment, bootstrapping conda from scratch if needed
- Writing code, reading stack traces, using a command line
- Sitting at the computer — it runs server-side and survives you closing the browser
- Memorising figure standards — 300 DPI, fonts and WCAG-compliant colourblind-safe palettes are checked against your target journal
Keep for yourself
- Confirm the cell-type annotation — the step where AI is most likely to be wrong and domain knowledge most likely to save you
- Look at every figure — Step 4 stops and waits for your review; in real studies the most valuable defects were caught exactly this way
- Judge whether an odd result is biologically plausible
- Verify the manuscript and own the direction — it gives you a draft; scientific accuracy, citations and "is this study worth doing" are yours
An honest sense of the timeline
Traditionally, from data in hand to a first draft takes most people months. On the platform, a comparative study with seven parallel evidence lines across six data layers completed in about 26 hours without interruption; a multi-dataset integration of 314,805 cells with spatial transcriptomics produced six main figures and a complete draft. But that does not mean you can submit two days later — you still need time to verify, to think, to revise. What it removes is the "getting things to run" part, not the "thinking it through" part.
How are quality and data integrity guaranteed?
What this means for you: every number that reaches the paper traces back to a command that really ran and a file that really exists; when the AI reaches for a shortcut it is stopped there, not discovered later in a reviewer's comments.
- The Step 1.5 five-dimension quality audit is inserted mandatorily between the end of computation and the start of biological interpretation: sample identity, batch effects, technical quality, biological plausibility and statistical assumptions. Any critical finding triggers a hard stop.
- Data-integrity iron rules forbid fabricated data, data leakage, silent substitution and raw data leaking into outputs. Generating simulated data is a critical error that halts the workflow outright.
- Executable validators rather than trusting the AI: workflow validation, state reconciliation and a 17-category consistency checker run every round and enforce their verdict through exit codes; the manuscript checker verifies every DOI against Crossref.
- Dual independent review: figures and manuscripts are adversarially re-checked by fresh independent sub-agents playing statistician, domain expert and sceptic — never self-approved.
- A self-learning experience store: 20 common error patterns ship with code-level fixes, and any fix that takes more than two rounds is saved automatically for reuse.
- An SCI figure knowledge base with a visual review loop: a 732-line standards file covering a chart-selection decision tree by sample size, eight bad-chart defences and 15+ reviewer checkpoints. The AI reads each rendered image, and your review gate must pass before the workflow advances.
How does the Step 0 to 7 workflow run?
What this means for you: you only need to show up at two gates — the quality audit and the figure review; the rest of the time it follows one protocol, and where it has got to is always on record.
| Step | What it does | Thinking tier |
|---|---|---|
| Step 0 | Project initialization: detect the omics type, create standard directories, load configuration | Standard |
| Step 1 | Dynamic analysis: multi-stage computation across phases 1 to N | Standard / Deep |
| Step 1.5 | Data quality audit: a five-dimension deep review; any critical finding triggers a hard stop | Ultrathink |
| Step 2 | Reflection: scoring how completely the scientific question was answered, translational assessment | Deep |
| Step 3 | Research summary: distilling core findings, planning figures | Ultrathink |
| Step 4 | Publication figures: SCI-standard output plus a visual review loop (this is where you review) | Deep |
| Step 5 | Technical report: a structured analysis record | Deep |
| Step 6 | Manuscript writing: 21 sub-steps plus five-step pre-submission cross-validation | Ultrathink |
| Step 7 | Submission preparation: DOCX, figure package, cover letter (user-triggered) | Standard |
Once you say "start the analysis" it executes immediately instead of asking "what next?"; fixable errors retry automatically up to three times; phases advance on completion. But the Step 1.5 quality audit and the Step 4 figure review stop and wait for you — those two gates cannot be skipped.
How is the four-tier thinking depth dispatched?
What this means for you: judgments that decide the conclusion — cell-type annotation, batch effects — are never handled with the effort reserved for renaming a file.
The governing idea: not every task deserves the same rigour. Renaming a file does not need a full chain of reasoning; annotating cell types does.
| Tier | Trigger | Behaviour |
|---|---|---|
| Quick | File operations, formatting | Immediate execution |
| Standard | Routine analysis steps | Standard reasoning |
| Deep | Parameter selection, method decisions, batch-effect assessment | Multi-option comparison |
| Ultrathink | Nine critical scenarios | Full chain: observe, hypothesize, validate, conclude |
The nine mandatory Ultrathink scenarios: cell-type annotation, the Step 1.5 quality review, differential expression interpretation, biological conclusion derivation, key manuscript sections, data validation, clustering-resolution selection, batch-effect assessment, and judging anomalous results.
Which omics types and pipelines are supported?
What this means for you: if your data type is in the table, a protocol with fixed mandatory steps and required figures already exists for it, and skipping a step raises a warning in flight.
| Omics type | Platforms and tools | Standard pipeline |
|---|---|---|
| Single-cell RNA-seq | 10x Genomics, Seurat, Scanpy | QC, normalize, HVG, PCA, cluster, annotate, DEG |
| Spatial transcriptomics | Visium, MERFISH, Slide-seq, CODEX | QC, normalize, spatially variable genes, spatial clustering, deconvolution |
| Bulk RNA-seq | DESeq2, edgeR, limma | QC, align, count, normalize, DEG, enrichment |
| Proteomics | MaxQuant, DIA-NN, TMT | QC, normalization, imputation, differential proteins, pathways |
| Metabolomics | XCMS, MetaboAnalyst, MZmine | QC, normalization, PCA, differential analysis, enrichment |
| Lipidomics | Inherits metabolomics plus lipid-specific extensions | QC, normalization, PCA, differential analysis, lipid class |
Each pipeline defines mandatory steps and a required-figure checklist with live compliance checks: skipping doublet removal or batch correction raises a warning in flight, and missing mandatory figures trigger a hard stop before Step 4.
What is bio-analyze not for?
| Scenario | Better alternative |
|---|---|
| Production pipelines processing hundreds of samples daily | Nextflow or Snakemake |
| Novel algorithm and methodology development | Direct programming |
| Pure upstream analysis such as assembly and alignment | BWA, GATK or SPAdes |
| Expecting it to replace your scientific judgment | Not applicable — key gates stop and wait for your call |
Stating the capability boundary honestly is part of the design philosophy: it does not replace statistical training, it does not guarantee the code runs correctly on the first attempt, and key checkpoints pause for a human decision.
Known limits (measured ourselves)
- The gates stop simulated data; they do not stop every fabricated derived number. Under pressure the executing AI once wrote a pair of plausible-looking values into a draft without running them; the gates did not catch it — an external line-by-line check did. Every number in a report must trace to a command output, and for now that check still relies on a person.
- Unattended is not unsupervised. On complex studies it will stop after one step, report "running in the background" when the process never started, or quietly simplify a method — someone who can read logs needs to keep checking.
- Environment and compute detection can misjudge. In testing, a machine with a GPU was classified as CPU-only.
See section 05 of How to choose — publishing these helps you decide more than another selling point would.
How to get started
- Step 1: open a conversation on the platform. bio-analyze is pre-installed — you install nothing.
- Step 2: tell it your research question, where the data is and the target journal (or hand over the
TOPIC.ymlthat bio-design produced). - Step 3: say "start the analysis" and go do something else. It stops when it needs your call, and can reach you over IM.
/bio-analyze status --verbose # check progress
/bio-analyze continue # resume at sub-step granularity
/bio-analyze pipeline show # pipeline compliance status
/bio-analyze config set analysis.clustering_resolution 0.6 --global
/bio-analyze manuscript check --journal nature
/bio-analyze publish prep # submission package
Three-layer customization: project tier over user-global tier over framework tier, across 12 parameter domains and 50+ parameters. Save your preferences (a 15% mitochondrial threshold, a clustering resolution of 0.6) as global defaults and every new project inherits them — this is not a black box.
Frequently asked questions (FAQ)
How do cc-bioinfo, bio-design and bio-analyze relate to each other?
They are one platform plus two core skills, not three parallel products. bio-design and bio-analyze are installable AI skills: install them directly into Claude or ChatGPT and use them on their own, or use them pre-installed on the cc-bioinfo platform. The platform answers where it runs — a Linux server used from the browser, with multi-user isolation, a separate analysis environment per project and a full audit trail. bio-design answers what study to do and produces a design.md proposal plus a machine-readable TOPIC.yml; bio-design answers what study to do — the TOPIC.yml it produces is exactly what this skill takes as its execution entry point. In one sentence: cc-bioinfo is the stage, bio-design is the screenwriter, bio-analyze is the director and cast — they can perform in other theatres too, but the stage machinery exists only in their own.
Do I need to write R or Python code myself?
No. The AI generates, executes and debugs the code, and automatically creates a per-project conda environment, bootstrapping miniconda from scratch if none exists. What you do need is to understand your own scientific question and to make the key judgment calls: cell-type annotation confirmation, analysis direction, and figure review.
Do I have to sit and watch it run?
No. The analysis runs server-side and does not stop when you close the browser, so you can go to clinic or to theatre. When it needs your decision it can reach you through WeChat, DingTalk, Feishu or Telegram. The longest single uninterrupted run in a real case study was about 26 hours.
What happens if an analysis is interrupted halfway?
Run /bio-analyze continue. The system scans the completed outputs, diffs them against the plan, and resumes at exact sub-step granularity. Step 6 has 21 independent sub-steps that each write their own file, so only the failed one reruns.
Can I submit the generated manuscript directly?
Step 6 produces a draft; the researcher must verify scientific accuracy and complete the citations. The framework ships machine-readable compliance configurations for six major journals and automatically checks word limits, 300 DPI resolution, fonts and colourblind-safe palettes. Fabricating statistics or citations is strictly forbidden, and every cited DOI is checked against Crossref.
How is it different from a general skill library, or from installing the skill into Claude Code?
A skill library supplies parts for "how is this step done"; bio-analyze answers "how does the whole study get finished, and how do we prove it did" — on-disk artefact checks, data-provenance checks, a hard-stopping quality audit and state-machine resumption are part of it. It is itself an installable skill: anyone at home in a terminal can install it into Claude Code and use it alone; what the platform adds is a resident per-project environment, multi-user isolation and a complete audit trail. See section 01 of How to choose.
How do I verify it did not mislead me?
Not by trust but by the trail: every phase's inputs, outputs, parameters and versions are written to disk; decision-log entries are inspectable one by one; manuscript DOIs are checked against Crossref; key numbers map to specific result files. The most reliable habit is the one we use ourselves — take a fact that should fail and check it; if it does not fail, the check did not run, it did not pass. And honestly: the gates do not catch every fabricated derived number (see the known limits in section 06); the final review stays with you.
How do I try it, and how do I buy it?
Open the trial platform at test.cc-bioinfo.com (no sign-in needed); for a dedicated trial environment email tangmoogmoogtang@gmail.com. Using it is straightforward: describe your analysis in plain language — no installation, no conda setup, no command line. The personal edition is $50 on Gumroad; the enterprise edition is $300 on Gumroad, multi-server or site licensing by email. See the purchase section.
Last updated: