[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MATNQ7J49ZNCQPGV8YFWBC":3,"skill-same:01M6MATNQ7J49ZNCQPGV8YFWBC":120},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":29,"publishedAt":60,"linkOnly":61,"markdownContent":62,"markdownBody":63,"frontMatter":64,"refName":72,"commitSha":73,"skillDirectory":74,"forksCount":75,"repositoryHtmlUrl":76,"repositoryHomepageUrl":77,"ownerHtmlUrl":78,"ownerBlogUrl":79,"ownerDescription":80,"updatedAt":81,"install":82,"resources":95},"01M6MATNQ7J49ZNCQPGV8YFWBC","pydeseq2",null,"Runs differential expression analysis on bulk RNA-seq count data with PyDESeq2, the Python port of DESeq2. Covers formulaic single- and multi-factor designs, contrasts, Wald tests, Benjamini-Hochberg FDR correction, optional apeGLM LFC shrinkage, pandas and AnnData (H5AD) integration, CSV export, volcano and MA plots, and a command-line script. Use when comparing gene expression between conditions such as treated vs control, adjusting for batch or covariates, porting an R DESeq2 workflow to Python, or building a Python pipeline for differential expression from raw integer counts. Not for single-cell data or for R-based DESeq2 itself.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fpydeseq2\u002FSKILL.md",[18,23,26],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000013","分析与可视化","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":27,"categoryName":28,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[5,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59],"gene expression","porting","gene","for","strings","command-line","h5ad","bulk","differential expression","transcriptomics","port","DESeq2","expression","factor","as","tests","design","RNA","uv","edit","write","read","command","Bash","analysis","pipeline","pandas","batch","workflow","python","2026-11-10 10:12:30",false,"---\nname: pydeseq2\ndescription: Runs differential expression analysis on bulk RNA-seq count data with PyDESeq2, the Python port of DESeq2. Covers formulaic single- and multi-factor designs, contrasts, Wald tests, Benjamini-Hochberg FDR correction, optional apeGLM LFC shrinkage, pandas and AnnData (H5AD) integration, CSV export, volcano and MA plots, and a command-line script. Use when comparing gene expression between conditions such as treated vs control, adjusting for batch or covariates, porting an R DESeq2 workflow to Python, or building a Python pipeline for differential expression from raw integer counts. Not for single-cell data or for R-based DESeq2 itself.\nlicense: MIT\ncompatibility: Requires Python >=3.11 and PyDESeq2 0.5.4-compatible dependencies. Examples target PyDESeq2 0.5.x, formulaic design strings, explicit contrasts, and uv-based installs.\nallowed-tools: Read Write Edit Bash\nmetadata:\n  version: '1.4'\n  category: life-sciences\n  maintainer: Kalaris Labs\n  tags: differential expression, RNA-seq, DESeq2, transcriptomics, bioinformatics\n---\n\n# PyDESeq2\n\n## Overview\n\nPyDESeq2 is a Python implementation of DESeq2 for differential expression analysis with bulk RNA-seq data. Design and execute complete workflows from data loading through result interpretation, including formulaic single-factor and multi-factor designs, Wald tests with multiple testing correction, optional apeGLM shrinkage, and integration with pandas and AnnData.\n\n## When to Use This Skill\n\nThis skill should be used when:\n- Analyzing bulk RNA-seq count data for differential expression\n- Comparing gene expression between experimental conditions (e.g., treated vs control)\n- Performing multi-factor designs accounting for batch effects or covariates\n- Converting R-based DESeq2 workflows to Python\n- Integrating differential expression analysis into Python-based pipelines\n- Users mention \"DESeq2\", \"differential expression\", \"RNA-seq analysis\", or \"PyDESeq2\"\n\n## Quick Start Workflow\n\nFor users who want to perform a standard differential expression analysis:\n\n```python\nimport pandas as pd\nfrom pydeseq2.dds import DeseqDataSet\nfrom pydeseq2.default_inference import DefaultInference\nfrom pydeseq2.ds import DeseqStats\n\n# 1. Load data\ncounts_df = pd.read_csv(\"counts.csv\", index_col=0).T  # Transpose to samples × genes\nmetadata = pd.read_csv(\"metadata.csv\", index_col=0)\n\n# 2. Filter low-count genes\ngenes_to_keep = counts_df.columns[counts_df.sum(axis=0) >= 10]\ncounts_df = counts_df[genes_to_keep]\n\n# 3. Make the reference level explicit and fit DESeq2\nmetadata[\"condition\"] = pd.Categorical(\n    metadata[\"condition\"], categories=[\"control\", \"treated\"]\n)\ninference = DefaultInference(n_cpus=4)\ndds = DeseqDataSet(\n    counts=counts_df,\n    metadata=metadata,\n    design=\"~condition\",\n    refit_cooks=True,\n    inference=inference,\n)\ndds.deseq2()\n\n# 4. Perform statistical testing\nds = DeseqStats(\n    dds,\n    contrast=[\"condition\", \"treated\", \"control\"],\n    inference=inference,\n)\nds.summary()\n\n# 5. Access results\nresults = ds.results_df\nsignificant = results[results.padj \u003C 0.05]\nprint(f\"Found {len(significant)} significant genes\")\n```\n\n## Core Workflow Steps\n\nThe six steps, with code, are in\n[references\u002Fcore_workflow_steps.md](references\u002Fcore_workflow_steps.md):\n\n1. **Data preparation** — raw integer counts with genes as columns and samples as rows,\n   and matching metadata. Never feed normalized or transformed values to DESeq2.\n2. **Design specification** — the design factors and the reference level for each.\n3. **DESeq2 fitting** — size factors, dispersions, and the GLM fit.\n4. **Statistical testing** — Wald tests for a named contrast.\n5. **Optional LFC shrinkage** — for ranking and visualization.\n6. **Result export** — the results table with adjusted p-values.\n\nMulti-factor designs, contrasts, and interaction terms are in\n[references\u002Fanalysis_patterns.md](references\u002Fanalysis_patterns.md).\n\n## Using the Analysis Script\n\nThis skill includes a complete command-line script for standard analyses:\n\n```bash\n# Basic usage\npython scripts\u002Frun_deseq2_analysis.py \\\n  --counts counts.csv \\\n  --metadata metadata.csv \\\n  --design \"~condition\" \\\n  --contrast condition treated control \\\n  --output results\u002F\n\n# With additional options\npython scripts\u002Frun_deseq2_analysis.py \\\n  --counts counts.csv \\\n  --metadata metadata.csv \\\n  --design \"~batch + condition\" \\\n  --contrast condition treated control \\\n  --output results\u002F \\\n  --min-counts 10 \\\n  --alpha 0.05 \\\n  --n-cpus 4 \\\n  --shrink-coeff \"condition[T.treated]\" \\\n  --plots\n```\n\n**Script features:**\n- Automatic data loading and validation\n- Gene and sample filtering\n- Complete DESeq2 pipeline execution\n- Statistical testing with customizable parameters\n- Result export (CSV and portable AnnData\u002FH5AD)\n- Explicit LFC shrinkage coefficient support for PyDESeq2 0.5.x\n- Optional visualization (volcano and MA plots)\n\nRefer users to `scripts\u002Frun_deseq2_analysis.py` when they need a standalone analysis tool or want to batch process multiple datasets.\n\n## Result Interpretation\n\n### Identifying Significant Genes\n\n```python\n# Filter by adjusted p-value\nsignificant = ds.results_df[ds.results_df.padj \u003C 0.05]\n\n# Filter by both significance and effect size\nsig_and_large = ds.results_df[\n    (ds.results_df.padj \u003C 0.05) &\n    (abs(ds.results_df.log2FoldChange) > 1)\n]\n\n# Separate up- and down-regulated\nupregulated = significant[significant.log2FoldChange > 0]\ndownregulated = significant[significant.log2FoldChange \u003C 0]\n\nprint(f\"Upregulated: {len(upregulated)}\")\nprint(f\"Downregulated: {len(downregulated)}\")\n```\n\n### Ranking and Sorting\n\n```python\n# Sort by adjusted p-value\ntop_by_padj = ds.results_df.sort_values(\"padj\").head(20)\n\n# Sort by absolute fold change (use shrunk values)\nds.lfc_shrink(coeff=\"condition[T.treated]\")\nds.results_df[\"abs_lfc\"] = abs(ds.results_df.log2FoldChange)\ntop_by_lfc = ds.results_df.sort_values(\"abs_lfc\", ascending=False).head(20)\n\n# Sort by a combined metric\nds.results_df[\"score\"] = -np.log10(ds.results_df.padj) * abs(ds.results_df.log2FoldChange)\ntop_combined = ds.results_df.sort_values(\"score\", ascending=False).head(20)\n```\n\n### Quality Metrics\n\n```python\n# Check normalization (size factors should be close to 1)\nprint(\"Size factors:\", dds.obs[\"size_factors\"])\n\n# Examine dispersion estimates\nimport matplotlib.pyplot as plt\nplt.hist(dds.var[\"dispersions\"], bins=50)\nplt.xlabel(\"Dispersion\")\nplt.ylabel(\"Frequency\")\nplt.title(\"Dispersion Distribution\")\nplt.show()\n\n# Check p-value distribution (should be mostly flat with peak near 0)\nplt.hist(ds.results_df.pvalue.dropna(), bins=50)\nplt.xlabel(\"P-value\")\nplt.ylabel(\"Frequency\")\nplt.title(\"P-value Distribution\")\nplt.show()\n```\n\n## Visualization Guidelines\n\n### Volcano Plot\n\nVisualize significance vs effect size:\n\n```python\nimport matplotlib.pyplot as plt\nimport numpy as np\n\nresults = ds.results_df.copy()\nresults[\"-log10(padj)\"] = -np.log10(results.padj)\n\nplt.figure(figsize=(10, 6))\nsignificant = results.padj \u003C 0.05\n\nplt.scatter(\n    results.loc[~significant, \"log2FoldChange\"],\n    results.loc[~significant, \"-log10(padj)\"],\n    alpha=0.3, s=10, c='gray', label='Not significant'\n)\nplt.scatter(\n    results.loc[significant, \"log2FoldChange\"],\n    results.loc[significant, \"-log10(padj)\"],\n    alpha=0.6, s=10, c='red', label='padj \u003C 0.05'\n)\n\nplt.axhline(-np.log10(0.05), color='blue', linestyle='--', alpha=0.5)\nplt.xlabel(\"Log2 Fold Change\")\nplt.ylabel(\"-Log10(Adjusted P-value)\")\nplt.title(\"Volcano Plot\")\nplt.legend()\nplt.savefig(\"volcano_plot.png\", dpi=300)\n```\n\n### MA Plot\n\nShow fold change vs mean expression:\n\n```python\nplt.figure(figsize=(10, 6))\n\nplt.scatter(\n    np.log10(results.loc[~significant, \"baseMean\"] + 1),\n    results.loc[~significant, \"log2FoldChange\"],\n    alpha=0.3, s=10, c='gray'\n)\nplt.scatter(\n    np.log10(results.loc[significant, \"baseMean\"] + 1),\n    results.loc[significant, \"log2FoldChange\"],\n    alpha=0.6, s=10, c='red'\n)\n\nplt.axhline(0, color='blue', linestyle='--', alpha=0.5)\nplt.xlabel(\"Log10(Base Mean + 1)\")\nplt.ylabel(\"Log2 Fold Change\")\nplt.title(\"MA Plot\")\nplt.savefig(\"ma_plot.png\", dpi=300)\n```\n\n## Troubleshooting Common Issues\n\n### Data Format Problems\n\n**Issue:** \"Index mismatch between counts and metadata\"\n\n**Solution:** Ensure sample names match exactly\n```python\nprint(\"Counts samples:\", counts_df.index.tolist())\nprint(\"Metadata samples:\", metadata.index.tolist())\n\n# Take intersection if needed\ncommon = counts_df.index.intersection(metadata.index)\ncounts_df = counts_df.loc[common]\nmetadata = metadata.loc[common]\n```\n\n**Issue:** \"All genes have zero counts\"\n\n**Solution:** Check if data needs transposition\n```python\nprint(f\"Counts shape: {counts_df.shape}\")\n# If genes > samples, transpose is needed\nif counts_df.shape[1] \u003C counts_df.shape[0]:\n    counts_df = counts_df.T\n```\n\n### Design Matrix Issues\n\n**Issue:** \"Design matrix is not full rank\"\n\n**Cause:** Confounded variables (e.g., all treated samples in one batch)\n\n**Solution:** Remove confounded variable or add interaction term\n```python\n# Check confounding\nprint(pd.crosstab(metadata.condition, metadata.batch))\n\n# Either simplify design or add interaction\ndesign = \"~condition\"  # Remove batch\n# OR\ndesign = \"~condition + batch + condition:batch\"  # Model interaction\n```\n\n### No Significant Genes\n\n**Diagnostics:**\n```python\n# Check dispersion distribution\nplt.hist(dds.var[\"dispersions\"], bins=50)\nplt.show()\n\n# Check size factors\nprint(dds.obs[\"size_factors\"])\n\n# Look at top genes by raw p-value\nprint(ds.results_df.nsmallest(20, \"pvalue\"))\n```\n\n**Possible causes:**\n- Small effect sizes\n- High biological variability\n- Insufficient sample size\n- Technical issues (batch effects, outliers)\n\n## Reference Documentation\n\nFor comprehensive details beyond this workflow-oriented guide:\n\n- **API Reference** (`references\u002Fapi_reference.md`): Complete documentation of PyDESeq2 classes, methods, and data structures. Use when needing detailed parameter information or understanding object attributes.\n\n- **Workflow Guide** (`references\u002Fworkflow_guide.md`): In-depth guide covering complete analysis workflows, data loading patterns, multi-factor designs, troubleshooting, and best practices. Use when handling complex experimental designs or encountering issues.\n\nLoad these references into context when users need:\n- Detailed API documentation: `Read references\u002Fapi_reference.md`\n- Comprehensive workflow examples: `Read references\u002Fworkflow_guide.md`\n- Troubleshooting guidance: `Read references\u002Fworkflow_guide.md` (see Troubleshooting section)\n\n## Key Reminders\n\n1. **Data orientation matters:** Count matrices typically load as genes × samples but need to be samples × genes. Always transpose with `.T` if needed.\n\n2. **Sample filtering:** Remove samples with missing metadata before analysis to avoid errors.\n\n3. **Gene filtering:** Filter low-count genes (e.g., \u003C 10 total reads) to improve power and reduce computational time.\n\n4. **Design formula order:** Put adjustment variables before the variable of interest (e.g., `\"~batch + condition\"` not `\"~condition + batch\"`).\n\n5. **LFC shrinkage timing:** Apply shrinkage after statistical testing and only for visualization\u002Franking purposes. P-values remain based on unshrunken estimates.\n\n6. **Result interpretation:** Use `padj \u003C 0.05` for significance, not raw p-values. The Benjamini-Hochberg procedure controls false discovery rate.\n\n7. **Contrast specification:** The format is `[variable, test_level, reference_level]` where test_level is compared against reference_level.\n\n8. **Save intermediate objects:** Prefer `dds.to_picklable_anndata().write_h5ad(\"dds_result.h5ad\")` for portable outputs. Only load pickle files that you created yourself and trust.\n\n## Installation and Requirements\n\n```bash\nuv pip install pydeseq2==0.5.4\n```\n\n**System requirements:**\n- Python 3.11+\n- PyDESeq2 0.5.4\n- pandas 2.2.0+\n- numpy 2.0.0+\n- scipy 1.12.0+\n- scikit-learn 1.4.0+\n- anndata 0.11.0+\n- formulaic 1.0.2+ and formulaic-contrasts 0.2.0+\n\n**Optional for visualization:**\n- matplotlib\n- seaborn\n\n## Additional Resources\n\n- **Official Documentation:** https:\u002F\u002Fpydeseq2.readthedocs.io\n- **GitHub Repository:** https:\u002F\u002Fgithub.com\u002Fscverse\u002FPyDESeq2\n- **Publication:** Muzellec et al. (2023) Bioinformatics, DOI: 10.1093\u002Fbioinformatics\u002Fbtad547\n- **Original DESeq2 (R):** Love et al. (2014) Genome Biology, DOI: 10.1186\u002Fs13059-014-0550-8\n\n## Agent operating procedure\n\n1. **Check the environment.** Confirm tool versions, the reference genome\u002Fannotation build and the input formats (FASTQ, BAM, VCF, h5ad).\n2. **Pin down the inputs.** Confirm formats, identifiers and parameters from the data or the user. Ask rather than guess any value that changes the result.\n3. **Run a small version first.** Run the pipeline on a small subset (one sample, one chromosome, a few thousand cells) first.\n4. **Execute the full task** using the instructions and references above.\n5. **Validate the result.** Check QC metrics, sample identities, genome build consistency and batch effects before interpreting results.\n6. **Report.** State what was run (versions, commands, parameters), what was checked, and what is still uncertain.\n\n| If this happens | Do this |\n|---|---|\n| Genome builds or identifiers do not match between inputs | Stop and harmonize (liftover, ID mapping) before continuing. |\n| A function, flag or endpoint in these instructions is missing in the installed version | Check the installed version's own documentation (`help()`, `--help`, official docs), adapt, and tell the user. Never invent an API. |\n| A required input, identifier or parameter is ambiguous | Ask the user, or state the assumption explicitly before running. |\n\n**Integrity rules**\n\n- Never fabricate results, parameters, identifiers, citations or statistics. If something cannot be run or verified, say so plainly.\n- Do not interpret biological significance beyond what the statistics support; report multiple-testing correction.\n- Treat version-specific details here as possibly outdated: confirm them against the official documentation for the installed version.\n- Ask before actions that cost money, consume shared GPUs or cloud quota, touch personal or patient data, or cannot be undone.\n\n## Related skills\n\n- `bulk-rnaseq`: End-to-end bulk RNA-seq orchestrator — takes raw FASTQ reads through QC and trimming (FastQC, fastp\u002FTrim Galore), alignment and quantificat…\n- `scanpy`: Standard single-cell RNA-seq analysis pipeline.\n- `arboreto`: Infer gene regulatory networks (GRNs) from gene expression data using scalable algorithms (GRNBoost2, GENIE3).\n","# PyDESeq2\n\n## Overview\n\nPyDESeq2 is a Python implementation of DESeq2 for differential expression analysis with bulk RNA-seq data. Design and execute complete workflows from data loading through result interpretation, including formulaic single-factor and multi-factor designs, Wald tests with multiple testing correction, optional apeGLM shrinkage, and integration with pandas and AnnData.\n\n## When to Use This Skill\n\nThis skill should be used when:\n- Analyzing bulk RNA-seq count data for differential expression\n- Comparing gene expression between experimental conditions (e.g., treated vs control)\n- Performing multi-factor designs accounting for batch effects or covariates\n- Converting R-based DESeq2 workflows to Python\n- Integrating differential expression analysis into Python-based pipelines\n- Users mention \"DESeq2\", \"differential expression\", \"RNA-seq analysis\", or \"PyDESeq2\"\n\n## Quick Start Workflow\n\nFor users who want to perform a standard differential expression analysis:\n\n```python\nimport pandas as pd\nfrom pydeseq2.dds import DeseqDataSet\nfrom pydeseq2.default_inference import DefaultInference\nfrom pydeseq2.ds import DeseqStats\n\n# 1. Load data\ncounts_df = pd.read_csv(\"counts.csv\", index_col=0).T  # Transpose to samples × genes\nmetadata = pd.read_csv(\"metadata.csv\", index_col=0)\n\n# 2. Filter low-count genes\ngenes_to_keep = counts_df.columns[counts_df.sum(axis=0) >= 10]\ncounts_df = counts_df[genes_to_keep]\n\n# 3. Make the reference level explicit and fit DESeq2\nmetadata[\"condition\"] = pd.Categorical(\n    metadata[\"condition\"], categories=[\"control\", \"treated\"]\n)\ninference = DefaultInference(n_cpus=4)\ndds = DeseqDataSet(\n    counts=counts_df,\n    metadata=metadata,\n    design=\"~condition\",\n    refit_cooks=True,\n    inference=inference,\n)\ndds.deseq2()\n\n# 4. Perform statistical testing\nds = DeseqStats(\n    dds,\n    contrast=[\"condition\", \"treated\", \"control\"],\n    inference=inference,\n)\nds.summary()\n\n# 5. Access results\nresults = ds.results_df\nsignificant = results[results.padj \u003C 0.05]\nprint(f\"Found {len(significant)} significant genes\")\n```\n\n## Core Workflow Steps\n\nThe six steps, with code, are in\n[references\u002Fcore_workflow_steps.md](references\u002Fcore_workflow_steps.md):\n\n1. **Data preparation** — raw integer counts with genes as columns and samples as rows,\n   and matching metadata. Never feed normalized or transformed values to DESeq2.\n2. **Design specification** — the design factors and the reference level for each.\n3. **DESeq2 fitting** — size factors, dispersions, and the GLM fit.\n4. **Statistical testing** — Wald tests for a named contrast.\n5. **Optional LFC shrinkage** — for ranking and visualization.\n6. **Result export** — the results table with adjusted p-values.\n\nMulti-factor designs, contrasts, and interaction terms are in\n[references\u002Fanalysis_patterns.md](references\u002Fanalysis_patterns.md).\n\n## Using the Analysis Script\n\nThis skill includes a complete command-line script for standard analyses:\n\n```bash\n# Basic usage\npython scripts\u002Frun_deseq2_analysis.py \\\n  --counts counts.csv \\\n  --metadata metadata.csv \\\n  --design \"~condition\" \\\n  --contrast condition treated control \\\n  --output results\u002F\n\n# With additional options\npython scripts\u002Frun_deseq2_analysis.py \\\n  --counts counts.csv \\\n  --metadata metadata.csv \\\n  --design \"~batch + condition\" \\\n  --contrast condition treated control \\\n  --output results\u002F \\\n  --min-counts 10 \\\n  --alpha 0.05 \\\n  --n-cpus 4 \\\n  --shrink-coeff \"condition[T.treated]\" \\\n  --plots\n```\n\n**Script features:**\n- Automatic data loading and validation\n- Gene and sample filtering\n- Complete DESeq2 pipeline execution\n- Statistical testing with customizable parameters\n- Result export (CSV and portable AnnData\u002FH5AD)\n- Explicit LFC shrinkage coefficient support for PyDESeq2 0.5.x\n- Optional visualization (volcano and MA plots)\n\nRefer users to `scripts\u002Frun_deseq2_analysis.py` when they need a standalone analysis tool or want to batch process multiple datasets.\n\n## Result Interpretation\n\n### Identifying Significant Genes\n\n```python\n# Filter by adjusted p-value\nsignificant = ds.results_df[ds.results_df.padj \u003C 0.05]\n\n# Filter by both significance and effect size\nsig_and_large = ds.results_df[\n    (ds.results_df.padj \u003C 0.05) &\n    (abs(ds.results_df.log2FoldChange) > 1)\n]\n\n# Separate up- and down-regulated\nupregulated = significant[significant.log2FoldChange > 0]\ndownregulated = significant[significant.log2FoldChange \u003C 0]\n\nprint(f\"Upregulated: {len(upregulated)}\")\nprint(f\"Downregulated: {len(downregulated)}\")\n```\n\n### Ranking and Sorting\n\n```python\n# Sort by adjusted p-value\ntop_by_padj = ds.results_df.sort_values(\"padj\").head(20)\n\n# Sort by absolute fold change (use shrunk values)\nds.lfc_shrink(coeff=\"condition[T.treated]\")\nds.results_df[\"abs_lfc\"] = abs(ds.results_df.log2FoldChange)\ntop_by_lfc = ds.results_df.sort_values(\"abs_lfc\", ascending=False).head(20)\n\n# Sort by a combined metric\nds.results_df[\"score\"] = -np.log10(ds.results_df.padj) * abs(ds.results_df.log2FoldChange)\ntop_combined = ds.results_df.sort_values(\"score\", ascending=False).head(20)\n```\n\n### Quality Metrics\n\n```python\n# Check normalization (size factors should be close to 1)\nprint(\"Size factors:\", dds.obs[\"size_factors\"])\n\n# Examine dispersion estimates\nimport matplotlib.pyplot as plt\nplt.hist(dds.var[\"dispersions\"], bins=50)\nplt.xlabel(\"Dispersion\")\nplt.ylabel(\"Frequency\")\nplt.title(\"Dispersion Distribution\")\nplt.show()\n\n# Check p-value distribution (should be mostly flat with peak near 0)\nplt.hist(ds.results_df.pvalue.dropna(), bins=50)\nplt.xlabel(\"P-value\")\nplt.ylabel(\"Frequency\")\nplt.title(\"P-value Distribution\")\nplt.show()\n```\n\n## Visualization Guidelines\n\n### Volcano Plot\n\nVisualize significance vs effect size:\n\n```python\nimport matplotlib.pyplot as plt\nimport numpy as np\n\nresults = ds.results_df.copy()\nresults[\"-log10(padj)\"] = -np.log10(results.padj)\n\nplt.figure(figsize=(10, 6))\nsignificant = results.padj \u003C 0.05\n\nplt.scatter(\n    results.loc[~significant, \"log2FoldChange\"],\n    results.loc[~significant, \"-log10(padj)\"],\n    alpha=0.3, s=10, c='gray', label='Not significant'\n)\nplt.scatter(\n    results.loc[significant, \"log2FoldChange\"],\n    results.loc[significant, \"-log10(padj)\"],\n    alpha=0.6, s=10, c='red', label='padj \u003C 0.05'\n)\n\nplt.axhline(-np.log10(0.05), color='blue', linestyle='--', alpha=0.5)\nplt.xlabel(\"Log2 Fold Change\")\nplt.ylabel(\"-Log10(Adjusted P-value)\")\nplt.title(\"Volcano Plot\")\nplt.legend()\nplt.savefig(\"volcano_plot.png\", dpi=300)\n```\n\n### MA Plot\n\nShow fold change vs mean expression:\n\n```python\nplt.figure(figsize=(10, 6))\n\nplt.scatter(\n    np.log10(results.loc[~significant, \"baseMean\"] + 1),\n    results.loc[~significant, \"log2FoldChange\"],\n    alpha=0.3, s=10, c='gray'\n)\nplt.scatter(\n    np.log10(results.loc[significant, \"baseMean\"] + 1),\n    results.loc[significant, \"log2FoldChange\"],\n    alpha=0.6, s=10, c='red'\n)\n\nplt.axhline(0, color='blue', linestyle='--', alpha=0.5)\nplt.xlabel(\"Log10(Base Mean + 1)\")\nplt.ylabel(\"Log2 Fold Change\")\nplt.title(\"MA Plot\")\nplt.savefig(\"ma_plot.png\", dpi=300)\n```\n\n## Troubleshooting Common Issues\n\n### Data Format Problems\n\n**Issue:** \"Index mismatch between counts and metadata\"\n\n**Solution:** Ensure sample names match exactly\n```python\nprint(\"Counts samples:\", counts_df.index.tolist())\nprint(\"Metadata samples:\", metadata.index.tolist())\n\n# Take intersection if needed\ncommon = counts_df.index.intersection(metadata.index)\ncounts_df = counts_df.loc[common]\nmetadata = metadata.loc[common]\n```\n\n**Issue:** \"All genes have zero counts\"\n\n**Solution:** Check if data needs transposition\n```python\nprint(f\"Counts shape: {counts_df.shape}\")\n# If genes > samples, transpose is needed\nif counts_df.shape[1] \u003C counts_df.shape[0]:\n    counts_df = counts_df.T\n```\n\n### Design Matrix Issues\n\n**Issue:** \"Design matrix is not full rank\"\n\n**Cause:** Confounded variables (e.g., all treated samples in one batch)\n\n**Solution:** Remove confounded variable or add interaction term\n```python\n# Check confounding\nprint(pd.crosstab(metadata.condition, metadata.batch))\n\n# Either simplify design or add interaction\ndesign = \"~condition\"  # Remove batch\n# OR\ndesign = \"~condition + batch + condition:batch\"  # Model interaction\n```\n\n### No Significant Genes\n\n**Diagnostics:**\n```python\n# Check dispersion distribution\nplt.hist(dds.var[\"dispersions\"], bins=50)\nplt.show()\n\n# Check size factors\nprint(dds.obs[\"size_factors\"])\n\n# Look at top genes by raw p-value\nprint(ds.results_df.nsmallest(20, \"pvalue\"))\n```\n\n**Possible causes:**\n- Small effect sizes\n- High biological variability\n- Insufficient sample size\n- Technical issues (batch effects, outliers)\n\n## Reference Documentation\n\nFor comprehensive details beyond this workflow-oriented guide:\n\n- **API Reference** (`references\u002Fapi_reference.md`): Complete documentation of PyDESeq2 classes, methods, and data structures. Use when needing detailed parameter information or understanding object attributes.\n\n- **Workflow Guide** (`references\u002Fworkflow_guide.md`): In-depth guide covering complete analysis workflows, data loading patterns, multi-factor designs, troubleshooting, and best practices. Use when handling complex experimental designs or encountering issues.\n\nLoad these references into context when users need:\n- Detailed API documentation: `Read references\u002Fapi_reference.md`\n- Comprehensive workflow examples: `Read references\u002Fworkflow_guide.md`\n- Troubleshooting guidance: `Read references\u002Fworkflow_guide.md` (see Troubleshooting section)\n\n## Key Reminders\n\n1. **Data orientation matters:** Count matrices typically load as genes × samples but need to be samples × genes. Always transpose with `.T` if needed.\n\n2. **Sample filtering:** Remove samples with missing metadata before analysis to avoid errors.\n\n3. **Gene filtering:** Filter low-count genes (e.g., \u003C 10 total reads) to improve power and reduce computational time.\n\n4. **Design formula order:** Put adjustment variables before the variable of interest (e.g., `\"~batch + condition\"` not `\"~condition + batch\"`).\n\n5. **LFC shrinkage timing:** Apply shrinkage after statistical testing and only for visualization\u002Franking purposes. P-values remain based on unshrunken estimates.\n\n6. **Result interpretation:** Use `padj \u003C 0.05` for significance, not raw p-values. The Benjamini-Hochberg procedure controls false discovery rate.\n\n7. **Contrast specification:** The format is `[variable, test_level, reference_level]` where test_level is compared against reference_level.\n\n8. **Save intermediate objects:** Prefer `dds.to_picklable_anndata().write_h5ad(\"dds_result.h5ad\")` for portable outputs. Only load pickle files that you created yourself and trust.\n\n## Installation and Requirements\n\n```bash\nuv pip install pydeseq2==0.5.4\n```\n\n**System requirements:**\n- Python 3.11+\n- PyDESeq2 0.5.4\n- pandas 2.2.0+\n- numpy 2.0.0+\n- scipy 1.12.0+\n- scikit-learn 1.4.0+\n- anndata 0.11.0+\n- formulaic 1.0.2+ and formulaic-contrasts 0.2.0+\n\n**Optional for visualization:**\n- matplotlib\n- seaborn\n\n## Additional Resources\n\n- **Official Documentation:** https:\u002F\u002Fpydeseq2.readthedocs.io\n- **GitHub Repository:** https:\u002F\u002Fgithub.com\u002Fscverse\u002FPyDESeq2\n- **Publication:** Muzellec et al. (2023) Bioinformatics, DOI: 10.1093\u002Fbioinformatics\u002Fbtad547\n- **Original DESeq2 (R):** Love et al. (2014) Genome Biology, DOI: 10.1186\u002Fs13059-014-0550-8\n\n## Agent operating procedure\n\n1. **Check the environment.** Confirm tool versions, the reference genome\u002Fannotation build and the input formats (FASTQ, BAM, VCF, h5ad).\n2. **Pin down the inputs.** Confirm formats, identifiers and parameters from the data or the user. Ask rather than guess any value that changes the result.\n3. **Run a small version first.** Run the pipeline on a small subset (one sample, one chromosome, a few thousand cells) first.\n4. **Execute the full task** using the instructions and references above.\n5. **Validate the result.** Check QC metrics, sample identities, genome build consistency and batch effects before interpreting results.\n6. **Report.** State what was run (versions, commands, parameters), what was checked, and what is still uncertain.\n\n| If this happens | Do this |\n|---|---|\n| Genome builds or identifiers do not match between inputs | Stop and harmonize (liftover, ID mapping) before continuing. |\n| A function, flag or endpoint in these instructions is missing in the installed version | Check the installed version's own documentation (`help()`, `--help`, official docs), adapt, and tell the user. Never invent an API. |\n| A required input, identifier or parameter is ambiguous | Ask the user, or state the assumption explicitly before running. |\n\n**Integrity rules**\n\n- Never fabricate results, parameters, identifiers, citations or statistics. If something cannot be run or verified, say so plainly.\n- Do not interpret biological significance beyond what the statistics support; report multiple-testing correction.\n- Treat version-specific details here as possibly outdated: confirm them against the official documentation for the installed version.\n- Ask before actions that cost money, consume shared GPUs or cloud quota, touch personal or patient data, or cannot be undone.\n\n## Related skills\n\n- `bulk-rnaseq`: End-to-end bulk RNA-seq orchestrator — takes raw FASTQ reads through QC and trimming (FastQC, fastp\u002FTrim Galore), alignment and quantificat…\n- `scanpy`: Standard single-cell RNA-seq analysis pipeline.\n- `arboreto`: Infer gene regulatory networks (GRNs) from gene expression data using scalable algorithms (GRNBoost2, GENIE3).\n",{"name":5,"license":15,"metadata":65,"description":7,"allowed-tools":70,"compatibility":71},{"tags":66,"version":67,"category":68,"maintainer":69},"differential expression, RNA-seq, DESeq2, transcriptomics, bioinformatics","1.4","life-sciences","Kalaris Labs","Read Write Edit Bash","Requires Python >=3.11 and PyDESeq2 0.5.4-compatible dependencies. Examples target PyDESeq2 0.5.x, formulaic design strings, explicit contrasts, and uv-based installs.","main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fpydeseq2",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":83,"prompt":93,"zipAvailable":94},[84,87,90],{"tool":85,"command":86},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill pydeseq2",{"tool":88,"command":89},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill pydeseq2",{"tool":91,"command":92},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill pydeseq2","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fpydeseq2\u002FSKILL.md",true,[96,102,106,110,114],{"path":97,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":100,"sourceHtmlUrl":101},"references\u002Fanalysis_patterns.md","REFERENCE","参考文档",1715,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fpydeseq2\u002Freferences\u002Fanalysis_patterns.md",{"path":103,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":104,"sourceHtmlUrl":105},"references\u002Fapi_reference.md",9254,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fpydeseq2\u002Freferences\u002Fapi_reference.md",{"path":107,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":108,"sourceHtmlUrl":109},"references\u002Fcore_workflow_steps.md",5081,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fpydeseq2\u002Freferences\u002Fcore_workflow_steps.md",{"path":111,"resourceType":98,"resourceTypeDesc":99,"sizeBytes":112,"sourceHtmlUrl":113},"references\u002Fworkflow_guide.md",14259,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fpydeseq2\u002Freferences\u002Fworkflow_guide.md",{"path":115,"resourceType":116,"resourceTypeDesc":117,"sizeBytes":118,"sourceHtmlUrl":119},"scripts\u002Frun_deseq2_analysis.py","SCRIPT","脚本",13310,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FKalarisLabs\u002Fresearch-agent-skills\u002Fskills\u002Fpydeseq2\u002Fscripts\u002Frun_deseq2_analysis.py",[121,130,138,146,154,162],{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":125,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":129},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":134,"sourceHtmlUrl":135,"categories":136,"keywords":137,"publishedAt":129},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":139,"name":140,"nameZh":6,"description":141,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":142,"sourceHtmlUrl":143,"categories":144,"keywords":145,"publishedAt":129},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":150,"sourceHtmlUrl":151,"categories":152,"keywords":153,"publishedAt":129},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":155,"name":156,"nameZh":6,"description":157,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":158,"sourceHtmlUrl":159,"categories":160,"keywords":161,"publishedAt":129},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":166,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":129},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]