跳到主内容
智客 ZICQ

技能库 智客分类:Agent 工作流 scvi-tools

Scvi Tools

利用scvi工具为单细胞分析进行深层学习. 当用户需要 (1) 数据集成和批量校正与 scVI/scANVI, (2) ATAC-seq 分析与 PeakVI, (3) CITE-seq 多式联运分析与totalVI, (4) 多米 RNA+ ATAC 分析与 MultiVI, (5) 空间转录组解析与 DestVI, (6) 标签转录和参考映射与 scANVI/scArches, (7) RNA速度与速度, 或(8) 任何以深学习为基础的单细胞方法. 触发器包括提及 scVI, scANVI, tromeVI, PeakVI, MultiVI, DestVI, veloVI, sysVI, scArches, 变相自编码器, VAE, 批次校正, 数据集成,多模式, CITE-seq, 多组, 参考映射, 潜在空间.

168 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

利用scvi工具为单细胞分析进行深层学习. 当用户需要 (1) 数据集成和批量校正与 scVI/scANVI, (2) ATAC-seq 分析与 PeakVI, (3) CITE-seq 多式联运分析与totalVI, (4) 多米 RNA+ ATAC 分析与 MultiVI, (5) 空间转录组解析与 DestVI, (6) 标签转录和参考映射与 scANVI/scArches, (7) RNA速度与速度, 或(8) 任何以深学习为基础的单细胞方法. 触发器包括提及 scVI, scANVI, tromeVI, PeakVI, MultiVI, DestVI, veloVI, sysVI, scArches, 变相自编码器, VAE, 批次校正, 数据集成,多模式, CITE-seq, 多组, 参考映射, 潜在空间.

何时用

这个技能

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:scvi-tools Deep Learning Skill、How to Use This Skill、When to Use This Skill、Model Selection Guide、Workflow Reference Files、CLI Scripts。 其中含规范建议的小节:分步指令、输入输出示例。

文件分析

文件分析:除 SKILL.md 外,正文引用了 references/environment_setup.md、references/troubleshooting.md、references/data_preparation.md、references/scrna_integration.md、references/atac_peakvi.md、references/citeseq_totalvi.md,属于带资源的技能包,这些文件按需再读。

官方 description(原文)

Deep learning for single-cell analysis using scvi-tools. This skill should be used when users need (1) data integration and batch correction with scVI/scANVI, (2) ATAC-seq analysis with PeakVI, (3) CITE-seq multi-modal analysis with totalVI, (4) multiome RNA+ATAC analysis with MultiVI, (5) spatial transcriptomics deconvolution with DestVI, (6) label transfer and reference mapping with scANVI/scArches, (7) RNA velocity with veloVI, or (8) any deep learning-based single-cell method. Triggers include mentions of scVI, scANVI, totalVI, PeakVI, MultiVI, DestVI, veloVI, sysVI, scArches, variational autoencoder, VAE, batch correction, data integration, multi-modal, CITE-seq, multiome, reference mapping, latent space.

scvi-tools Deep Learning SkillHow to Use This SkillWhen to Use This SkillModel Selection GuideWorkflow Reference FilesCLI ScriptsPipeline ScriptsExample Workflow1. Validate input data2. Prepare data (QC, HVG selection)3. Train model4. Cluster and visualize

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
scvi-tools
description
Deep learning for single-cell analysis using scvi-tools. This skill should be used when users need (1) data integration and batch correction with scVI/scANVI, (2) ATAC-seq analysis with PeakVI, (3) CITE-seq multi-modal analysis with totalVI, (4) multiome RNA+ATAC analysis with MultiVI, (5) spatial transcriptomics deconvolution with DestVI, (6) label transfer and reference mapping with scANVI/scArches, (7) RNA velocity with veloVI, or (8) any deep learning-based single-cell method. Triggers include mentions of scVI, scANVI, totalVI, PeakVI, MultiVI, DestVI, veloVI, sysVI, scArches, variational autoencoder, VAE, batch correction, data integration, multi-modal, CITE-seq, multiome, reference mapping, latent space.
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 11
  • references/environment_setup.md
  • references/troubleshooting.md
  • references/data_preparation.md
  • references/scrna_integration.md
  • references/atac_peakvi.md
  • references/citeseq_totalvi.md
  • references/multiome_multivi.md
  • references/spatial_deconvolution.md
  • references/label_transfer.md
  • references/scarches_mapping.md
  • references/batch_correction_sysvi.md

以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

