[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CTZ5QH68RF9BVDPXZ0RHKV":3,"skill-same:01M7CTZ5QH68RF9BVDPXZ0RHKV":59},{"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":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M7CTZ5QH68RF9BVDPXZ0RHKV","bio-crispr-screens-crispresso-editing",null,"Quantifies CRISPR editing outcomes with CRISPResso2 (Clement 2019 Nat Biotechnol) across Cas9-nuclease (indels, HDR), CBE and ABE base editors (target conversion + bystander), and prime editor (pegRNA-templated) modes. Covers single-amplicon (CRISPResso), multi-sample batch (CRISPRessoBatch), pooled-amplicon (CRISPRessoPooled), WGS off-target (CRISPRessoWGS), and sample-comparison (CRISPRessoCompare) workflows; quantification-window math that controls what is called edited; substitution-vs-indel diagnostic to distinguish BE from Cas9 contamination; MMEJ deletion pattern interpretation; allele-frequency tables; and failure modes from amplicon misalignment or contamination. Use when quantifying editing from amplicon sequencing, choosing CRISPResso mode by design, distinguishing intended edits from bystanders and indel byproducts, debugging low-alignment runs, or generating publication-grade editing reports.","mrsonord2240\u002Fopenscience-specialists","mrsonord2240","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F76487430?v=4","01M7CTEM40S43GSJZ9A3YCCXZK","Samuel Nord","01M7CTEM4K69JD1GBYNHVJ9ZP4",2,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Fcrispr-screen-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-crispr-screens-crispresso-editing\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: bio-crispr-screens-crispresso-editing\ndescription: Quantifies CRISPR editing outcomes with CRISPResso2 (Clement 2019 Nat Biotechnol) across Cas9-nuclease (indels, HDR), CBE and ABE base editors (target conversion + bystander), and prime editor (pegRNA-templated) modes. Covers single-amplicon (CRISPResso), multi-sample batch (CRISPRessoBatch), pooled-amplicon (CRISPRessoPooled), WGS off-target (CRISPRessoWGS), and sample-comparison (CRISPRessoCompare) workflows; quantification-window math that controls what is called edited; substitution-vs-indel diagnostic to distinguish BE from Cas9 contamination; MMEJ deletion pattern interpretation; allele-frequency tables; and failure modes from amplicon misalignment or contamination. Use when quantifying editing from amplicon sequencing, choosing CRISPResso mode by design, distinguishing intended edits from bystanders and indel byproducts, debugging low-alignment runs, or generating publication-grade editing reports.\ntool_type: cli\nprimary_tool: CRISPResso2\n---\n\n## Version Compatibility\n\nReference examples checked on CRISPResso2 2.3.4 (pinellolab\u002Fcrispresso2 Docker image), pandas 2.2+, numpy 1.26+, matplotlib 3.8+.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- CLI: `CRISPResso --version`; `CRISPRessoBatch --help`; `CRISPRessoPooled --help`; `CRISPRessoWGS --help`; `CRISPRessoCompare --help`\n- Python: `from CRISPResso2 import ...`\n\nIf code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying.\n\n## CRISPResso2 Editing Quantification\n\n**\"Quantify CRISPR editing from my amplicon sequencing\"** -> Align amplicon reads against the reference, classify each read as unmodified \u002F NHEJ \u002F HDR \u002F base-edited \u002F prime-edited within the quantification window, and report per-edit-type frequencies, indel size distributions, allele-frequency tables, and substitution-position profiles.\n\n- CLI: `CRISPResso` -- single amplicon, single sample\n- CLI: `CRISPRessoBatch` -- multi-sample with per-sample parameters\n- CLI: `CRISPRessoPooled` -- multi-amplicon pooled amplicon sequencing\n- CLI: `CRISPRessoWGS` -- off-target quantification from whole-genome BAM\n- CLI: `CRISPRessoCompare` -- pairwise outcome comparison (e.g., treated vs untreated)\n\n## Mode Decision Tree\n\n| Experimental design | Mode | Key parameters |\n|---------------------|------|----------------|\n| Single amplicon, single sample (e.g. pilot edit validation) | `CRISPResso` | `--amplicon_seq`, `--guide_seq` |\n| Same amplicon, many samples (e.g. timecourse, dose response) | `CRISPRessoBatch` | `--batch_settings` table |\n| Many amplicons, pooled in one library (e.g. arrayed validation pool) | `CRISPRessoPooled` | `--amplicons_file` |\n| Off-target survey from whole-genome BAM | `CRISPRessoWGS` | `--bam_file`, `--reference_file`, `--region_file` |\n| Comparing two CRISPResso runs (e.g. condition A vs B) | `CRISPRessoCompare` | two positional output folders |\n| HDR \u002F knock-in validation | `CRISPResso` with `--expected_hdr_amplicon_seq` | Same as base CRISPResso |\n| Cytosine base editor (C->T) | `CRISPResso --base_editor_output` | `--conversion_nuc_from C --conversion_nuc_to T` |\n| Adenine base editor (A->G) | `CRISPResso --base_editor_output` | `--conversion_nuc_from A --conversion_nuc_to G` |\n| Prime editor (templated edit) | `CRISPResso` with pegRNA parameters | `--prime_editing_pegRNA_spacer_seq`, `--prime_editing_pegRNA_extension_seq`, `--prime_editing_pegRNA_scaffold_seq` |\n\n**Fails when:**\n- Pooled-amplicon mode applied to amplicons that share primer sequences -- reads get misassigned.\n- Base editor mode without specifying `--conversion_nuc_from`\u002F`--conversion_nuc_to` -- defaults assume CBE (C->T); ABE runs will misclassify.\n- Prime editor mode without `--prime_editing_pegRNA_extension_seq` -- the RTT template is missing, no edit is detectable.\n\n## The Quantification Window\n\n**Why this matters for postdoc-level use:** CRISPResso classifies reads as \"edited\" or \"unmodified\" based on whether *modifications fall inside the quantification window* (not the whole amplicon). The window is centered on the predicted cut site (Cas9: 3 bp upstream of PAM; Cas12a: 18 bp downstream of PAM) with a default size of 1. `--quantification_window_size N` extends N bp on EACH side, so the window is 2N bp wide.\n\n```bash\n# Default Cas9 setup\n--quantification_window_size 1                  # 1-bp window at cut site\n--quantification_window_center -3               # 3 bp upstream of PAM\n\n# Base editor: widen window to cover editing positions 4-8\n--quantification_window_size 10                 # 10 bp each side (20 bp total)\n--quantification_window_center -10              # center on the editing window\n```\n\n**Consequences of mis-sized window:**\n- Too narrow: misses edits at HDR positions or far bystanders; underestimates editing\n- Too wide: includes random sequencing errors; inflates editing rate\n- Wrong center: edits at correct position are scored as outside the window\n\nFor base editing screens a widened window is conventional; CRISPResso2's own base-editor guidance uses `--quantification_window_center -17` with a window sized to span the editing positions. For prime editing with multi-base templated edits, widen to encompass the entire edit region.\n\n## Single-Amplicon Cas9 Editing\n\n**Goal:** Quantify indel frequencies and HDR efficiency from a single target site.\n\n**Approach:** Align FASTQ reads to the reference and (optional) expected-HDR amplicon, classify each read, and report aggregated statistics.\n\n```bash\nCRISPResso \\\n    --fastq_r1 sample_R1.fastq.gz \\\n    --fastq_r2 sample_R2.fastq.gz \\\n    --amplicon_seq \u003Camplicon_sequence_ref_genome> \\\n    --guide_seq \u003C20nt_protospacer_no_PAM> \\\n    --expected_hdr_amplicon_seq \u003Cedited_amplicon_for_HDR> \\  # OPTIONAL\n    --quantification_window_size 1 \\\n    --quantification_window_center -3 \\\n    --min_average_read_quality 30 \\                          # Phred quality filter\n    --output_folder sample_results \\\n    --name sample_id\n\n# Outputs:\n#   sample_results\u002F\u003Cname>\u002FCRISPResso_mapping_statistics.txt\n#   sample_results\u002F\u003Cname>\u002FCRISPResso_quantification_of_editing_frequency.txt\n#   sample_results\u002F\u003Cname>\u002FAlleles_frequency_table.zip\n#   sample_results\u002F\u003Cname>\u002F3a.\u003Cref>.Indel_size_distribution.pdf\n#   sample_results\u002F\u003Cname>\u002F4b.\u003Cref>.Insertion_deletion_substitution_locations.pdf\n#   (PDF by default; add --save_also_png for PNG)\n```\n\n**`--min_average_read_quality` changes the reported editing percentage** -- it is a real filter, not a\nneutral default. On one real test amplicon it dropped aligned reads 235->221 and shifted Modified% from\n26.38% to 24.89%. Always report the retained-read fraction (`READS ALIGNED` \u002F `READS IN INPUTS` after\nfiltering, from `CRISPResso_mapping_statistics.txt`) alongside the editing percentage so a reader can see\nhow much filtering happened.\n\n**Key outputs:**\n\n| File | Content |\n|------|---------|\n| `CRISPResso_mapping_statistics.txt` | Tab-separated, one data row: READS IN INPUTS, READS AFTER PREPROCESSING, READS ALIGNED, N_COMPUTED_ALN, ... (no percentage columns) |\n| `CRISPResso_quantification_of_editing_frequency.txt` | % unmodified, % NHEJ, % HDR (if expected), per-edit-class breakdown |\n| `Alleles_frequency_table.zip` | Per-allele sequences and frequencies (allele-level resolution) |\n| `Nucleotide_percentage_table.txt` | Per-position A\u002FC\u002FG\u002FT\u002F- frequencies (substitutions + deletions) |\n| `Quantification_window_nucleotide_percentage_table.txt` | Same, restricted to quantification window (base-editor analysis) |\n\n\n## Base Editor Quantification\n\n**Goal:** Distinguish target base conversion from bystander edits and indel byproducts.\n\n**Approach:** Run CRISPResso with `--base_editor_output` flag and specify the conversion direction; widen the quantification window to cover the editing window.\n\n```bash\n# Cytosine Base Editor (CBE): C->T conversion\nCRISPResso \\\n    --fastq_r1 cbe_sample.fastq.gz \\\n    --amplicon_seq \u003Camplicon_seq> \\\n    --guide_seq \u003C20nt_protospacer> \\\n    --base_editor_output \\\n    --conversion_nuc_from C \\\n    --conversion_nuc_to T \\\n    --quantification_window_size 10 \\\n    --quantification_window_center -10 \\\n    --output_folder cbe_results \\\n    --name cbe_sample\n\n# Adenine Base Editor (ABE): A->G conversion\nCRISPResso \\\n    --fastq_r1 abe_sample.fastq.gz \\\n    --amplicon_seq \u003Camplicon_seq> \\\n    --guide_seq \u003C20nt_protospacer> \\\n    --base_editor_output \\\n    --conversion_nuc_from A \\\n    --conversion_nuc_to G \\\n    --quantification_window_size 10 \\\n    --quantification_window_center -10 \\\n    --output_folder abe_results \\\n    --name abe_sample\n```\n\n**Reading the output:**\n\n| Metric | Where | Interpretation |\n|--------|-------|----------------|\n| Target editing % | `Quantification_window_nucleotide_percentage_table.txt`, target C\u002FA row | Primary endpoint |\n| Bystander editing % | Same table, other C\u002FA positions in window | Off-target byproduct in window |\n| Indel rate | `CRISPResso_quantification_of_editing_frequency.txt` | Cas9-like cut artifacts; should be \u003C5% for clean BE |\n| Substitution-vs-indel ratio | Derived | Ratio >10 indicates clean BE; \u003C3 indicates cut-mediated mutagenesis instead |\n\n**Critical:** Bystander editing is intrinsic to base editors (the deaminase acts across a 5-nt window); it is not noise. Report bystander rates alongside target rates. See [[base-editing-analysis]] for variant-call implications.\n\n## Prime Editor Quantification\n\n**Goal:** Quantify pegRNA-templated edits versus indel byproducts and partial edits.\n\n**Approach:** Provide spacer, extension (PBS + RTT), and scaffold sequences; CRISPResso identifies reads matching the intended edit.\n\n```bash\nCRISPResso \\\n    --fastq_r1 pe_sample.fastq.gz \\\n    --amplicon_seq \u003Camplicon_seq> \\\n    --guide_seq \u003C20nt_protospacer> \\\n    --prime_editing_pegRNA_spacer_seq \u003C20nt_protospacer> \\\n    --prime_editing_pegRNA_extension_seq \u003CRTT+PBS_sequence> \\\n    --prime_editing_pegRNA_scaffold_seq \u003Cscaffold_sequence> \\\n    --output_folder pe_results \\\n    --name pe_sample\n\n# Output adds:\n#   Prime-editing outcomes are extra amplicon rows (Reference \u002F Prime-edited \u002F Scaffold-incorporated)\n#   inside CRISPResso_quantification_of_editing_frequency.txt\n```\n\n**Reading prime-editor output:**\n\n| Metric | Interpretation |\n|--------|----------------|\n| Intended edit % | The pegRNA-encoded edit was correctly installed |\n| Scaffold incorporation % | Reverse transcription read into scaffold instead of stopping at edit; failure mode |\n| Indel % | Nick-only editing without templated repair; common at low-PE-activity sites |\n| Unmodified % | Read matches the reference exactly |\n\nA high-quality prime-edit run shows intended-edit fraction >5% and scaffold incorporation \u003C2%. See [[prime-editing-screens]] for pegRNA design rules.\n\n## Batch Mode (Multi-Sample, Same Amplicon)\n\n**Goal:** Process tens to hundreds of samples with same amplicon design (e.g., a timecourse, dose response, or replicate panel).\n\n**Approach:** Provide a tab-separated batch settings file with per-sample parameters; CRISPRessoBatch runs all in parallel.\n\n```bash\n# batch_settings.txt (tab-separated, headers required)\n# name    fastq_r1                fastq_r2                amplicon_seq    guide_seq\n# t0      t0_R1.fq.gz             t0_R2.fq.gz             ACGT...         GUIDE\n# t6      t6_R1.fq.gz             t6_R2.fq.gz             ACGT...         GUIDE\n# t12     t12_R1.fq.gz            t12_R2.fq.gz            ACGT...         GUIDE\n# t24     t24_R1.fq.gz            t24_R2.fq.gz            ACGT...         GUIDE\n\nCRISPRessoBatch \\\n    --batch_settings batch_settings.txt \\\n    --batch_output_folder batch_run \\\n    --skip_failed \\\n    --n_processes 8\n\n# Outputs:\n#   batch_run\u002FCRISPRessoBatch_RUNNING_LOG.txt\n#   batch_run\u002FCRISPRessoBatch_quantification_of_editing_frequency.txt  (aggregated)\n#   batch_run\u002FCRISPResso_on_\u003Cname>\u002F for each sample\n```\n\n## Pooled-Amplicon Mode\n\n**Goal:** Process multi-amplicon sequencing libraries (e.g., arrayed validation pools).\n\n**Approach:** Provide an amplicon table with one row per target; CRISPRessoPooled de-multiplexes reads to the correct amplicon.\n\n```bash\n# amplicons.txt (tab-separated; header may vary by CRISPResso2 version)\n# amplicon_name  amplicon_seq    guide_seq\n# BRCA1_exon3    ACGT...         GUIDE1\n# TP53_exon7     ACGT...         GUIDE2\n# KRAS_codon12   ACGT...         GUIDE3\n\nCRISPRessoPooled \\\n    --fastq_r1 pooled_R1.fastq.gz \\\n    --fastq_r2 pooled_R2.fastq.gz \\\n    --amplicons_file amplicons.txt \\\n    --output_folder pooled_run \\\n    --min_reads_to_use_region 100 \\                          # see note below\n    --n_processes 8\n\n# Outputs:\n#   pooled_run\u002FSAMPLES_QUANTIFICATION_SUMMARY.txt\n#   pooled_run\u002FCRISPResso_on_\u003Camplicon>\u002F for each amplicon\n```\n\n**`--min_reads_to_use_region` defaults to 1000.** Any amplicon with fewer aligned reads than this is silently\nskipped -- CRISPRessoPooled still exits 0 and writes a complete-looking `SAMPLES_QUANTIFICATION_SUMMARY.txt`,\nbut every field for that amplicon is `NA` (confirmed: a real 2-amplicon, ~250-reads\u002Famplicon pilot pool --\nexactly the \"arrayed validation pool\" use case this mode is for -- returns all-NA at the default). Set\n`--min_reads_to_use_region` below the expected per-amplicon read depth for pilot\u002Fvalidation-scale pools.\nAlways check `SAMPLES_QUANTIFICATION_SUMMARY.txt` for `NA` rows before trusting the output.\n\n**Failure mode:** Amplicons with shared primer regions get reads assigned to whichever amplicon comes first. Design primers with ≥3-bp distinguishing regions or use unique molecular identifiers.\n\n## WGS Off-Target Mode\n\n**Goal:** Quantify off-target editing from whole-genome sequencing.\n\n**Approach:** Provide BAM file + reference + BED file of suspected off-target sites; CRISPResso extracts reads from each region and quantifies edits.\n\n```bash\nCRISPRessoWGS \\\n    --bam aligned.bam \\\n    --reference genome.fa \\\n    --region_file off_targets.bed \\\n    --output_folder wgs_run \\\n    --n_processes 8\n```\n\n**Use case:** Validate empirically that an in vivo \u002F clinical-grade edit has minimal off-target activity (combine with GUIDE-seq or CIRCLE-seq predicted sites).\n\n## Parse Output in Python\n\n**Goal:** Pull editing metrics into downstream analysis or reports.\n\n**Approach:** Read the tab-separated quantification files and the JSON metadata.\n\n```python\nimport pandas as pd\nimport json\nfrom pathlib import Path\n\ndef parse_crispresso(output_dir):\n    '''Extract key metrics from CRISPResso output directory.'''\n    out = {}\n    # Mapping statistics: 7-column, 2-row TSV (header + one data row); no percentage column,\n    # so compute mapping_pct from READS ALIGNED \u002F READS IN INPUTS.\n    map_stats = pd.read_csv(Path(output_dir) \u002F 'CRISPResso_mapping_statistics.txt', sep='\\t').iloc[0]\n    out['reads_in_input'] = int(map_stats['READS IN INPUTS'])\n    out['reads_aligned'] = int(map_stats['READS ALIGNED'])\n    out['mapping_pct'] = out['reads_aligned'] \u002F out['reads_in_input'] * 100\n    # Editing quantification\n    quant = pd.read_csv(Path(output_dir) \u002F 'CRISPResso_quantification_of_editing_frequency.txt', sep='\\t')\n    out['editing_quant'] = quant.set_index('Amplicon').to_dict()\n    # JSON metadata\n    info_path = Path(output_dir) \u002F 'CRISPResso2_info.json'\n    if info_path.exists():\n        out['info'] = json.loads(info_path.read_text())\n    return out\n```\n\n## Failure Modes\n\n### Low alignment rate (\u003C50%)\n\n**Trigger:** Wrong amplicon sequence (off by one nt, wrong strand, primer-trimmed vs untrimmed).\n**Mechanism:** CRISPResso fails to align reads beyond the amplicon edges; discards as unmappable.\n**Symptom:** `READS ALIGNED` \u002F `READS IN INPUTS` (from `CRISPResso_mapping_statistics.txt`, see `parse_crispresso()` above) \u003C50%; per-position coverage drops at amplicon edges.\n**Fix:** Re-derive amplicon from genome at primer-trimmed boundaries; verify strand orientation; check that primers are NOT included in `--amplicon_seq`.\n\n### Total alignment failure (wrong locus \u002F zero output)\n\n**Trigger:** Amplicon sequence is from the wrong locus entirely (e.g. wrong gene), not just off-by-a-few-nt.\n**Mechanism:** No reads align at all; CRISPResso exits with a hard error instead of writing a graded result.\n**Symptom:** `CRITICAL: Alignment error, please check your input. \u002F ERROR: No alignments were found`, exit code 1, no output folder written -- there is no percentage file to inspect in this case.\n**Fix:** Confirm the amplicon sequence actually corresponds to the intended target locus (BLAT\u002FBLAST it against the reference genome) before re-checking primer trimming or strand.\n\n### High substitution rate but low indel (Cas9 sample)\n\n**Trigger:** Sample contamination with adjacent amplicon, primer-dimer, or sequencing error inflation.\n**Mechanism:** Random substitutions inflate the per-position substitution rate without true indels.\n**Symptom:** Substitutions >2% at base positions outside the cut site; alignment metrics look fine.\n**Fix:** Increase `--min_average_read_quality` to 30+; filter contaminating amplicons; check primer-dimer in `CRISPResso_RUNNING_LOG.txt`.\n\n### Bystander C\u002FA editing inflates \"editing efficiency\"\n\n**Trigger:** Base-editor sample with wide quantification window; bystander Cs at adjacent positions counted as edits.\n**Mechanism:** Default `--quantification_window_size 10` includes all positions in editing window; bystander edits are real but distinct from target edit.\n**Symptom:** Editing efficiency 80%+ but target SNV is 30%; bystander rate is 50%.\n**Fix:** Always read the per-position table (`Quantification_window_nucleotide_percentage_table.txt`), not just the aggregate. Report target and bystander rates separately. See [[base-editing-analysis]].\n\n### Prime editor sample with high scaffold incorporation\n\n**Trigger:** RTT is too short relative to PBS, or pegRNA stops short.\n**Mechanism:** Reverse transcriptase reads past the edit into scaffold sequence; product is detectable but undesired.\n**Symptom:** Scaffold incorporation >5%; intended edit efficiency lower than expected.\n**Fix:** Re-design pegRNA with longer RTT; verify with PRIDICT2 (see [[prime-editing-screens]]).\n\n### MMEJ deletion misclassified as NHEJ\n\n**Trigger:** Deletions with microhomology at junction; CRISPResso reports them as indels but doesn't distinguish MMEJ.\n**Mechanism:** MMEJ creates predictable deletions using flanking microhomologies; biologically distinct from random NHEJ.\n**Symptom:** Recurring same-size deletions in allele table (e.g., -7 bp deletion in 30% of reads).\n**Fix:** Examine `Alleles_frequency_table` for over-represented allele patterns; flag MMEJ-mediated deletions for interpretation (these may be inferred from indel hotspots).\n\n## Quantitative Thresholds\n\n| Threshold | Value | Source \u002F Rationale |\n|-----------|-------|--------------------|\n| Cas9 editing efficiency (functional KO) | >70% indels | Field convention; below this, KO is incomplete |\n| Indel rate (clean base editor) | \u003C5% | Field convention; >5% = unwanted cut activity |\n| Target conversion (CBE) | >30% | Variable by target; below this, screen power is poor |\n| Target conversion (ABE) | >30% | ABE typically lower per-base than CBE |\n| Bystander rate (BE) | \u003C10% acceptable; \u003C5% ideal | Application-dependent; for variant function studies, must be controlled |\n| Intended-edit % (prime editor) | >5% per-edit | Field convention; can be 50%+ at favorable sites |\n| Scaffold incorporation (PE) | \u003C2% | High-quality pegRNA design |\n| Alignment rate | >85% | Below this, amplicon design or contamination issue |\n| Minimum read quality | Phred 30 | Q30 Illumina base-call-accuracy standard |\n| Quantification window size (Cas9) | 1 | Clement 2019 default; precise cut-site analysis |\n| Quantification window size (BE) | 10 | Cover editing window positions 4-13 |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| Alignment rate \u003C50% | Wrong amplicon sequence | Re-verify; primers should NOT be in amplicon_seq |\n| `CRITICAL: No alignments were found`, exit 1, no output folder | Amplicon from the wrong locus entirely | Confirm amplicon matches the intended target locus before re-checking trimming\u002Fstrand |\n| All reads \"modified\" | Misaligned reference | Check amplicon strand; reverse-complement test |\n| BE shows mostly indels | Cas9 contamination or wrong protein | Re-derive cell line origin; check Cas9 vs nCas9-BE3 |\n| Inconsistent batch results | Different amplicon_seq per sample | Use CRISPRessoBatch with consistent amplicon |\n| Pooled-amplicon misassignment | Primer overlap between amplicons | Re-design with ≥3-bp distinguishing regions |\n| Pooled amplicon rows all `NA` | Per-amplicon reads below `--min_reads_to_use_region` (default 1000) | Lower `--min_reads_to_use_region` for pilot\u002Fvalidation-scale pools |\n| Out-of-window edits ignored | Window too narrow | Increase `--quantification_window_size` |\n| Scaffold incorporation high (PE) | RTT too short | Re-design pegRNA |\n| Allele frequency dominated by 1 read | Low input \u002F clonal | Verify input cell count; rerun if singleton |\n\n## References\n\n- Clement K et al. 2019. *Nat Biotechnol* 37:224. CRISPResso2 algorithm and modes.\n- Pinello L et al. 2016. *Nat Biotechnol* 34:695. Original CRISPResso.\n- Anzalone AV et al. 2019. *Nature* 576:149. Prime editing (PE-1\u002FPE-2\u002FPE-3).\n- Komor AC et al. 2016. *Nature* 533:420. Base editing (BE3).\n- Findlay GM et al. 2018. *Nature* 562:217. Saturation genome editing.\n\n## Related Skills\n\n- crispr-screens\u002Fbase-editing-analysis - Variant-function analysis using CRISPResso2 BE output\n- crispr-screens\u002Fprime-editing-screens - PRIDICT2 pegRNA design + PE-tiling\n- crispr-screens\u002Flibrary-design - sgRNA \u002F pegRNA design for editing screens\n- crispr-screens\u002Fscreen-qc - Editing-efficiency QC for variant interpretation\n- variant-calling\u002Fvariant-annotation - Annotate detected variants downstream\n- read-alignment\u002Fbwa-alignment - For WGS off-target alignment input\n","## Version Compatibility\n\nReference examples checked on CRISPResso2 2.3.4 (pinellolab\u002Fcrispresso2 Docker image), pandas 2.2+, numpy 1.26+, matplotlib 3.8+.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- CLI: `CRISPResso --version`; `CRISPRessoBatch --help`; `CRISPRessoPooled --help`; `CRISPRessoWGS --help`; `CRISPRessoCompare --help`\n- Python: `from CRISPResso2 import ...`\n\nIf code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying.\n\n## CRISPResso2 Editing Quantification\n\n**\"Quantify CRISPR editing from my amplicon sequencing\"** -> Align amplicon reads against the reference, classify each read as unmodified \u002F NHEJ \u002F HDR \u002F base-edited \u002F prime-edited within the quantification window, and report per-edit-type frequencies, indel size distributions, allele-frequency tables, and substitution-position profiles.\n\n- CLI: `CRISPResso` -- single amplicon, single sample\n- CLI: `CRISPRessoBatch` -- multi-sample with per-sample parameters\n- CLI: `CRISPRessoPooled` -- multi-amplicon pooled amplicon sequencing\n- CLI: `CRISPRessoWGS` -- off-target quantification from whole-genome BAM\n- CLI: `CRISPRessoCompare` -- pairwise outcome comparison (e.g., treated vs untreated)\n\n## Mode Decision Tree\n\n| Experimental design | Mode | Key parameters |\n|---------------------|------|----------------|\n| Single amplicon, single sample (e.g. pilot edit validation) | `CRISPResso` | `--amplicon_seq`, `--guide_seq` |\n| Same amplicon, many samples (e.g. timecourse, dose response) | `CRISPRessoBatch` | `--batch_settings` table |\n| Many amplicons, pooled in one library (e.g. arrayed validation pool) | `CRISPRessoPooled` | `--amplicons_file` |\n| Off-target survey from whole-genome BAM | `CRISPRessoWGS` | `--bam_file`, `--reference_file`, `--region_file` |\n| Comparing two CRISPResso runs (e.g. condition A vs B) | `CRISPRessoCompare` | two positional output folders |\n| HDR \u002F knock-in validation | `CRISPResso` with `--expected_hdr_amplicon_seq` | Same as base CRISPResso |\n| Cytosine base editor (C->T) | `CRISPResso --base_editor_output` | `--conversion_nuc_from C --conversion_nuc_to T` |\n| Adenine base editor (A->G) | `CRISPResso --base_editor_output` | `--conversion_nuc_from A --conversion_nuc_to G` |\n| Prime editor (templated edit) | `CRISPResso` with pegRNA parameters | `--prime_editing_pegRNA_spacer_seq`, `--prime_editing_pegRNA_extension_seq`, `--prime_editing_pegRNA_scaffold_seq` |\n\n**Fails when:**\n- Pooled-amplicon mode applied to amplicons that share primer sequences -- reads get misassigned.\n- Base editor mode without specifying `--conversion_nuc_from`\u002F`--conversion_nuc_to` -- defaults assume CBE (C->T); ABE runs will misclassify.\n- Prime editor mode without `--prime_editing_pegRNA_extension_seq` -- the RTT template is missing, no edit is detectable.\n\n## The Quantification Window\n\n**Why this matters for postdoc-level use:** CRISPResso classifies reads as \"edited\" or \"unmodified\" based on whether *modifications fall inside the quantification window* (not the whole amplicon). The window is centered on the predicted cut site (Cas9: 3 bp upstream of PAM; Cas12a: 18 bp downstream of PAM) with a default size of 1. `--quantification_window_size N` extends N bp on EACH side, so the window is 2N bp wide.\n\n```bash\n# Default Cas9 setup\n--quantification_window_size 1                  # 1-bp window at cut site\n--quantification_window_center -3               # 3 bp upstream of PAM\n\n# Base editor: widen window to cover editing positions 4-8\n--quantification_window_size 10                 # 10 bp each side (20 bp total)\n--quantification_window_center -10              # center on the editing window\n```\n\n**Consequences of mis-sized window:**\n- Too narrow: misses edits at HDR positions or far bystanders; underestimates editing\n- Too wide: includes random sequencing errors; inflates editing rate\n- Wrong center: edits at correct position are scored as outside the window\n\nFor base editing screens a widened window is conventional; CRISPResso2's own base-editor guidance uses `--quantification_window_center -17` with a window sized to span the editing positions. For prime editing with multi-base templated edits, widen to encompass the entire edit region.\n\n## Single-Amplicon Cas9 Editing\n\n**Goal:** Quantify indel frequencies and HDR efficiency from a single target site.\n\n**Approach:** Align FASTQ reads to the reference and (optional) expected-HDR amplicon, classify each read, and report aggregated statistics.\n\n```bash\nCRISPResso \\\n    --fastq_r1 sample_R1.fastq.gz \\\n    --fastq_r2 sample_R2.fastq.gz \\\n    --amplicon_seq \u003Camplicon_sequence_ref_genome> \\\n    --guide_seq \u003C20nt_protospacer_no_PAM> \\\n    --expected_hdr_amplicon_seq \u003Cedited_amplicon_for_HDR> \\  # OPTIONAL\n    --quantification_window_size 1 \\\n    --quantification_window_center -3 \\\n    --min_average_read_quality 30 \\                          # Phred quality filter\n    --output_folder sample_results \\\n    --name sample_id\n\n# Outputs:\n#   sample_results\u002F\u003Cname>\u002FCRISPResso_mapping_statistics.txt\n#   sample_results\u002F\u003Cname>\u002FCRISPResso_quantification_of_editing_frequency.txt\n#   sample_results\u002F\u003Cname>\u002FAlleles_frequency_table.zip\n#   sample_results\u002F\u003Cname>\u002F3a.\u003Cref>.Indel_size_distribution.pdf\n#   sample_results\u002F\u003Cname>\u002F4b.\u003Cref>.Insertion_deletion_substitution_locations.pdf\n#   (PDF by default; add --save_also_png for PNG)\n```\n\n**`--min_average_read_quality` changes the reported editing percentage** -- it is a real filter, not a\nneutral default. On one real test amplicon it dropped aligned reads 235->221 and shifted Modified% from\n26.38% to 24.89%. Always report the retained-read fraction (`READS ALIGNED` \u002F `READS IN INPUTS` after\nfiltering, from `CRISPResso_mapping_statistics.txt`) alongside the editing percentage so a reader can see\nhow much filtering happened.\n\n**Key outputs:**\n\n| File | Content |\n|------|---------|\n| `CRISPResso_mapping_statistics.txt` | Tab-separated, one data row: READS IN INPUTS, READS AFTER PREPROCESSING, READS ALIGNED, N_COMPUTED_ALN, ... (no percentage columns) |\n| `CRISPResso_quantification_of_editing_frequency.txt` | % unmodified, % NHEJ, % HDR (if expected), per-edit-class breakdown |\n| `Alleles_frequency_table.zip` | Per-allele sequences and frequencies (allele-level resolution) |\n| `Nucleotide_percentage_table.txt` | Per-position A\u002FC\u002FG\u002FT\u002F- frequencies (substitutions + deletions) |\n| `Quantification_window_nucleotide_percentage_table.txt` | Same, restricted to quantification window (base-editor analysis) |\n\n\n## Base Editor Quantification\n\n**Goal:** Distinguish target base conversion from bystander edits and indel byproducts.\n\n**Approach:** Run CRISPResso with `--base_editor_output` flag and specify the conversion direction; widen the quantification window to cover the editing window.\n\n```bash\n# Cytosine Base Editor (CBE): C->T conversion\nCRISPResso \\\n    --fastq_r1 cbe_sample.fastq.gz \\\n    --amplicon_seq \u003Camplicon_seq> \\\n    --guide_seq \u003C20nt_protospacer> \\\n    --base_editor_output \\\n    --conversion_nuc_from C \\\n    --conversion_nuc_to T \\\n    --quantification_window_size 10 \\\n    --quantification_window_center -10 \\\n    --output_folder cbe_results \\\n    --name cbe_sample\n\n# Adenine Base Editor (ABE): A->G conversion\nCRISPResso \\\n    --fastq_r1 abe_sample.fastq.gz \\\n    --amplicon_seq \u003Camplicon_seq> \\\n    --guide_seq \u003C20nt_protospacer> \\\n    --base_editor_output \\\n    --conversion_nuc_from A \\\n    --conversion_nuc_to G \\\n    --quantification_window_size 10 \\\n    --quantification_window_center -10 \\\n    --output_folder abe_results \\\n    --name abe_sample\n```\n\n**Reading the output:**\n\n| Metric | Where | Interpretation |\n|--------|-------|----------------|\n| Target editing % | `Quantification_window_nucleotide_percentage_table.txt`, target C\u002FA row | Primary endpoint |\n| Bystander editing % | Same table, other C\u002FA positions in window | Off-target byproduct in window |\n| Indel rate | `CRISPResso_quantification_of_editing_frequency.txt` | Cas9-like cut artifacts; should be \u003C5% for clean BE |\n| Substitution-vs-indel ratio | Derived | Ratio >10 indicates clean BE; \u003C3 indicates cut-mediated mutagenesis instead |\n\n**Critical:** Bystander editing is intrinsic to base editors (the deaminase acts across a 5-nt window); it is not noise. Report bystander rates alongside target rates. See [[base-editing-analysis]] for variant-call implications.\n\n## Prime Editor Quantification\n\n**Goal:** Quantify pegRNA-templated edits versus indel byproducts and partial edits.\n\n**Approach:** Provide spacer, extension (PBS + RTT), and scaffold sequences; CRISPResso identifies reads matching the intended edit.\n\n```bash\nCRISPResso \\\n    --fastq_r1 pe_sample.fastq.gz \\\n    --amplicon_seq \u003Camplicon_seq> \\\n    --guide_seq \u003C20nt_protospacer> \\\n    --prime_editing_pegRNA_spacer_seq \u003C20nt_protospacer> \\\n    --prime_editing_pegRNA_extension_seq \u003CRTT+PBS_sequence> \\\n    --prime_editing_pegRNA_scaffold_seq \u003Cscaffold_sequence> \\\n    --output_folder pe_results \\\n    --name pe_sample\n\n# Output adds:\n#   Prime-editing outcomes are extra amplicon rows (Reference \u002F Prime-edited \u002F Scaffold-incorporated)\n#   inside CRISPResso_quantification_of_editing_frequency.txt\n```\n\n**Reading prime-editor output:**\n\n| Metric | Interpretation |\n|--------|----------------|\n| Intended edit % | The pegRNA-encoded edit was correctly installed |\n| Scaffold incorporation % | Reverse transcription read into scaffold instead of stopping at edit; failure mode |\n| Indel % | Nick-only editing without templated repair; common at low-PE-activity sites |\n| Unmodified % | Read matches the reference exactly |\n\nA high-quality prime-edit run shows intended-edit fraction >5% and scaffold incorporation \u003C2%. See [[prime-editing-screens]] for pegRNA design rules.\n\n## Batch Mode (Multi-Sample, Same Amplicon)\n\n**Goal:** Process tens to hundreds of samples with same amplicon design (e.g., a timecourse, dose response, or replicate panel).\n\n**Approach:** Provide a tab-separated batch settings file with per-sample parameters; CRISPRessoBatch runs all in parallel.\n\n```bash\n# batch_settings.txt (tab-separated, headers required)\n# name    fastq_r1                fastq_r2                amplicon_seq    guide_seq\n# t0      t0_R1.fq.gz             t0_R2.fq.gz             ACGT...         GUIDE\n# t6      t6_R1.fq.gz             t6_R2.fq.gz             ACGT...         GUIDE\n# t12     t12_R1.fq.gz            t12_R2.fq.gz            ACGT...         GUIDE\n# t24     t24_R1.fq.gz            t24_R2.fq.gz            ACGT...         GUIDE\n\nCRISPRessoBatch \\\n    --batch_settings batch_settings.txt \\\n    --batch_output_folder batch_run \\\n    --skip_failed \\\n    --n_processes 8\n\n# Outputs:\n#   batch_run\u002FCRISPRessoBatch_RUNNING_LOG.txt\n#   batch_run\u002FCRISPRessoBatch_quantification_of_editing_frequency.txt  (aggregated)\n#   batch_run\u002FCRISPResso_on_\u003Cname>\u002F for each sample\n```\n\n## Pooled-Amplicon Mode\n\n**Goal:** Process multi-amplicon sequencing libraries (e.g., arrayed validation pools).\n\n**Approach:** Provide an amplicon table with one row per target; CRISPRessoPooled de-multiplexes reads to the correct amplicon.\n\n```bash\n# amplicons.txt (tab-separated; header may vary by CRISPResso2 version)\n# amplicon_name  amplicon_seq    guide_seq\n# BRCA1_exon3    ACGT...         GUIDE1\n# TP53_exon7     ACGT...         GUIDE2\n# KRAS_codon12   ACGT...         GUIDE3\n\nCRISPRessoPooled \\\n    --fastq_r1 pooled_R1.fastq.gz \\\n    --fastq_r2 pooled_R2.fastq.gz \\\n    --amplicons_file amplicons.txt \\\n    --output_folder pooled_run \\\n    --min_reads_to_use_region 100 \\                          # see note below\n    --n_processes 8\n\n# Outputs:\n#   pooled_run\u002FSAMPLES_QUANTIFICATION_SUMMARY.txt\n#   pooled_run\u002FCRISPResso_on_\u003Camplicon>\u002F for each amplicon\n```\n\n**`--min_reads_to_use_region` defaults to 1000.** Any amplicon with fewer aligned reads than this is silently\nskipped -- CRISPRessoPooled still exits 0 and writes a complete-looking `SAMPLES_QUANTIFICATION_SUMMARY.txt`,\nbut every field for that amplicon is `NA` (confirmed: a real 2-amplicon, ~250-reads\u002Famplicon pilot pool --\nexactly the \"arrayed validation pool\" use case this mode is for -- returns all-NA at the default). Set\n`--min_reads_to_use_region` below the expected per-amplicon read depth for pilot\u002Fvalidation-scale pools.\nAlways check `SAMPLES_QUANTIFICATION_SUMMARY.txt` for `NA` rows before trusting the output.\n\n**Failure mode:** Amplicons with shared primer regions get reads assigned to whichever amplicon comes first. Design primers with ≥3-bp distinguishing regions or use unique molecular identifiers.\n\n## WGS Off-Target Mode\n\n**Goal:** Quantify off-target editing from whole-genome sequencing.\n\n**Approach:** Provide BAM file + reference + BED file of suspected off-target sites; CRISPResso extracts reads from each region and quantifies edits.\n\n```bash\nCRISPRessoWGS \\\n    --bam aligned.bam \\\n    --reference genome.fa \\\n    --region_file off_targets.bed \\\n    --output_folder wgs_run \\\n    --n_processes 8\n```\n\n**Use case:** Validate empirically that an in vivo \u002F clinical-grade edit has minimal off-target activity (combine with GUIDE-seq or CIRCLE-seq predicted sites).\n\n## Parse Output in Python\n\n**Goal:** Pull editing metrics into downstream analysis or reports.\n\n**Approach:** Read the tab-separated quantification files and the JSON metadata.\n\n```python\nimport pandas as pd\nimport json\nfrom pathlib import Path\n\ndef parse_crispresso(output_dir):\n    '''Extract key metrics from CRISPResso output directory.'''\n    out = {}\n    # Mapping statistics: 7-column, 2-row TSV (header + one data row); no percentage column,\n    # so compute mapping_pct from READS ALIGNED \u002F READS IN INPUTS.\n    map_stats = pd.read_csv(Path(output_dir) \u002F 'CRISPResso_mapping_statistics.txt', sep='\\t').iloc[0]\n    out['reads_in_input'] = int(map_stats['READS IN INPUTS'])\n    out['reads_aligned'] = int(map_stats['READS ALIGNED'])\n    out['mapping_pct'] = out['reads_aligned'] \u002F out['reads_in_input'] * 100\n    # Editing quantification\n    quant = pd.read_csv(Path(output_dir) \u002F 'CRISPResso_quantification_of_editing_frequency.txt', sep='\\t')\n    out['editing_quant'] = quant.set_index('Amplicon').to_dict()\n    # JSON metadata\n    info_path = Path(output_dir) \u002F 'CRISPResso2_info.json'\n    if info_path.exists():\n        out['info'] = json.loads(info_path.read_text())\n    return out\n```\n\n## Failure Modes\n\n### Low alignment rate (\u003C50%)\n\n**Trigger:** Wrong amplicon sequence (off by one nt, wrong strand, primer-trimmed vs untrimmed).\n**Mechanism:** CRISPResso fails to align reads beyond the amplicon edges; discards as unmappable.\n**Symptom:** `READS ALIGNED` \u002F `READS IN INPUTS` (from `CRISPResso_mapping_statistics.txt`, see `parse_crispresso()` above) \u003C50%; per-position coverage drops at amplicon edges.\n**Fix:** Re-derive amplicon from genome at primer-trimmed boundaries; verify strand orientation; check that primers are NOT included in `--amplicon_seq`.\n\n### Total alignment failure (wrong locus \u002F zero output)\n\n**Trigger:** Amplicon sequence is from the wrong locus entirely (e.g. wrong gene), not just off-by-a-few-nt.\n**Mechanism:** No reads align at all; CRISPResso exits with a hard error instead of writing a graded result.\n**Symptom:** `CRITICAL: Alignment error, please check your input. \u002F ERROR: No alignments were found`, exit code 1, no output folder written -- there is no percentage file to inspect in this case.\n**Fix:** Confirm the amplicon sequence actually corresponds to the intended target locus (BLAT\u002FBLAST it against the reference genome) before re-checking primer trimming or strand.\n\n### High substitution rate but low indel (Cas9 sample)\n\n**Trigger:** Sample contamination with adjacent amplicon, primer-dimer, or sequencing error inflation.\n**Mechanism:** Random substitutions inflate the per-position substitution rate without true indels.\n**Symptom:** Substitutions >2% at base positions outside the cut site; alignment metrics look fine.\n**Fix:** Increase `--min_average_read_quality` to 30+; filter contaminating amplicons; check primer-dimer in `CRISPResso_RUNNING_LOG.txt`.\n\n### Bystander C\u002FA editing inflates \"editing efficiency\"\n\n**Trigger:** Base-editor sample with wide quantification window; bystander Cs at adjacent positions counted as edits.\n**Mechanism:** Default `--quantification_window_size 10` includes all positions in editing window; bystander edits are real but distinct from target edit.\n**Symptom:** Editing efficiency 80%+ but target SNV is 30%; bystander rate is 50%.\n**Fix:** Always read the per-position table (`Quantification_window_nucleotide_percentage_table.txt`), not just the aggregate. Report target and bystander rates separately. See [[base-editing-analysis]].\n\n### Prime editor sample with high scaffold incorporation\n\n**Trigger:** RTT is too short relative to PBS, or pegRNA stops short.\n**Mechanism:** Reverse transcriptase reads past the edit into scaffold sequence; product is detectable but undesired.\n**Symptom:** Scaffold incorporation >5%; intended edit efficiency lower than expected.\n**Fix:** Re-design pegRNA with longer RTT; verify with PRIDICT2 (see [[prime-editing-screens]]).\n\n### MMEJ deletion misclassified as NHEJ\n\n**Trigger:** Deletions with microhomology at junction; CRISPResso reports them as indels but doesn't distinguish MMEJ.\n**Mechanism:** MMEJ creates predictable deletions using flanking microhomologies; biologically distinct from random NHEJ.\n**Symptom:** Recurring same-size deletions in allele table (e.g., -7 bp deletion in 30% of reads).\n**Fix:** Examine `Alleles_frequency_table` for over-represented allele patterns; flag MMEJ-mediated deletions for interpretation (these may be inferred from indel hotspots).\n\n## Quantitative Thresholds\n\n| Threshold | Value | Source \u002F Rationale |\n|-----------|-------|--------------------|\n| Cas9 editing efficiency (functional KO) | >70% indels | Field convention; below this, KO is incomplete |\n| Indel rate (clean base editor) | \u003C5% | Field convention; >5% = unwanted cut activity |\n| Target conversion (CBE) | >30% | Variable by target; below this, screen power is poor |\n| Target conversion (ABE) | >30% | ABE typically lower per-base than CBE |\n| Bystander rate (BE) | \u003C10% acceptable; \u003C5% ideal | Application-dependent; for variant function studies, must be controlled |\n| Intended-edit % (prime editor) | >5% per-edit | Field convention; can be 50%+ at favorable sites |\n| Scaffold incorporation (PE) | \u003C2% | High-quality pegRNA design |\n| Alignment rate | >85% | Below this, amplicon design or contamination issue |\n| Minimum read quality | Phred 30 | Q30 Illumina base-call-accuracy standard |\n| Quantification window size (Cas9) | 1 | Clement 2019 default; precise cut-site analysis |\n| Quantification window size (BE) | 10 | Cover editing window positions 4-13 |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| Alignment rate \u003C50% | Wrong amplicon sequence | Re-verify; primers should NOT be in amplicon_seq |\n| `CRITICAL: No alignments were found`, exit 1, no output folder | Amplicon from the wrong locus entirely | Confirm amplicon matches the intended target locus before re-checking trimming\u002Fstrand |\n| All reads \"modified\" | Misaligned reference | Check amplicon strand; reverse-complement test |\n| BE shows mostly indels | Cas9 contamination or wrong protein | Re-derive cell line origin; check Cas9 vs nCas9-BE3 |\n| Inconsistent batch results | Different amplicon_seq per sample | Use CRISPRessoBatch with consistent amplicon |\n| Pooled-amplicon misassignment | Primer overlap between amplicons | Re-design with ≥3-bp distinguishing regions |\n| Pooled amplicon rows all `NA` | Per-amplicon reads below `--min_reads_to_use_region` (default 1000) | Lower `--min_reads_to_use_region` for pilot\u002Fvalidation-scale pools |\n| Out-of-window edits ignored | Window too narrow | Increase `--quantification_window_size` |\n| Scaffold incorporation high (PE) | RTT too short | Re-design pegRNA |\n| Allele frequency dominated by 1 read | Low input \u002F clonal | Verify input cell count; rerun if singleton |\n\n## References\n\n- Clement K et al. 2019. *Nat Biotechnol* 37:224. CRISPResso2 algorithm and modes.\n- Pinello L et al. 2016. *Nat Biotechnol* 34:695. Original CRISPResso.\n- Anzalone AV et al. 2019. *Nature* 576:149. Prime editing (PE-1\u002FPE-2\u002FPE-3).\n- Komor AC et al. 2016. *Nature* 533:420. Base editing (BE3).\n- Findlay GM et al. 2018. *Nature* 562:217. Saturation genome editing.\n\n## Related Skills\n\n- crispr-screens\u002Fbase-editing-analysis - Variant-function analysis using CRISPResso2 BE output\n- crispr-screens\u002Fprime-editing-screens - PRIDICT2 pegRNA design + PE-tiling\n- crispr-screens\u002Flibrary-design - sgRNA \u002F pegRNA design for editing screens\n- crispr-screens\u002Fscreen-qc - Editing-efficiency QC for variant interpretation\n- variant-calling\u002Fvariant-annotation - Annotate detected variants downstream\n- read-alignment\u002Fbwa-alignment - For WGS off-target alignment input\n",{"name":5,"tool_type":24,"description":7,"primary_tool":25},"cli","CRISPResso2","main","e0956dc9606356ab78468936b502e55a365282e2","specialists\u002Fcrispr-screen-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-crispr-screens-crispresso-editing",0,"https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists","https:\u002F\u002Fgithub.com\u002Fmrsonord2240","2026-10-12 03:19:04",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add mrsonord2240\u002Fopenscience-specialists --skill bio-crispr-screens-crispresso-editing",{"tool":39,"command":40},"bunx","bunx skills add mrsonord2240\u002Fopenscience-specialists --skill bio-crispr-screens-crispresso-editing",{"tool":42,"command":43},"pnpm","pnpm dlx skills add mrsonord2240\u002Fopenscience-specialists --skill bio-crispr-screens-crispresso-editing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Fcrispr-screen-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-crispr-screens-crispresso-editing\u002FSKILL.md",true,[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"examples\u002Fcrispresso_analysis.sh","SCRIPT","脚本",1490,"https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Fcrispr-screen-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-crispr-screens-crispresso-editing\u002Fexamples\u002Fcrispresso_analysis.sh",{"path":54,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":58},"usage-guide.md","REFERENCE","参考文档",9390,"https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Fcrispr-screen-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-crispr-screens-crispresso-editing\u002Fusage-guide.md",[60,67,74,81,88,95],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7CW36A6QAGWFE2C008M1XPG","bio-workflows-metabolomics-pipeline","Orchestrates the untargeted LC-MS metabolomics pipeline end-to-end (xcms 4.x feature extraction, QC\u002Fdrift\u002Fnormalization, confidence-stratified annotation, permutation-validated statistics, background-aware pathway mapping), naming what each stage decides and where it silently fails. Use when running a full LC-MS metabolomics study from raw mzML to enriched pathways and needing the honest handoffs between stages. Each stage defers to its component skill for parameters and traps; for stable-isotope flux (a separate branch, not this untargeted flow) see metabolomics\u002Fisotope-tracing.","https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Funtargeted-metabolomics-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-workflows-metabolomics-pipeline\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7CW2Y18623NA2S1Y30FRQW1","bio-metabolomics-xcms-preprocessing","Programmatic untargeted LC-MS feature extraction in R with the modern xcms 4.x MsExperiment\u002FXcmsExperiment API, taking raw mzML to a feature table via CentWave peak detection, retention-time alignment, peak-density correspondence, gap-filling, CAMERA redundancy collapse, and built-in QC feature filtering. Use when converting centroided LC-MS runs into a features-by-samples matrix and deciding centWave\u002Fgrouping\u002Falignment parameters. For drift correction and QC\u002FCV filtering execution see metabolomics\u002Fnormalization-qc; for metabolite identification see metabolomics\u002Fmetabolite-annotation; for the MS-DIAL GUI alternative with MS2Dec deconvolution see metabolomics\u002Fmsdial-preprocessing; for downstream statistics see metabolomics\u002Fstatistical-analysis.","https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Funtargeted-metabolomics-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-metabolomics-xcms-preprocessing\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7CW2M364HVWPNQEKE2WP4PP","bio-metabolomics-statistical-analysis","Decision-grade statistical analysis for metabolomics intensity tables. Covers transformation and scaling (Pareto vs unit-variance as a hidden hypothesis), unsupervised structure (PCA\u002FHCA for QC), permutation-validated PLS-DA\u002FOPLS-DA (R2 vs Q2, double CV, VIP as heuristic), univariate testing (Welch\u002FMann-Whitney\u002FANOVA\u002FLMM with covariate adjustment), and dependence-aware multiple testing. Use when testing which metabolites differ, building or validating a discriminant model, choosing a scaling, or correcting many correlated tests. For sample-wise normalization\u002Fdrift correction see metabolomics\u002Fnormalization-qc; for ML classifiers and selection-inside-CV leakage see machine-learning\u002Fbiomarker-discovery and machine-learning\u002Fmodel-validation; for pathway interpretation see metabolomics\u002Fpathway-mapping; for design\u002Fpower\u002Fmultiplicity regime see experimental-design\u002Fmultiple-testing.","https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Funtargeted-metabolomics-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-metabolomics-statistical-analysis\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7CW2BCBF851WYE03Z8XPEDQ","bio-metabolomics-pathway-mapping","Maps metabolomics results to biological pathways via over-representation (ORA), metabolite-set enrichment (MSEA\u002FQEA), mummichog\u002FPSEA on raw m\u002Fz peaks, and network-diffusion enrichment (FELLA), with correct background-set construction and honest interpretive ceilings. Use when interpreting differential metabolites or an untargeted LC-MS feature table in pathway context, choosing ORA vs MSEA vs mummichog vs topology, or setting the reference\u002Fbackground set. For annotation confidence levels feeding ORA see metabolomics\u002Fmetabolite-annotation; for gene-set concepts see pathway-analysis\u002Fgo-enrichment and pathway-analysis\u002Fgsea; for joint gene+metabolite pathways see multi-omics-integration\u002Fmofa-integration.","https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Funtargeted-metabolomics-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-metabolomics-pathway-mapping\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7CW21NSZMCPMF7D9CHJM718","bio-metabolomics-normalization-qc","Designs QC, corrects signal drift, removes batch effects, filters features, normalizes samples, and imputes missing values for untargeted LC-MS\u002FGC-MS metabolomics, framing each step as a measurement model that can create or erase biological signal. Use when processing a peak\u002Ffeature table before statistical analysis, choosing a drift-correction or sample-normalization method, deciding QC RSD vs D-ratio filtering, or handling left-censored missing values. The feature table is produced by metabolomics\u002Fxcms-preprocessing or metabolomics\u002Fmsdial-preprocessing; transformation\u002Fscaling for modeling defers to metabolomics\u002Fstatistical-analysis; cross-study design issues link to experimental-design\u002Fbatch-design.","https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Funtargeted-metabolomics-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-metabolomics-normalization-qc\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7CW1SWVM0NYHVE6Q7MA3G7R","bio-metabolomics-msdial-preprocessing","Runs the MS-DIAL preprocessing workflow (peak picking, MS2Dec spectral deconvolution, alignment, gap-filling) and imports the alignment-result table into R or Python with honest filtering. Use when preprocessing LC-MS DDA\u002FDIA (SWATH) or GC-MS raw data with MS-DIAL, deciding MS-DIAL vs XCMS, configuring the MSDIALCUI console run, or parsing an MS-DIAL export into a clean feature matrix. For programmatic R peak detection and the feature-table-as-artifact framing see metabolomics\u002Fxcms-preprocessing; for lipid annotation mode see metabolomics\u002Flipidomics; for MSI-level confidence honesty see metabolomics\u002Fmetabolite-annotation; for drift correction and QC see metabolomics\u002Fnormalization-qc.","https:\u002F\u002Fgithub.com\u002Fmrsonord2240\u002Fopenscience-specialists\u002Fblob\u002Fmain\u002Fspecialists\u002Funtargeted-metabolomics-analyst\u002Fversions\u002F1.0.0\u002Fpackage\u002Fskills\u002Fbio-metabolomics-msdial-preprocessing\u002FSKILL.md",[],[]]