agentsclimarketplace

Bioinformatics analysis preflight

Skill AstroReality-Li/bioinformatics-analysis-preflight/bioinformatics-analysis-preflight

Agent Skill for local-first bioinformatics analysis preflight audits before omics workflows

Install
npx -y skills add AstroReality-Li/bioinformatics-analysis-preflight --skill bioinformatics-analysis-preflight

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Audit bioinformatics and omics analysis projects before downstream execution. Use when Codex needs to validate sample metadata, FASTQ pairing, sample sheets, count matrices, VCF/BAM/CRAM indexes, h5ad files, reference/provenance readiness, batch or condition confounding, privacy-sensitive local analysis, or whether an RNA-seq, single-cell, ATAC/ChIP-seq, variant, microbiome, proteomics, or multi-omics project is ready for reproducible analysis.

SKILL.md

4.4 KB, as published. Nobody here has run it

Bioinformatics Analysis Preflight

Overview

Run a local, deterministic preflight before spending compute or trusting biological results. The skill does not replace workflow-specific skills; it catches the cross-cutting mistakes those workflows often inherit: mismatched sample IDs, broken file paths, confounded metadata, missing alignment indexes, normalized values passed as counts, weak provenance, and privacy-risky cloud assumptions.

Core Workflow

  1. Inventory inputs. Inspect the project tree and classify FASTQ, BAM/CRAM, VCF, h5ad, count matrix, metadata, sample sheet, and report files. Do not upload genomic or clinical data.
  2. Run deterministic preflight. Use scripts/bio_preflight.py whenever the user has local files or asks "is this ready to analyze?"
  3. Interpret severity. Treat FAIL findings as blockers, WARN findings as risks to resolve or disclose, and PASS findings as evidence, not proof.
  4. Route downstream. After blockers are fixed, hand off to domain skills such as bulk RNA-seq, Scanpy/Seurat, variant annotation, ATAC/ChIP, microbiome, proteomics, or workflow-management skills.
  5. Preserve provenance. Keep the generated Markdown and JSON reports with the analysis outputs.

Quick Start

python bioinformatics-analysis-preflight/scripts/bio_preflight.py \
  --root . \
  --metadata metadata.csv \
  --counts counts.csv \
  --sample-sheet samplesheet.csv \
  --condition-column condition \
  --batch-column batch \
  --output-dir preflight

If the user only provides a project directory, scan it and let the script auto-detect likely inputs:

python bioinformatics-analysis-preflight/scripts/bio_preflight.py \
  --root /path/to/project \
  --output-dir /path/to/project/preflight

For CI-style use, fail the command when blocking issues are found:

python bioinformatics-analysis-preflight/scripts/bio_preflight.py \
  --root . --metadata metadata.csv --counts counts.csv --fail-on fail

What The Script Checks

The script uses only the Python standard library and writes:

  • analysis-preflight-report.md - human-readable summary and next actions.
  • analysis-preflight.json - machine-readable manifest, inventory, and findings.

It checks:

  • sample metadata: duplicate IDs, missing IDs, likely condition/batch columns, weak replication, and batch-condition confounding.
  • count matrices: gene/sample orientation clues, duplicate genes, duplicate sample columns, negative values, non-integer values, and metadata/count sample mismatches.
  • sample sheets: required sample/path columns, duplicate samples, missing FASTQ/BAM paths, mixed single/paired layout, and strandedness values.
  • FASTQ files: common R1/R2 pairing patterns and first-record structure for a limited sample of files.
  • BAM/CRAM files: missing .bai, .csi, or .crai sidecar indexes.
  • VCF files: header presence, sample columns, and contig metadata.
  • h5ad files: HDF5 magic-byte sanity check.

Agent Decision Rules

  • Run the preflight before launching expensive workflows, changing data, or making biological claims from new user data.
  • Ask before installing heavy bioinformatics tools; this skill's script intentionally avoids extra dependencies.
  • Do not send genomic, clinical, or unpublished omics data to external services unless the user explicitly approves that specific transfer.
  • Do not treat a clean preflight as scientific validation. It only validates readiness and common failure modes.
  • If a workflow-specific skill has a stricter preflight, use both: this skill for cross-project audit and the workflow skill for method-specific validation.

Detailed References

  • references/risk-rubric.md - severity definitions, blocker policy, and how to phrase residual risks.
  • references/modality-checklists.md - domain-specific checks for bulk RNA-seq, single-cell, variants, epigenomics, microbiome, proteomics, and multi-omics.
  • references/report-template.md - recommended structure for the final preflight response to the user.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.