该技能引用了附属文件,请从来源获取完整目录;仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「scvi-tools」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-fa687f13708c476a-Scvi-%E5%B7%A5%E5%85%B7.html
请存为 .cursor/skills/scvi-tools/SKILL.md 或 .claude/skills/scvi-tools/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
该技能还带 scripts/、references/、assets/ 等文件,请从 https://github.com/anthropics/life-sciences 取完整目录,不要只建一个 SKILL.md。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/anthropics/life-sciences' --list

npx skills add 'https://github.com/anthropics/life-sciences' --skill 'scvi-tools'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版

name: scvi-tools description: Deep learning for single-cell analysis using scvi-tools. This skill should be used when users need (1) data integration and batch correction with scVI/scANVI, (2) ATAC-seq analysis with PeakVI, (3) CITE-seq multi-modal analysis with totalVI, (4) multiome RNA+ATAC analysis with MultiVI, (5) spatial transcriptomics deconvolution with DestVI, (6) label transfer and reference mapping with scANVI/scArches, (7) RNA velocity with veloVI, or (8) any deep learning-based single-cell method. Triggers include mentions of scVI, scANVI, totalVI, PeakVI, MultiVI, DestVI, veloVI, sysVI, scArches, variational autoencoder, VAE, batch correction, data integration, multi-modal, CITE-seq, multiome, reference mapping, latent space.

scvi-tools Deep Learning Skill

This skill provides guidance for deep learning-based single-cell analysis using scvi-tools, the leading framework for probabilistic models in single-cell genomics.

How to Use This Skill

  1. Identify the appropriate workflow from the model/workflow tables below
  2. Read the corresponding reference file for detailed steps and code
  3. Use scripts in scripts/ to avoid rewriting common code
  4. For installation or GPU issues, consult references/environment_setup.md
  5. For debugging, consult references/troubleshooting.md

When to Use This Skill

  • When scvi-tools, scVI, scANVI, or related models are mentioned
  • When deep learning-based batch correction or integration is needed
  • When working with multi-modal data (CITE-seq, multiome)
  • When reference mapping or label transfer is required
  • When analyzing ATAC-seq or spatial transcriptomics data
  • When learning latent representations of single-cell data

Model Selection Guide

| Data Type | Model | Primary Use Case | |-----------|-------|------------------| | scRNA-seq | scVI | Unsupervised integration, DE, imputation | | scRNA-seq + labels | scANVI | Label transfer, semi-supervised integration | | CITE-seq (RNA+protein) | totalVI | Multi-modal integration, protein denoising | | scATAC-seq | PeakVI | Chromatin accessibility analysis | | Multiome (RNA+ATAC) | MultiVI | Joint modality analysis | | Spatial + scRNA reference | DestVI | Cell type deconvolution | | RNA velocity | veloVI | Transcriptional dynamics | | Cross-technology | sysVI | System-level batch correction |

Workflow Reference Files

| Workflow | Reference File | Description | |----------|---------------|-------------| | Environment Setup | references/environment_setup.md | Installation, GPU, version info | | Data Preparation | references/data_preparation.md | Formatting data for any model | | scRNA Integration | references/scrna_integration.md | scVI/scANVI batch correction | | ATAC-seq Analysis | references/atac_peakvi.md | PeakVI for accessibility | | CITE-seq Analysis | references/citeseq_totalvi.md | totalVI for protein+RNA | | Multiome Analysis | references/multiome_multivi.md | MultiVI for RNA+ATAC | | Spatial Deconvolution | references/spatial_deconvolution.md | DestVI spatial analysis | | Label Transfer | references/label_transfer.md | scANVI reference mapping | | scArches Mapping | references/scarches_mapping.md | Query-to-reference mapping | | Batch Correction | references/batch_correction_sysvi.md | Advanced batch methods | | RNA Velocity | references/rna_velocity_velovi.md | veloVI dynamics | | Troubleshooting | references/troubleshooting.md | Common issues and solutions |

CLI Scripts

Modular scripts for common workflows. Chain together or modify as needed.

Pipeline Scripts

