[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ESZD7RWVT98RZ1KBNS0YV1":3,"skill-same:01M7ESZD7RWVT98RZ1KBNS0YV1":62},{"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":30,"commitSha":31,"skillDirectory":32,"forksCount":14,"repositoryHtmlUrl":33,"repositoryHomepageUrl":33,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":35,"install":36,"resources":49},"01M7ESZD7RWVT98RZ1KBNS0YV1","bio-crispr-screens-library-design",null,"Designs pooled sgRNA libraries for CRISPR knockout, interference (CRISPRi), activation (CRISPRa), Cas12a multiplex, base-editor, and prime-editor screens. Covers on-target scoring (Rule Set 2, Azimuth, DeepSpCas9, CRISPRon), off-target scoring (CFD, MIT), TSS-relative positioning for CRISPRi\u002Fa (Horlbeck, Dolcetto, Calabrese), PAM-variant chemistries, control-guide composition, oligo cloning architecture, and library QC. Use when choosing a genome-wide library (GeCKOv2 vs Avana vs Brunello vs TKOv3 vs Inzolia), designing a focused or paralog-focused custom library, picking CRISPRi vs CRISPRa TSS windows, deciding control-guide proportions, or diagnosing library skew and dropout in a freshly cloned pool.","Mr-Nobody-Anonymous\u002FAll-skills","Mr-Nobody-Anonymous","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F184253119?v=4","01M7AEXFJHKTYQW5R0ZCQQTWFV","anonymous","01M7C00M3GQR4QKP9GZA42GFAK",0,"MIT","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdesign\u002Fbio-crispr-screens-library-design\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: bio-crispr-screens-library-design\ndescription: Designs pooled sgRNA libraries for CRISPR knockout, interference (CRISPRi), activation (CRISPRa), Cas12a multiplex, base-editor, and prime-editor screens. Covers on-target scoring (Rule Set 2, Azimuth, DeepSpCas9, CRISPRon), off-target scoring (CFD, MIT), TSS-relative positioning for CRISPRi\u002Fa (Horlbeck, Dolcetto, Calabrese), PAM-variant chemistries, control-guide composition, oligo cloning architecture, and library QC. Use when choosing a genome-wide library (GeCKOv2 vs Avana vs Brunello vs TKOv3 vs Inzolia), designing a focused or paralog-focused custom library, picking CRISPRi vs CRISPRa TSS windows, deciding control-guide proportions, or diagnosing library skew and dropout in a freshly cloned pool.\ntool_type: mixed\nprimary_tool: CRISPOR\nsource: \"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills\"\nsource_repository: \"GPTomics\u002FbioSkills\"\nsource_path: \"crispr-screens\u002Flibrary-design\u002FSKILL.md\"\nlicense: \"MIT\"\nimported_at: \"2026-09-20\"\n---\n\n## Version Compatibility\n\nReference examples tested with: CRISPOR 5.01+, BioPython 1.83+, pandas 2.2+, numpy 1.26+, Azimuth 2.0+ (Doench 2016), CRISPRon 1.0+ (Xiang 2021), DeepSpCas9 1.0+ (Kim 2019).\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- CLI: `crispor.py --help` from the crisporWebsite clone\n- Python: Azimuth has no console script; call `azimuth.model_comparison.predict(...)`\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## sgRNA Library Design\n\n**\"Design a CRISPR library for my screen\"** -> Pick a chemistry (Cas9 KO, CRISPRi, CRISPRa, Cas12a, base or prime editor), score candidate guides for on-target activity and off-target liability, position them relative to gene\u002FTSS, add appropriate controls, lay out the oligo for synthesis, and validate the cloned pool.\n\n- Python: `crispor.py` (web + CLI) for batch genome-wide guide scoring with CFD+MIT off-target\n- Python: `azimuth` (Microsoft Research) for Rule Set 2 on-target predictions (Brunello-style)\n- Python: `CRISPRon`, `DeepSpCas9` for modern deep-learning predictors\n- R: `crisprDesign` (Bioconductor) for integrated annotation-aware design\n\n## Library Chemistry Decision Tree\n\n| Goal | Chemistry | Canonical library | Guides\u002Fgene | TSS \u002F target window |\n|------|-----------|-------------------|-------------|---------------------|\n| Loss-of-function essentiality, fitness | SpCas9 KO | Brunello, TKOv3, Avana | 4 (Brunello), 4 (TKOv3), 6 (Avana) | Constitutive exons, prefer aa 5-65% from N-terminus |\n| Knockdown of non-cuttable genes, dosage-sensitive | dCas9-KRAB (CRISPRi) | Dolcetto, Horlbeck v2 | 6 (Dolcetto), 5 (Horlbeck) | Optimum +25 to +75 downstream of FANTOM5 TSS, searched out to -50\u002F+300 (Dolcetto, Sanson 2018); -25 to +500 (Horlbeck v2) |\n| Gain-of-function, gene activation | dCas9-VP64 \u002F SAM \u002F SunTag (CRISPRa) | Calabrese, Horlbeck-CRISPRa | 6 (Calabrese), 5 (Horlbeck) | -150 to -75 from TSS (Calabrese); -550 to -25 (Horlbeck v2) |\n| Paralog buffering, GI screens | enAsCas12a multiplex | Inzolia, in4mer | 4-guide arrays | Constitutive exons |\n| Variant function, SNV scanning | CBE \u002F ABE | Custom tiling library | Tile editing windows | Editing window pos 4-8 from PAM-distal end |\n| Precise edit, indel-free | Prime editor | Custom PRIDICT-designed | Tile pegRNAs | Anywhere with NGG PAM within 30 nt of edit |\n\n**Fails when:**\n- CRISPRi\u002Fa targeting wrong TSS: any TSS without FANTOM5 CAGE evidence is suspect; guides positioned against the wrong TSS lose most of their knockdown.\n- Cas9 KO of essential paralogs: single-KO buffering hides paralog-redundant essentials (42% of constitutively expressed genes never score, Dede 2020); switch to Cas12a multiplex.\n- Base editor over an exon-intron boundary: editing-window bystanders create splice variants instead of the intended SNV.\n\n## On-Target Scoring: Algorithmic Taxonomy\n\n| Predictor | Year | Training set | Strengths | Fails when |\n|-----------|------|--------------|-----------|------------|\n| Doench Rule Set 1 | 2014 | Flow-sorted GFP+ knockouts | Simple, interpretable | Limited training data; sub-optimal at >NGG context |\n| Doench Rule Set 2 \u002F Azimuth 2.0 | 2016 | 1,841 flow-cytometry guides (Doench 2014) plus new guides tiling additional genes | Gold-standard for SpCas9; basis of Brunello | Trained on dropouts; under-predicts efficacy for nuclear-localized targets |\n| DeepSpCas9 | 2019 | 12,832 synthetic targets integrated in HEK293T | Spearman ~0.77 vs measured indel frequency on held-out data | Black-box; sensitive to chromatin\u002Fcontext features it wasn't trained on |\n| CRISPRon | 2021 | High-throughput indel sequencing | Best for therapeutic-grade target nomination | Slow per-guide; over-fits to its specific cell line |\n| DeepHF | 2019 | ~171k guides in HEK293T (WT 55,604; eSpCas9(1.1) 58,167; HF1 56,888) | Separate model per enzyme variant, including WT | Pick the model matching the enzyme actually used |\n\n**Reconciliation:** When predictors disagree, prefer the model whose training cell line matches the screen line (DeepSpCas9 was trained on synthetic targets integrated in HEK293T). For Brunello selection, Azimuth\u002FRule Set 2 is sufficient because the library was built with it -- introducing a different scorer creates apples-to-oranges ranking with the original library.\n\n## Off-Target Scoring\n\n| Score | Year | Math | Cutoff convention |\n|-------|------|------|--------------------|\n| MIT (Hsu) | 2013 | Position-weighted mismatch penalty | Specificity score 0-100, higher is better; CRISPOR treats >=50 as a good guide |\n| CFD (Doench) | 2016 | Position+nucleotide-specific penalty fit on Brunello | Per-site CFD >0.2 counts a candidate off-target (Doench 2016); CRISPOR's aggregate CFD specificity score is 0-100, higher is better |\n| Elevation | 2018 | ML on CFD + mismatch positions | Tighter than CFD |\n\nCFD remains the default for genome-wide library design. **Critical pitfall:** CFD penalizes only mismatches, not bulges; for ≤1 mismatch + 1-bp bulge off-targets, validate empirically with GUIDE-seq or CIRCLE-seq. CRISPOR reports both the MIT (Hsu) and CFD guide specificity scores in a single output.\n\n## Score and Rank sgRNAs for a Target Gene\n\n**Goal:** Generate ranked sgRNA candidates for a single gene, jointly scored on on-target activity (Rule Set 2 \u002F Azimuth) and off-target liability (CFD).\n\n**Approach:** Identify all PAM-adjacent 20-nt protospacers in the target gene's coding sequence, retain only those in the first 5-65% of the protein (constitutive-exon convention from Brunello), filter on GC 30-70% and absence of poly-T (≥4 Ts terminates U6), call Azimuth for on-target and CRISPOR for off-target, and select the top N satisfying both criteria.\n\n```python\nimport re\nimport pandas as pd\nimport numpy as np\nfrom Bio.Seq import Seq\n\ndef find_sgrna_candidates(cds_sequence, pam='NGG', guide_length=20):\n    '''Return all protospacer candidates with PAM coordinates on + strand.\n    Caller must filter by exon position and Azimuth\u002FCFD score.'''\n    pam_pattern = re.compile(f'(?=([ACGT]{{{guide_length}}}{pam.replace(\"N\", \"[ACGT]\")}))')\n    candidates = []\n    for strand, seq in [('+', cds_sequence), ('-', str(Seq(cds_sequence).reverse_complement()))]:\n        for m in pam_pattern.finditer(seq):\n            spacer = m.group(1)[:guide_length]\n            if 'TTTT' in spacer or spacer.count('G') + spacer.count('C') not in range(6, 15):\n                continue\n            candidates.append({'spacer': spacer, 'strand': strand,\n                               'pos_in_cds': m.start() if strand == '+' else len(seq) - m.start() - 23,\n                               'gc_frac': (spacer.count('G') + spacer.count('C')) \u002F guide_length})\n    return pd.DataFrame(candidates)\n\ndef annotate_exon_position(candidates_df, cds_length):\n    '''Filter to protospacers within first 5-65% of CDS (Brunello convention).\n    Reason: N-terminal indels truncate protein; very-N-terminal hits alt initiation;\n    C-terminal hits miss functional domains (Doench 2016 Nat Biotech).'''\n    lo, hi = 0.05 * cds_length, 0.65 * cds_length\n    return candidates_df[(candidates_df['pos_in_cds'] >= lo) & (candidates_df['pos_in_cds'] \u003C= hi)].copy()\n```\n\n## CRISPRi \u002F CRISPRa TSS Targeting\n\n**Goal:** Position guides relative to the empirical TSS for maximum knockdown (CRISPRi) or activation (CRISPRa).\n\n**Approach:** Resolve TSS from FANTOM5 CAGE peaks (highest-ranked peak per gene; fall back to Ensembl\u002FRefSeq if absent), define the modality-specific window, score candidate spacers in that window with Rule Set 2 plus the Horlbeck\u002FSanson CRISPRi\u002Fa-tailored rules, and select 5-6 guides per gene biased toward the window center.\n\n```python\ndef crispri_window(tss_coord, strand='+'):\n    '''Dolcetto convention: search -50 to +300 around the FANTOM5 highest-rank CAGE peak.\n    Reason: Sanson 2018 found +25 to +75 nt downstream of the TSS optimal for CRISPRi,\n    so rank candidates toward that band; the search is relaxed outward to fill the\n    per-gene guide quota when poorly-annotated TSSs leave too few candidates.'''\n    if strand == '+':\n        return (tss_coord - 50, tss_coord + 300)\n    return (tss_coord - 300, tss_coord + 50)\n\ndef crispra_window(tss_coord, strand='+'):\n    '''Calabrese convention: -150 to -75 upstream of TSS.\n    Reason: dCas9-VP64 (and SAM, SunTag) activate maximally when bound\n    just upstream of Pol II loading. Horlbeck v2 CRISPRa uses -550 to -25\n    (broader, lower per-guide signal). For SAM, prefer Calabrese tightness;\n    for SunTag, Horlbeck width is acceptable.'''\n    if strand == '+':\n        return (tss_coord - 150, tss_coord - 75)\n    return (tss_coord + 75, tss_coord + 150)\n```\n\n**Critical nuance:** Cell-type-specific TSSs differ from the FANTOM5 consensus in ~15% of genes. For tissue-specific screens (e.g., neuron, hepatocyte), re-derive TSSs from a matched CAGE \u002F GRO-seq \u002F PRO-seq dataset before locking guide positions, or knockdown efficiency drops several-fold. The single most common cause of \"weak\" CRISPRi hits is mis-positioned guides against an alternative TSS.\n\n## Genome-Wide Library Selection\n\n| Library | Year | Modality | Size (genes x guides) | sgRNA rules | Notable |\n|---------|------|----------|-----------------------|-------------|---------|\n| GeCKOv2 | 2014 | Cas9 KO | ~19k x 6 (~123k) | Exon position + off-target specificity (predates Rule Set 1) | Older; legacy datasets still use it |\n| Avana | 2016 | Cas9 KO | 110,257 as published; DepMap screens a ~4-guide subset (Meyers 2017: 70,086 after filtering, 17,670 genes) | Rule Set 1 | Still the Broad's primary Cas9 library; CERES->Chronos changed in 2021, not the library |\n| Brunello | 2016 | Cas9 KO | ~19k x 4 (~77k) | Rule Set 2 + CFD | Modern standard for new screens |\n| TKOv3 | 2017 | Cas9 KO | ~18k x 4 (~71k) | Hart on\u002Foff-target | Bagel\u002FBAGEL2-optimized |\n| Humagne | 2020 | enAsCas12a | ~19.8k x 1 dual-guide construct (~20k per set) | enAsCas12a rules | Compact Cas12a sets C and D |\n| Horlbeck CRISPRi v2 | 2016 | dCas9-KRAB | ~18k x 5 (~104k) | Horlbeck CRISPRi rules | First-gen, still widely used |\n| Dolcetto | 2018 | dCas9-KRAB | ~19k x 3 per set (114,061 across Sets A+B) | Horlbeck + Rule Set 2 | Modern CRISPRi standard |\n| Horlbeck CRISPRa | 2016 | dCas9-VP64 | ~18k x 5 (~104k) | Horlbeck CRISPRa rules | Original CRISPRa |\n| Calabrese | 2018 | dCas9-VP64 | ~18.9k x 3 per set (113,238 across Sets A+B) | Tight TSS window | Modern CRISPRa standard |\n| Inzolia | 2024 | enAsCas12a | ~49k arrays: 19,687 genes (2 arrays each) plus ~4,435 paralog pairs | enAsCas12a rules | Paralog-pair multiplex; ~30% smaller than a typical Cas9 library |\n| in4mer | 2024 | Cas12a (4-guide) | Custom | enAsCas12a multiplex | Triple\u002Fquadruple KO per cassette |\n\n**dAUC trajectory (essentiality benchmark):** GeCKOv2 \u003C Avana \u003C Brunello\u002FTKOv3 (Doench 2016 + Hart 2017). Moving from 4 to 6 sgRNAs\u002Fgene gives diminishing returns; the larger gain is moving from Rule Set 1 to Rule Set 2.\n\n**Cost-coverage tradeoff:** A 77k-guide Brunello at 500x cells\u002FsgRNA needs 38.5M cells in pool, scalable. A 117k-guide Calabrese at 500x needs 59M cells -- often the deciding factor against CRISPRa for difficult-to-grow lines.\n\n## PAM Variants and Alternative Cas Enzymes\n\n| Enzyme | PAM | Spacer length | Best for |\n|--------|-----|---------------|----------|\n| SpCas9 (WT) | NGG | 20 nt | Standard pooled screens; broadest library support |\n| eSpCas9, SpCas9-HF1 | NGG | 20 nt | Lower off-target rate; use for therapeutic-grade nomination |\n| SpCas9-NG | NG | 20 nt | Expanded targeting (~4x coverage); accept lower activity per guide |\n| SpRY | NRN \u002F NYN | 20 nt | Near-PAMless; coverage at every position; ~50% lower per-guide activity |\n| SaCas9 | NNGRRT | 21 nt | AAV-packageable (small ORF); rarely used in pooled screens |\n| AsCas12a, LbCas12a | TTTV | 23 nt | AT-rich regions; staggered cut; lower expression noise |\n| enAsCas12a (DeWeirdt 2021) | Expanded TTTV + several non-canonical | 23 nt | Combinatorial \u002F paralog screens |\n\n**Decision rule:** If the screen requires every possible TSS position (saturation tiling, dense regulatory dissection), use SpRY despite lower activity; otherwise, NGG is best because the on-target predictors were trained on it.\n\n## Control Guides\n\nA genome-wide library should include:\n\n| Control type | Count | Purpose |\n|--------------|-------|---------|\n| Non-targeting (scrambled, no genomic match) | 500-1,000 (~1% of library) | Primary null distribution for CRISPRi\u002Fa; safe baseline for normalization |\n| Safe-harbor (AAVS1, ROSA26-equivalent) | 50-100 | Cas9-only: absorbs cut-toxicity baseline (matters for amplicon-correction) |\n| Olfactory receptors (presumed non-expressed) | 50-100 | Second null set for orthogonal normalization |\n| Reference essentials (CEGv2 subset: e.g. RPS3, RPL11, EIF3A, POLR2A) | 50-100 | Internal positive control; QC dropout signal |\n| Reference non-essentials (NEGv1 subset) | 50-100 | Internal negative control; BAGEL2 calibration |\n\n**Critical pitfall:** Using only AAVS1 as the negative control in a Cas9 screen creates a normalization baseline biased toward \"any cut is bad.\" Always add NTCs or non-essentials so that downstream median normalization and PR-AUC against CEGv2 work without baseline-shift artifacts.\n\n## Library Composition for Specialized Screens\n\n**Paralog buffering (Cas12a multiplex):** Build 4-guide arrays where positions 1-2 target gene A and positions 3-4 target paralog gene B. Inzolia covers ~4,435 paralog pairs within ~49k arrays. Singleton controls (gene A alone, gene B alone) must be included to score genetic interaction = double_KO_LFC - sum(single_KO_LFC).\n\n**Base editor screens (tiling-library design):** Tile NGG-adjacent spacers across exons; ensure editing window (positions 4-8 from PAM-distal end) lands inside coding exons; flag bystander Cs\u002FAs in the window for downstream interpretation. Restrict to 50-90% editing efficiency a priori (filter out predicted low-efficacy guides) -- see [[base-editing-analysis]].\n\n**Tiling \u002F regulatory dissection:** Dense (every 5-10 bp) CRISPRi or CRISPRa guides across the candidate region; CRISPRi has broader signal width (good for enhancer discovery) but Cas9-indel tiling has sharper resolution (good for pinpointing critical bases). Pair with CRISPR-SURF deconvolution.\n\n## Oligo Design for Pooled Synthesis\n\n**Goal:** Generate the final oligo sequence ready for chip-based synthesis. Vendor limits differ: Twist oligo pools cap at ~300 nt per oligo with no fixed pool size, GenScript's 92K format spans 20-170 nt, and Agilent OLS 244K spans 30-230 nt.\n\n**Approach:** Add subpool PCR primers (so multiple sublibraries can share a synthesis array), the BsmBI\u002FEsp3I overhang for golden-gate cloning into LentiGuide-Puro (Addgene 52963) or LentiCRISPRv2, and append the tracrRNA scaffold if the array length permits.\n\n```python\ndef build_oligo(spacer, vector='lentiGuide-Puro', subpool_idx=None):\n    '''Construct final oligo for pooled synthesis.\n\n    LentiGuide-Puro \u002F LentiCRISPRv2 use BsmBI (Esp3I) with these overhangs:\n        forward: 5'-CACCG[spacer]-3'\n        reverse: 5'-AAAC[revcomp(spacer)]C-3'\n    For chip synthesis, the spacer is flanked by subpool-specific PCR primers.'''\n    subpool_fwd = {\n        1: 'GGAAAGGACGAAACACCG',   # subpool 1 forward primer + BsmBI overhang\n        2: 'GAGGCACTGGGCAGGTACCG',\n    }.get(subpool_idx, 'GGAAAGGACGAAACACCG')\n    # First 33 nt of the Chen 2013 sgRNA(F+E) optimized scaffold. NOTE: lentiGuide-Puro (#52963)\n    # and lentiCRISPRv2 (#52961) carry the ORIGINAL scaffold; F+E belongs to lentiCRISPRv2-Opti (#163126).\n    scaffold_short = 'GTTTAAGAGCTATGCTGGAAACAGCATAGCAAG'\n    oligo = subpool_fwd + spacer + scaffold_short\n    if len(oligo) > 200:\n        raise ValueError(f'Oligo length {len(oligo)} exceeds the 200 nt design budget; check the vendor limit')\n    return oligo\n```\n\n**Subpool design:** A large synthesis pool can be partitioned into multiple sublibraries via subpool primers; each sub-PCR amplifies its subpool, allowing one synthesis batch to serve several screens. Typical subpool size: 10k-20k oligos.\n\n## Library QC After Cloning\n\n| Metric | Target | Failure mode if missed |\n|--------|--------|------------------------|\n| sgRNA detection (>25 reads\u002Fguide in plasmid pool) | ≥99% | Founder effect: missing guides cannot be screened; dropout impossible to distinguish from missing |\n| Gini coefficient of plasmid pool | \u003C0.1 | Synthesis defects or PCR bias; pool unfit for screening at standard 500x coverage |\n| Skew ratio (top 10% \u002F bottom 10%) | \u003C2 (good), \u003C5 (acceptable) | Skew >5 means underrepresented guides cannot generate statistical signal even at 1000x |\n| % zero-count sgRNAs in plasmid pool | \u003C0.5% | Plasmid bottleneck during cloning; re-amplify or re-clone |\n| Replicate Pearson on plasmid pool (between sequencing technical replicates) | >0.99 | Sequencing artifact, not biology |\n\n**Plasmid pool sequencing convention:** 200-500 reads per sgRNA before any biology (i.e. 15-40M reads for a 77k Brunello). This is the baseline against which all downstream depletion is computed; sequencing the plasmid is non-negotiable.\n\n## Failure Modes\n\n### Wrong TSS in CRISPRi\u002Fa library\n\n**Trigger:** Using Ensembl\u002FRefSeq TSS instead of empirical CAGE peak for genes with broad or non-canonical promoters.\n**Mechanism:** dCas9-KRAB knockdown is maximal within ±100 bp of the actual Pol II loading site; canonical annotation can be off by 1-10 kb.\n**Symptom:** \"Easy\" essentials (RPS, RPL, EIF) show normal dropout but newer genes don't; library validates poorly against CEGv2.\n**Fix:** Re-derive TSS from FANTOM5 CAGE highest-rank peak; for tissue-specific lines, use matched CAGE or GRO-seq.\n\n### Library skew from PCR bias during amplification\n\n**Trigger:** Amplifying the cloned plasmid pool with too many PCR cycles (>20) or with high-GC-bias polymerase.\n**Mechanism:** GC-extreme guides amplify nonlinearly; high-GC guides dominate, low-GC guides drop out.\n**Symptom:** Gini >0.2 on plasmid pool; sgRNAs with GC \u003C30% systematically depleted.\n**Fix:** Cap PCR at 15 cycles; use Q5 or NEBNext Ultra II (low-bias); sequence at 500x post-amp to confirm Gini.\n\n### Oligo-synthesis dropouts in low-complexity guides\n\n**Trigger:** Chip-synthesis errors at homopolymer runs or guides starting with GGGG.\n**Mechanism:** Synthesis chemistry has higher error rate at low-complexity regions; missing oligos cannot be cloned.\n**Symptom:** Specific guides absent from plasmid pool despite no design-rule violation.\n**Fix:** Re-design replacement guides; for production runs, request 2-3x synthesis depth so dropouts are buffered.\n\n### Polyclonality from high MOI\n\n**Trigger:** Infection at MOI >0.5 to \"save cells.\"\n**Mechanism:** Poisson math: at MOI 0.3, 26% of all cells are infected and 4% carry >=2 sgRNAs (14% of the infected fraction); at MOI 0.5, 39% are infected and 9% carry >=2.\n**Symptom:** Hits include neutral genes that co-infect with true essentials.\n**Fix:** MOI 0.3 strict; titer Cas9-positive cells specifically; re-check by qPCR of integration.\n\n### Wrong control proportion\n\n**Trigger:** \u003C100 non-targeting controls in a 70k library.\n**Mechanism:** Null distribution for normalization and FDR rests on the NTC variance; too few NTCs yields unstable median and inflated FDR.\n**Symptom:** Erratic gene-level p-values; MAGeCK FDR fluctuates wildly between runs.\n**Fix:** ~1% of library (500-1,000) NTCs; supplement with non-essential-gene controls.\n\n## Quantitative Thresholds\n\n| Threshold | Value | Source \u002F Rationale |\n|-----------|-------|--------------------|\n| GC content | 30-70% | Doench 2016 Nat Biotech: guides outside this range have low activity |\n| Poly-T avoidance | ≤3 consecutive T | U6 Pol III terminator; ≥4 Ts terminates sgRNA transcription |\n| Guides per gene (Cas9) | 4 (Brunello\u002FTKOv3 standard); up to 6 (Avana, older) | Doench 2016 reports diminishing gene recovery below 4 sgRNAs\u002Fgene; returns flatten above 6 |\n| CRISPRi window | -50 to +300 search; +25 to +75 optimum | Sanson 2018 (Dolcetto); Horlbeck v2 uses -25 to +500 |\n| CRISPRa window | -150 to -75 from TSS | Sanson 2018 (Calabrese); narrower than Horlbeck v2 (-550 to -25) |\n| NTCs in library | ~1% (500-1,000 in a 70k library) | DepMap library design notes; rule-of-thumb for stable null |\n| MOI | 0.3 | Poisson: P(>=2 sgRNAs\u002Fcell) = 4% at MOI 0.3 |\n| Coverage at infection | 500 cells\u002FsgRNA | DepMap convention; 200x minimum, 1000x for noisy \u002F in-vivo |\n| CRISPOR MIT specificity score | >=50 (higher = more specific) | CRISPOR convention (Haeussler 2016) |\n| Library skew (top 10% \u002F bottom 10%) | \u003C2 ideal, \u003C5 acceptable | Joung 2017 Nat Protoc |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| sgRNA fails to express | Poly-T in spacer terminates U6 | Filter `TTTT` in design; this is the #1 silent failure |\n| CRISPRi guide gives no knockdown | Wrong TSS used | Re-derive TSS from FANTOM5 \u002F matched CAGE |\n| Library Gini >0.3 in plasmid pool | PCR over-amplification or synthesis defect | Cap at 15 cycles; re-sequence plasmid; consider re-synthesis |\n| Hits include amplified loci (e.g. ERBB2 in HER2+) | Copy-number amplicon false-essentiality | See [[copy-number-correction]] |\n| Paralog gene absent from hit list despite expression | Cas9 single-KO buffering | Switch to Cas12a multiplex; see [[combinatorial-screens]] |\n| Cas12a oligo doesn't cut | Forgot Cas12a's TTTV PAM is 5' of spacer, not 3' | Re-orient: PAM-then-spacer for Cas12a, opposite of Cas9 |\n\n## References\n\n- Doench JG et al. 2014. *Nat Biotechnol* 32:1262. Rule Set 1.\n- Doench JG et al. 2016. *Nat Biotechnol* 34:184. Rule Set 2, CFD, Brunello\u002FAvana libraries.\n- Sanjana NE et al. 2014. *Nat Methods* 11:783. GeCKOv2.\n- Hart T et al. 2017. *G3* 7:2719. TKOv3 library; CEGv2\u002FNEGv1 reference essentiality gene sets.\n- Sanson KR et al. 2018. *Nat Commun* 9:5416. Dolcetto + Calabrese libraries; CRISPRi\u002Fa TSS rules.\n- Horlbeck MA et al. 2016. *eLife* 5:e19760. CRISPRi\u002Fa design rules; Horlbeck v2 library.\n- Kim HK et al. 2019. *Sci Adv* 5:eaax9249. DeepSpCas9.\n- Xiang X et al. 2021. *Nat Commun* 12:3238. CRISPRon.\n- Tycko J et al. 2019. *Nat Commun* 10:4063. Off-target toxicity mitigation in CRISPR screens.\n- DeWeirdt PC et al. 2021. *Nat Biotechnol* 39:94. enAsCas12a optimization.\n- Esmaeili Anvar N et al. 2024. *Nat Commun* 15:3577. Inzolia \u002F in4mer paralog library.\n- Dede M et al. 2020. *Genome Biol* 21:262. Paralog buffering invisible to Cas9 single-KO.\n- Joung J et al. 2017. *Nat Protoc* 12:828. Genome-wide library screen protocol.\n- Shalem O et al. 2014. *Science* 343:84. Original GeCKO genome-scale knockout library design.\n\n## Related Skills\n\n- crispr-screens\u002Fscreen-qc - Validate library skew, Gini, replicate correlation\n- crispr-screens\u002Fmageck-analysis - Analyze screens run with the designed library\n- crispr-screens\u002Fcombinatorial-screens - Cas12a multiplex \u002F paralog-pair library design\n- crispr-screens\u002Fbase-editing-analysis - base-editor library design\n- crispr-screens\u002Fprime-editing-screens - PRIDICT2-optimized pegRNA libraries\n- crispr-screens\u002Fcopy-number-correction - Filter amplicon-driven artifacts in cancer-cell-line screens\n","## Version Compatibility\n\nReference examples tested with: CRISPOR 5.01+, BioPython 1.83+, pandas 2.2+, numpy 1.26+, Azimuth 2.0+ (Doench 2016), CRISPRon 1.0+ (Xiang 2021), DeepSpCas9 1.0+ (Kim 2019).\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- CLI: `crispor.py --help` from the crisporWebsite clone\n- Python: Azimuth has no console script; call `azimuth.model_comparison.predict(...)`\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## sgRNA Library Design\n\n**\"Design a CRISPR library for my screen\"** -> Pick a chemistry (Cas9 KO, CRISPRi, CRISPRa, Cas12a, base or prime editor), score candidate guides for on-target activity and off-target liability, position them relative to gene\u002FTSS, add appropriate controls, lay out the oligo for synthesis, and validate the cloned pool.\n\n- Python: `crispor.py` (web + CLI) for batch genome-wide guide scoring with CFD+MIT off-target\n- Python: `azimuth` (Microsoft Research) for Rule Set 2 on-target predictions (Brunello-style)\n- Python: `CRISPRon`, `DeepSpCas9` for modern deep-learning predictors\n- R: `crisprDesign` (Bioconductor) for integrated annotation-aware design\n\n## Library Chemistry Decision Tree\n\n| Goal | Chemistry | Canonical library | Guides\u002Fgene | TSS \u002F target window |\n|------|-----------|-------------------|-------------|---------------------|\n| Loss-of-function essentiality, fitness | SpCas9 KO | Brunello, TKOv3, Avana | 4 (Brunello), 4 (TKOv3), 6 (Avana) | Constitutive exons, prefer aa 5-65% from N-terminus |\n| Knockdown of non-cuttable genes, dosage-sensitive | dCas9-KRAB (CRISPRi) | Dolcetto, Horlbeck v2 | 6 (Dolcetto), 5 (Horlbeck) | Optimum +25 to +75 downstream of FANTOM5 TSS, searched out to -50\u002F+300 (Dolcetto, Sanson 2018); -25 to +500 (Horlbeck v2) |\n| Gain-of-function, gene activation | dCas9-VP64 \u002F SAM \u002F SunTag (CRISPRa) | Calabrese, Horlbeck-CRISPRa | 6 (Calabrese), 5 (Horlbeck) | -150 to -75 from TSS (Calabrese); -550 to -25 (Horlbeck v2) |\n| Paralog buffering, GI screens | enAsCas12a multiplex | Inzolia, in4mer | 4-guide arrays | Constitutive exons |\n| Variant function, SNV scanning | CBE \u002F ABE | Custom tiling library | Tile editing windows | Editing window pos 4-8 from PAM-distal end |\n| Precise edit, indel-free | Prime editor | Custom PRIDICT-designed | Tile pegRNAs | Anywhere with NGG PAM within 30 nt of edit |\n\n**Fails when:**\n- CRISPRi\u002Fa targeting wrong TSS: any TSS without FANTOM5 CAGE evidence is suspect; guides positioned against the wrong TSS lose most of their knockdown.\n- Cas9 KO of essential paralogs: single-KO buffering hides paralog-redundant essentials (42% of constitutively expressed genes never score, Dede 2020); switch to Cas12a multiplex.\n- Base editor over an exon-intron boundary: editing-window bystanders create splice variants instead of the intended SNV.\n\n## On-Target Scoring: Algorithmic Taxonomy\n\n| Predictor | Year | Training set | Strengths | Fails when |\n|-----------|------|--------------|-----------|------------|\n| Doench Rule Set 1 | 2014 | Flow-sorted GFP+ knockouts | Simple, interpretable | Limited training data; sub-optimal at >NGG context |\n| Doench Rule Set 2 \u002F Azimuth 2.0 | 2016 | 1,841 flow-cytometry guides (Doench 2014) plus new guides tiling additional genes | Gold-standard for SpCas9; basis of Brunello | Trained on dropouts; under-predicts efficacy for nuclear-localized targets |\n| DeepSpCas9 | 2019 | 12,832 synthetic targets integrated in HEK293T | Spearman ~0.77 vs measured indel frequency on held-out data | Black-box; sensitive to chromatin\u002Fcontext features it wasn't trained on |\n| CRISPRon | 2021 | High-throughput indel sequencing | Best for therapeutic-grade target nomination | Slow per-guide; over-fits to its specific cell line |\n| DeepHF | 2019 | ~171k guides in HEK293T (WT 55,604; eSpCas9(1.1) 58,167; HF1 56,888) | Separate model per enzyme variant, including WT | Pick the model matching the enzyme actually used |\n\n**Reconciliation:** When predictors disagree, prefer the model whose training cell line matches the screen line (DeepSpCas9 was trained on synthetic targets integrated in HEK293T). For Brunello selection, Azimuth\u002FRule Set 2 is sufficient because the library was built with it -- introducing a different scorer creates apples-to-oranges ranking with the original library.\n\n## Off-Target Scoring\n\n| Score | Year | Math | Cutoff convention |\n|-------|------|------|--------------------|\n| MIT (Hsu) | 2013 | Position-weighted mismatch penalty | Specificity score 0-100, higher is better; CRISPOR treats >=50 as a good guide |\n| CFD (Doench) | 2016 | Position+nucleotide-specific penalty fit on Brunello | Per-site CFD >0.2 counts a candidate off-target (Doench 2016); CRISPOR's aggregate CFD specificity score is 0-100, higher is better |\n| Elevation | 2018 | ML on CFD + mismatch positions | Tighter than CFD |\n\nCFD remains the default for genome-wide library design. **Critical pitfall:** CFD penalizes only mismatches, not bulges; for ≤1 mismatch + 1-bp bulge off-targets, validate empirically with GUIDE-seq or CIRCLE-seq. CRISPOR reports both the MIT (Hsu) and CFD guide specificity scores in a single output.\n\n## Score and Rank sgRNAs for a Target Gene\n\n**Goal:** Generate ranked sgRNA candidates for a single gene, jointly scored on on-target activity (Rule Set 2 \u002F Azimuth) and off-target liability (CFD).\n\n**Approach:** Identify all PAM-adjacent 20-nt protospacers in the target gene's coding sequence, retain only those in the first 5-65% of the protein (constitutive-exon convention from Brunello), filter on GC 30-70% and absence of poly-T (≥4 Ts terminates U6), call Azimuth for on-target and CRISPOR for off-target, and select the top N satisfying both criteria.\n\n```python\nimport re\nimport pandas as pd\nimport numpy as np\nfrom Bio.Seq import Seq\n\ndef find_sgrna_candidates(cds_sequence, pam='NGG', guide_length=20):\n    '''Return all protospacer candidates with PAM coordinates on + strand.\n    Caller must filter by exon position and Azimuth\u002FCFD score.'''\n    pam_pattern = re.compile(f'(?=([ACGT]{{{guide_length}}}{pam.replace(\"N\", \"[ACGT]\")}))')\n    candidates = []\n    for strand, seq in [('+', cds_sequence), ('-', str(Seq(cds_sequence).reverse_complement()))]:\n        for m in pam_pattern.finditer(seq):\n            spacer = m.group(1)[:guide_length]\n            if 'TTTT' in spacer or spacer.count('G') + spacer.count('C') not in range(6, 15):\n                continue\n            candidates.append({'spacer': spacer, 'strand': strand,\n                               'pos_in_cds': m.start() if strand == '+' else len(seq) - m.start() - 23,\n                               'gc_frac': (spacer.count('G') + spacer.count('C')) \u002F guide_length})\n    return pd.DataFrame(candidates)\n\ndef annotate_exon_position(candidates_df, cds_length):\n    '''Filter to protospacers within first 5-65% of CDS (Brunello convention).\n    Reason: N-terminal indels truncate protein; very-N-terminal hits alt initiation;\n    C-terminal hits miss functional domains (Doench 2016 Nat Biotech).'''\n    lo, hi = 0.05 * cds_length, 0.65 * cds_length\n    return candidates_df[(candidates_df['pos_in_cds'] >= lo) & (candidates_df['pos_in_cds'] \u003C= hi)].copy()\n```\n\n## CRISPRi \u002F CRISPRa TSS Targeting\n\n**Goal:** Position guides relative to the empirical TSS for maximum knockdown (CRISPRi) or activation (CRISPRa).\n\n**Approach:** Resolve TSS from FANTOM5 CAGE peaks (highest-ranked peak per gene; fall back to Ensembl\u002FRefSeq if absent), define the modality-specific window, score candidate spacers in that window with Rule Set 2 plus the Horlbeck\u002FSanson CRISPRi\u002Fa-tailored rules, and select 5-6 guides per gene biased toward the window center.\n\n```python\ndef crispri_window(tss_coord, strand='+'):\n    '''Dolcetto convention: search -50 to +300 around the FANTOM5 highest-rank CAGE peak.\n    Reason: Sanson 2018 found +25 to +75 nt downstream of the TSS optimal for CRISPRi,\n    so rank candidates toward that band; the search is relaxed outward to fill the\n    per-gene guide quota when poorly-annotated TSSs leave too few candidates.'''\n    if strand == '+':\n        return (tss_coord - 50, tss_coord + 300)\n    return (tss_coord - 300, tss_coord + 50)\n\ndef crispra_window(tss_coord, strand='+'):\n    '''Calabrese convention: -150 to -75 upstream of TSS.\n    Reason: dCas9-VP64 (and SAM, SunTag) activate maximally when bound\n    just upstream of Pol II loading. Horlbeck v2 CRISPRa uses -550 to -25\n    (broader, lower per-guide signal). For SAM, prefer Calabrese tightness;\n    for SunTag, Horlbeck width is acceptable.'''\n    if strand == '+':\n        return (tss_coord - 150, tss_coord - 75)\n    return (tss_coord + 75, tss_coord + 150)\n```\n\n**Critical nuance:** Cell-type-specific TSSs differ from the FANTOM5 consensus in ~15% of genes. For tissue-specific screens (e.g., neuron, hepatocyte), re-derive TSSs from a matched CAGE \u002F GRO-seq \u002F PRO-seq dataset before locking guide positions, or knockdown efficiency drops several-fold. The single most common cause of \"weak\" CRISPRi hits is mis-positioned guides against an alternative TSS.\n\n## Genome-Wide Library Selection\n\n| Library | Year | Modality | Size (genes x guides) | sgRNA rules | Notable |\n|---------|------|----------|-----------------------|-------------|---------|\n| GeCKOv2 | 2014 | Cas9 KO | ~19k x 6 (~123k) | Exon position + off-target specificity (predates Rule Set 1) | Older; legacy datasets still use it |\n| Avana | 2016 | Cas9 KO | 110,257 as published; DepMap screens a ~4-guide subset (Meyers 2017: 70,086 after filtering, 17,670 genes) | Rule Set 1 | Still the Broad's primary Cas9 library; CERES->Chronos changed in 2021, not the library |\n| Brunello | 2016 | Cas9 KO | ~19k x 4 (~77k) | Rule Set 2 + CFD | Modern standard for new screens |\n| TKOv3 | 2017 | Cas9 KO | ~18k x 4 (~71k) | Hart on\u002Foff-target | Bagel\u002FBAGEL2-optimized |\n| Humagne | 2020 | enAsCas12a | ~19.8k x 1 dual-guide construct (~20k per set) | enAsCas12a rules | Compact Cas12a sets C and D |\n| Horlbeck CRISPRi v2 | 2016 | dCas9-KRAB | ~18k x 5 (~104k) | Horlbeck CRISPRi rules | First-gen, still widely used |\n| Dolcetto | 2018 | dCas9-KRAB | ~19k x 3 per set (114,061 across Sets A+B) | Horlbeck + Rule Set 2 | Modern CRISPRi standard |\n| Horlbeck CRISPRa | 2016 | dCas9-VP64 | ~18k x 5 (~104k) | Horlbeck CRISPRa rules | Original CRISPRa |\n| Calabrese | 2018 | dCas9-VP64 | ~18.9k x 3 per set (113,238 across Sets A+B) | Tight TSS window | Modern CRISPRa standard |\n| Inzolia | 2024 | enAsCas12a | ~49k arrays: 19,687 genes (2 arrays each) plus ~4,435 paralog pairs | enAsCas12a rules | Paralog-pair multiplex; ~30% smaller than a typical Cas9 library |\n| in4mer | 2024 | Cas12a (4-guide) | Custom | enAsCas12a multiplex | Triple\u002Fquadruple KO per cassette |\n\n**dAUC trajectory (essentiality benchmark):** GeCKOv2 \u003C Avana \u003C Brunello\u002FTKOv3 (Doench 2016 + Hart 2017). Moving from 4 to 6 sgRNAs\u002Fgene gives diminishing returns; the larger gain is moving from Rule Set 1 to Rule Set 2.\n\n**Cost-coverage tradeoff:** A 77k-guide Brunello at 500x cells\u002FsgRNA needs 38.5M cells in pool, scalable. A 117k-guide Calabrese at 500x needs 59M cells -- often the deciding factor against CRISPRa for difficult-to-grow lines.\n\n## PAM Variants and Alternative Cas Enzymes\n\n| Enzyme | PAM | Spacer length | Best for |\n|--------|-----|---------------|----------|\n| SpCas9 (WT) | NGG | 20 nt | Standard pooled screens; broadest library support |\n| eSpCas9, SpCas9-HF1 | NGG | 20 nt | Lower off-target rate; use for therapeutic-grade nomination |\n| SpCas9-NG | NG | 20 nt | Expanded targeting (~4x coverage); accept lower activity per guide |\n| SpRY | NRN \u002F NYN | 20 nt | Near-PAMless; coverage at every position; ~50% lower per-guide activity |\n| SaCas9 | NNGRRT | 21 nt | AAV-packageable (small ORF); rarely used in pooled screens |\n| AsCas12a, LbCas12a | TTTV | 23 nt | AT-rich regions; staggered cut; lower expression noise |\n| enAsCas12a (DeWeirdt 2021) | Expanded TTTV + several non-canonical | 23 nt | Combinatorial \u002F paralog screens |\n\n**Decision rule:** If the screen requires every possible TSS position (saturation tiling, dense regulatory dissection), use SpRY despite lower activity; otherwise, NGG is best because the on-target predictors were trained on it.\n\n## Control Guides\n\nA genome-wide library should include:\n\n| Control type | Count | Purpose |\n|--------------|-------|---------|\n| Non-targeting (scrambled, no genomic match) | 500-1,000 (~1% of library) | Primary null distribution for CRISPRi\u002Fa; safe baseline for normalization |\n| Safe-harbor (AAVS1, ROSA26-equivalent) | 50-100 | Cas9-only: absorbs cut-toxicity baseline (matters for amplicon-correction) |\n| Olfactory receptors (presumed non-expressed) | 50-100 | Second null set for orthogonal normalization |\n| Reference essentials (CEGv2 subset: e.g. RPS3, RPL11, EIF3A, POLR2A) | 50-100 | Internal positive control; QC dropout signal |\n| Reference non-essentials (NEGv1 subset) | 50-100 | Internal negative control; BAGEL2 calibration |\n\n**Critical pitfall:** Using only AAVS1 as the negative control in a Cas9 screen creates a normalization baseline biased toward \"any cut is bad.\" Always add NTCs or non-essentials so that downstream median normalization and PR-AUC against CEGv2 work without baseline-shift artifacts.\n\n## Library Composition for Specialized Screens\n\n**Paralog buffering (Cas12a multiplex):** Build 4-guide arrays where positions 1-2 target gene A and positions 3-4 target paralog gene B. Inzolia covers ~4,435 paralog pairs within ~49k arrays. Singleton controls (gene A alone, gene B alone) must be included to score genetic interaction = double_KO_LFC - sum(single_KO_LFC).\n\n**Base editor screens (tiling-library design):** Tile NGG-adjacent spacers across exons; ensure editing window (positions 4-8 from PAM-distal end) lands inside coding exons; flag bystander Cs\u002FAs in the window for downstream interpretation. Restrict to 50-90% editing efficiency a priori (filter out predicted low-efficacy guides) -- see [[base-editing-analysis]].\n\n**Tiling \u002F regulatory dissection:** Dense (every 5-10 bp) CRISPRi or CRISPRa guides across the candidate region; CRISPRi has broader signal width (good for enhancer discovery) but Cas9-indel tiling has sharper resolution (good for pinpointing critical bases). Pair with CRISPR-SURF deconvolution.\n\n## Oligo Design for Pooled Synthesis\n\n**Goal:** Generate the final oligo sequence ready for chip-based synthesis. Vendor limits differ: Twist oligo pools cap at ~300 nt per oligo with no fixed pool size, GenScript's 92K format spans 20-170 nt, and Agilent OLS 244K spans 30-230 nt.\n\n**Approach:** Add subpool PCR primers (so multiple sublibraries can share a synthesis array), the BsmBI\u002FEsp3I overhang for golden-gate cloning into LentiGuide-Puro (Addgene 52963) or LentiCRISPRv2, and append the tracrRNA scaffold if the array length permits.\n\n```python\ndef build_oligo(spacer, vector='lentiGuide-Puro', subpool_idx=None):\n    '''Construct final oligo for pooled synthesis.\n\n    LentiGuide-Puro \u002F LentiCRISPRv2 use BsmBI (Esp3I) with these overhangs:\n        forward: 5'-CACCG[spacer]-3'\n        reverse: 5'-AAAC[revcomp(spacer)]C-3'\n    For chip synthesis, the spacer is flanked by subpool-specific PCR primers.'''\n    subpool_fwd = {\n        1: 'GGAAAGGACGAAACACCG',   # subpool 1 forward primer + BsmBI overhang\n        2: 'GAGGCACTGGGCAGGTACCG',\n    }.get(subpool_idx, 'GGAAAGGACGAAACACCG')\n    # First 33 nt of the Chen 2013 sgRNA(F+E) optimized scaffold. NOTE: lentiGuide-Puro (#52963)\n    # and lentiCRISPRv2 (#52961) carry the ORIGINAL scaffold; F+E belongs to lentiCRISPRv2-Opti (#163126).\n    scaffold_short = 'GTTTAAGAGCTATGCTGGAAACAGCATAGCAAG'\n    oligo = subpool_fwd + spacer + scaffold_short\n    if len(oligo) > 200:\n        raise ValueError(f'Oligo length {len(oligo)} exceeds the 200 nt design budget; check the vendor limit')\n    return oligo\n```\n\n**Subpool design:** A large synthesis pool can be partitioned into multiple sublibraries via subpool primers; each sub-PCR amplifies its subpool, allowing one synthesis batch to serve several screens. Typical subpool size: 10k-20k oligos.\n\n## Library QC After Cloning\n\n| Metric | Target | Failure mode if missed |\n|--------|--------|------------------------|\n| sgRNA detection (>25 reads\u002Fguide in plasmid pool) | ≥99% | Founder effect: missing guides cannot be screened; dropout impossible to distinguish from missing |\n| Gini coefficient of plasmid pool | \u003C0.1 | Synthesis defects or PCR bias; pool unfit for screening at standard 500x coverage |\n| Skew ratio (top 10% \u002F bottom 10%) | \u003C2 (good), \u003C5 (acceptable) | Skew >5 means underrepresented guides cannot generate statistical signal even at 1000x |\n| % zero-count sgRNAs in plasmid pool | \u003C0.5% | Plasmid bottleneck during cloning; re-amplify or re-clone |\n| Replicate Pearson on plasmid pool (between sequencing technical replicates) | >0.99 | Sequencing artifact, not biology |\n\n**Plasmid pool sequencing convention:** 200-500 reads per sgRNA before any biology (i.e. 15-40M reads for a 77k Brunello). This is the baseline against which all downstream depletion is computed; sequencing the plasmid is non-negotiable.\n\n## Failure Modes\n\n### Wrong TSS in CRISPRi\u002Fa library\n\n**Trigger:** Using Ensembl\u002FRefSeq TSS instead of empirical CAGE peak for genes with broad or non-canonical promoters.\n**Mechanism:** dCas9-KRAB knockdown is maximal within ±100 bp of the actual Pol II loading site; canonical annotation can be off by 1-10 kb.\n**Symptom:** \"Easy\" essentials (RPS, RPL, EIF) show normal dropout but newer genes don't; library validates poorly against CEGv2.\n**Fix:** Re-derive TSS from FANTOM5 CAGE highest-rank peak; for tissue-specific lines, use matched CAGE or GRO-seq.\n\n### Library skew from PCR bias during amplification\n\n**Trigger:** Amplifying the cloned plasmid pool with too many PCR cycles (>20) or with high-GC-bias polymerase.\n**Mechanism:** GC-extreme guides amplify nonlinearly; high-GC guides dominate, low-GC guides drop out.\n**Symptom:** Gini >0.2 on plasmid pool; sgRNAs with GC \u003C30% systematically depleted.\n**Fix:** Cap PCR at 15 cycles; use Q5 or NEBNext Ultra II (low-bias); sequence at 500x post-amp to confirm Gini.\n\n### Oligo-synthesis dropouts in low-complexity guides\n\n**Trigger:** Chip-synthesis errors at homopolymer runs or guides starting with GGGG.\n**Mechanism:** Synthesis chemistry has higher error rate at low-complexity regions; missing oligos cannot be cloned.\n**Symptom:** Specific guides absent from plasmid pool despite no design-rule violation.\n**Fix:** Re-design replacement guides; for production runs, request 2-3x synthesis depth so dropouts are buffered.\n\n### Polyclonality from high MOI\n\n**Trigger:** Infection at MOI >0.5 to \"save cells.\"\n**Mechanism:** Poisson math: at MOI 0.3, 26% of all cells are infected and 4% carry >=2 sgRNAs (14% of the infected fraction); at MOI 0.5, 39% are infected and 9% carry >=2.\n**Symptom:** Hits include neutral genes that co-infect with true essentials.\n**Fix:** MOI 0.3 strict; titer Cas9-positive cells specifically; re-check by qPCR of integration.\n\n### Wrong control proportion\n\n**Trigger:** \u003C100 non-targeting controls in a 70k library.\n**Mechanism:** Null distribution for normalization and FDR rests on the NTC variance; too few NTCs yields unstable median and inflated FDR.\n**Symptom:** Erratic gene-level p-values; MAGeCK FDR fluctuates wildly between runs.\n**Fix:** ~1% of library (500-1,000) NTCs; supplement with non-essential-gene controls.\n\n## Quantitative Thresholds\n\n| Threshold | Value | Source \u002F Rationale |\n|-----------|-------|--------------------|\n| GC content | 30-70% | Doench 2016 Nat Biotech: guides outside this range have low activity |\n| Poly-T avoidance | ≤3 consecutive T | U6 Pol III terminator; ≥4 Ts terminates sgRNA transcription |\n| Guides per gene (Cas9) | 4 (Brunello\u002FTKOv3 standard); up to 6 (Avana, older) | Doench 2016 reports diminishing gene recovery below 4 sgRNAs\u002Fgene; returns flatten above 6 |\n| CRISPRi window | -50 to +300 search; +25 to +75 optimum | Sanson 2018 (Dolcetto); Horlbeck v2 uses -25 to +500 |\n| CRISPRa window | -150 to -75 from TSS | Sanson 2018 (Calabrese); narrower than Horlbeck v2 (-550 to -25) |\n| NTCs in library | ~1% (500-1,000 in a 70k library) | DepMap library design notes; rule-of-thumb for stable null |\n| MOI | 0.3 | Poisson: P(>=2 sgRNAs\u002Fcell) = 4% at MOI 0.3 |\n| Coverage at infection | 500 cells\u002FsgRNA | DepMap convention; 200x minimum, 1000x for noisy \u002F in-vivo |\n| CRISPOR MIT specificity score | >=50 (higher = more specific) | CRISPOR convention (Haeussler 2016) |\n| Library skew (top 10% \u002F bottom 10%) | \u003C2 ideal, \u003C5 acceptable | Joung 2017 Nat Protoc |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| sgRNA fails to express | Poly-T in spacer terminates U6 | Filter `TTTT` in design; this is the #1 silent failure |\n| CRISPRi guide gives no knockdown | Wrong TSS used | Re-derive TSS from FANTOM5 \u002F matched CAGE |\n| Library Gini >0.3 in plasmid pool | PCR over-amplification or synthesis defect | Cap at 15 cycles; re-sequence plasmid; consider re-synthesis |\n| Hits include amplified loci (e.g. ERBB2 in HER2+) | Copy-number amplicon false-essentiality | See [[copy-number-correction]] |\n| Paralog gene absent from hit list despite expression | Cas9 single-KO buffering | Switch to Cas12a multiplex; see [[combinatorial-screens]] |\n| Cas12a oligo doesn't cut | Forgot Cas12a's TTTV PAM is 5' of spacer, not 3' | Re-orient: PAM-then-spacer for Cas12a, opposite of Cas9 |\n\n## References\n\n- Doench JG et al. 2014. *Nat Biotechnol* 32:1262. Rule Set 1.\n- Doench JG et al. 2016. *Nat Biotechnol* 34:184. Rule Set 2, CFD, Brunello\u002FAvana libraries.\n- Sanjana NE et al. 2014. *Nat Methods* 11:783. GeCKOv2.\n- Hart T et al. 2017. *G3* 7:2719. TKOv3 library; CEGv2\u002FNEGv1 reference essentiality gene sets.\n- Sanson KR et al. 2018. *Nat Commun* 9:5416. Dolcetto + Calabrese libraries; CRISPRi\u002Fa TSS rules.\n- Horlbeck MA et al. 2016. *eLife* 5:e19760. CRISPRi\u002Fa design rules; Horlbeck v2 library.\n- Kim HK et al. 2019. *Sci Adv* 5:eaax9249. DeepSpCas9.\n- Xiang X et al. 2021. *Nat Commun* 12:3238. CRISPRon.\n- Tycko J et al. 2019. *Nat Commun* 10:4063. Off-target toxicity mitigation in CRISPR screens.\n- DeWeirdt PC et al. 2021. *Nat Biotechnol* 39:94. enAsCas12a optimization.\n- Esmaeili Anvar N et al. 2024. *Nat Commun* 15:3577. Inzolia \u002F in4mer paralog library.\n- Dede M et al. 2020. *Genome Biol* 21:262. Paralog buffering invisible to Cas9 single-KO.\n- Joung J et al. 2017. *Nat Protoc* 12:828. Genome-wide library screen protocol.\n- Shalem O et al. 2014. *Science* 343:84. Original GeCKO genome-scale knockout library design.\n\n## Related Skills\n\n- crispr-screens\u002Fscreen-qc - Validate library skew, Gini, replicate correlation\n- crispr-screens\u002Fmageck-analysis - Analyze screens run with the designed library\n- crispr-screens\u002Fcombinatorial-screens - Cas12a multiplex \u002F paralog-pair library design\n- crispr-screens\u002Fbase-editing-analysis - base-editor library design\n- crispr-screens\u002Fprime-editing-screens - PRIDICT2-optimized pegRNA libraries\n- crispr-screens\u002Fcopy-number-correction - Filter amplicon-driven artifacts in cancer-cell-line screens\n",{"name":5,"source":24,"license":15,"tool_type":25,"description":7,"imported_at":26,"source_path":27,"primary_tool":28,"source_repository":29},"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills","mixed","2026-09-20","crispr-screens\u002Flibrary-design\u002FSKILL.md","CRISPOR","GPTomics\u002FbioSkills","main","2d1750717747097b602acf30bd09a7cbd4b4c6ea","awesome_skills\u002Fdesign\u002Fbio-crispr-screens-library-design","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous","2026-11-09 11:45:36",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-crispr-screens-library-design",{"tool":42,"command":43},"bunx","bunx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-crispr-screens-library-design",{"tool":45,"command":46},"pnpm","pnpm dlx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-crispr-screens-library-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdesign\u002Fbio-crispr-screens-library-design\u002FSKILL.md",true,[50,56],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"examples\u002Fdesign_library.py","SCRIPT","脚本",5982,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdesign\u002Fbio-crispr-screens-library-design\u002Fexamples\u002Fdesign_library.py",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"usage-guide.md","REFERENCE","参考文档",8776,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdesign\u002Fbio-crispr-screens-library-design\u002Fusage-guide.md",[63,71,78,85,92,99],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":70},"01M7FFFZPC2025JQQHPHDX154J","dei-assessment","Assess diversity, equity, and inclusion with metrics. TRIGGERS - Use when user needs help with dei-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-assessment\u002FSKILL.md",[],[],"2026-11-16 10:05:34",{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":70},"01M7FFFWN8H4WA7A6Y398QKB6J","dei-action-plan","Create DEI action plans with goals and initiatives. TRIGGERS - Use when user needs help with dei-action-plan related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-action-plan\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":70},"01M7FFFSHTM0QZRVZ2NRJTJ0PY","culture-fit-assessment","Design culture add assessment processes. TRIGGERS - Use when user needs help with culture-fit-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fculture-fit-assessment\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":70},"01M7FFFMA12RKEQA38KHJSXXPS","cowork-to-code-bridge","Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcowork-to-code-bridge\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":70},"01M7FFFH1F6M8YRGW5V487GH1K","counter-offer-response","Draft counter-offer responses for retention. TRIGGERS - Use when user needs help with counter-offer-response related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcounter-offer-response\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":70},"01M7FFFDGEHV8Y7J9N40HZXW52","continuous-feedback-system","Design continuous feedback systems. TRIGGERS - Use when user needs help with continuous-feedback-system related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcontinuous-feedback-system\u002FSKILL.md",[],[]]