| Script | Purpose | Usage | |--------|---------|-------| | prepare_data.py | QC, filter, HVG selection | python scripts/prepare_data.py raw.h5ad prepared.h5ad --batch-key batch | | train_model.py | Train any scvi-tools model | python scripts/train_model.py prepared.h5ad results/ --model scvi | | cluster_embed.py | Neighbors, UMAP, Leiden | python scripts/cluster_embed.py adata.h5ad results/ | | differential_expression.py | DE analysis | python scripts/differential_expression.py model/ adata.h5ad de.csv --groupby leiden | | transfer_labels.py | Label transfer with scANVI | python scripts/transfer_labels.py ref_model/ query.h5ad results/ | | integrate_datasets.py | Multi-dataset integration | python scripts/integrate_datasets.py results/ data1.h5ad data2.h5ad | | validate_adata.py | Check data compatibility | python scripts/validate_adata.py data.h5ad --batch-key batch |

Example Workflow

# 1. Validate input data
python scripts/validate_adata.py raw.h5ad --batch-key batch --suggest

# 2. Prepare data (QC, HVG selection)
python scripts/prepare_data.py raw.h5ad prepared.h5ad --batch-key batch --n-hvgs 2000

# 3. Train model
python scripts/train_model.py prepared.h5ad results/ --model scvi --batch-key batch

# 4. Cluster and visualize
python scripts/cluster_embed.py results/adata_trained.h5ad results/ --resolution 0.8

# 5. Differential expression
python scripts/differential_expression.py results/model results/adata_clustered.h5ad results/de.csv --groupby leiden

Python Utilities

The scripts/model_utils.py provides importable functions for custom workflows:

| Function | Purpose | |----------|---------| | prepare_adata() | Data preparation (QC, HVG, layer setup) | | train_scvi() | Train scVI or scANVI | | evaluate_integration() | Compute integration metrics | | get_marker_genes() | Extract DE markers | | save_results() | Save model, data, plots | | auto_select_model() | Suggest best model | | quick_clustering() | Neighbors + UMAP + Leiden |

Critical Requirements

  1. Raw counts required: scvi-tools models require integer count data

    adata.layers["counts"] = adata.X.copy()  # Before normalization
    scvi.model.SCVI.setup_anndata(adata, layer="counts")
    
  2. HVG selection: Use 2000-4000 highly variable genes

    sc.pp.highly_variable_genes(adata, n_top_genes=2000, batch_key="batch", layer="counts", flavor="seurat_v3")
    adata = adata[:, adata.var['highly_variable']].copy()
    
  3. Batch information: Specify batch_key for integration

    scvi.model.SCVI.setup_anndata(adata, layer="counts", batch_key="batch")
    

Quick Decision Tree

Need to integrate scRNA-seq data?
├── Have cell type labels? → scANVI (references/label_transfer.md)
└── No labels? → scVI (references/scrna_integration.md)

Have multi-modal data?
├── CITE-seq (RNA + protein)? → totalVI (references/citeseq_totalvi.md)
├── Multiome (RNA + ATAC)? → MultiVI (references/multiome_multivi.md)
└── scATAC-seq only? → PeakVI (references/atac_peakvi.md)

Have spatial data?
└── Need cell type deconvolution? → DestVI (references/spatial_deconvolution.md)

Have pre-trained reference model?
└── Map query to reference? → scArches (references/scarches_mapping.md)

Need RNA velocity?
└── veloVI (references/rna_velocity_velovi.md)

Strong cross-technology batch effects?
└── sysVI (references/batch_correction_sysvi.md)

Key Resources

相关技能

Agent 工作流

Skill Creator

创造有效技能指南。 当用户想创造出新的技能(或更新现有的技能),以专业知识,工作流程,或工具集成来扩展克洛德的能力时,应该使用这种技能.

Agent 工作流

Clawdhub

使用ClawdHub CLI搜索,安装,更新并发布从taladhub.com的代理技能. 需要获取苍蝇上的新技能时使用,将安装的技能同步到最新版本或特定版本,或者发布 npm-instainddhub CLI 的新/更新的技能文件夹.

Agent 工作流

Agent Team Orchestration

管弦乐团多代理团队,任务设定周期,交接协议,审查工作流程. 使用时间: (1)建立2+特派员队伍,具有不同专业,(2)确定任务路线和生命周期(收录框_ spec_建设_审查_完成),(3)在特派员之间制定交接协议,(4)建立审查和质量关口,(5)管理特派员之间的交流和文物共享.

Agent 工作流

Superpowers

Spec-first,TDD,子代理驱动的软件开发工作流程. 当:(1)构建任何新功能或应用——触发脑暴_计划_子代理执行回路,(2)调试出一个bug或测试失败——触发系统性的根起过程,(3)用户说"让我们构建","帮助我计划","我想添加X",或"这个被打破",(4)完成一个功…