[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EE0N619PR2012Y2ECM9XRC":3,"skill-same:01M7EE0N619PR2012Y2ECM9XRC":66},{"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":31,"commitSha":32,"skillDirectory":33,"forksCount":14,"repositoryHtmlUrl":34,"repositoryHomepageUrl":34,"ownerHtmlUrl":35,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":36,"install":37,"resources":49},"01M7EE0N619PR2012Y2ECM9XRC","bio-long-read-sequencing-isoseq-analysis",null,"Discovers, classifies, filters, and quantifies full-length transcript isoforms from PacBio Iso-Seq\u002FKinnex (HiFi) and Oxford Nanopore (cDNA\u002Fdirect-RNA) long reads, using the isoseq+pigeon pipeline, SQANTI3, and ONT tools (IsoQuant, FLAIR, Bambu, StringTie2). Covers why a novel isoform is an artifact until proven otherwise (RT template-switching, intra-priming, and 5' degradation manufacture junctions and truncations), the SQANTI3 structural categories and their trust order, the Kinnex skera-split step, orthogonal CAGE\u002Fpoly-A\u002Fshort-read-junction validation, and why long-read isoform quantification needs EM. Use when building a full-length isoform catalog, classifying\u002Ffiltering long-read transcripts, running Iso-Seq or ONT cDNA\u002FdRNA analysis, or judging novel-isoform reliability.","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\u002Fbiology\u002Fbio-long-read-sequencing-isoseq-analysis\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: bio-long-read-sequencing-isoseq-analysis\ndescription: Discovers, classifies, filters, and quantifies full-length transcript isoforms from PacBio Iso-Seq\u002FKinnex (HiFi) and Oxford Nanopore (cDNA\u002Fdirect-RNA) long reads, using the isoseq+pigeon pipeline, SQANTI3, and ONT tools (IsoQuant, FLAIR, Bambu, StringTie2). Covers why a novel isoform is an artifact until proven otherwise (RT template-switching, intra-priming, and 5' degradation manufacture junctions and truncations), the SQANTI3 structural categories and their trust order, the Kinnex skera-split step, orthogonal CAGE\u002Fpoly-A\u002Fshort-read-junction validation, and why long-read isoform quantification needs EM. Use when building a full-length isoform catalog, classifying\u002Ffiltering long-read transcripts, running Iso-Seq or ONT cDNA\u002FdRNA analysis, or judging novel-isoform reliability.\ntool_type: mixed\nprimary_tool: SQANTI3\ngoal_approach_exempt: true\nsource: \"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills\"\nsource_repository: \"GPTomics\u002FbioSkills\"\nsource_path: \"long-read-sequencing\u002Fisoseq-analysis\u002FSKILL.md\"\nlicense: \"MIT\"\nimported_at: \"2026-09-20\"\n---\n\n## Version Compatibility\n\nReference examples tested with: isoseq 4.3+, pigeon 1.2+, SQANTI3 5.2+, pbmm2 1.13+, minimap2 2.28+, IsoQuant 3.4+.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- CLI: `\u003Ctool> --version` then `\u003Ctool> --help` to confirm flags\n- Python\u002FR: `pip show \u003Cpkg>` \u002F `packageVersion('\u003Cpkg>')` for SQANTI3\u002FIsoQuant\u002FBambu\n\nResults depend on inputs that outlive the binary version - record them:\n- The reference annotation + genome version drive SQANTI3\u002Fpigeon classification; record them.\n- Orthogonal support files (CAGE refTSS BED, poly-A motif\u002Fatlas, short-read STAR SJ.out) determine which novels survive; record their provenance.\n- The Iso-Seq binary was renamed `isoseq3` -> `isoseq` in v4; the classifier `pigeon` is a separate binary.\n\nIf code throws an error, introspect the installed tool (`isoseq --help`, `pigeon --help`, `sqanti3_qc.py --help`) and adapt the example to the actual API rather than retrying.\n\n# Full-Length Isoform Analysis\n\n**\"Find the isoforms in my long-read RNA data\"** -> Build a full-length isoform catalog, then classify and filter it against the reference with orthogonal end\u002Fjunction support - because discovery without curation is a catalog of artifacts.\n- CLI: `isoseq refine ... && isoseq collapse ... && pigeon classify ... && pigeon filter ...` (PacBio), `IsoQuant`\u002F`FLAIR`\u002F`Bambu` (ONT)\n\n## The Single Most Important Modern Insight -- A Novel Isoform Is an Artifact Until Proven Otherwise\n\nRT template-switching, intra-priming on genomic poly-A, and 5' RNA degradation actively MANUFACTURE novel junctions and truncated isoforms. So the classification + filter + orthogonal validation IS the analysis, not a QC postscript. Invert the posture from \"I discovered N novel isoforms\" to \"I curated N novel isoforms that survived artifact filtering.\" Three consequences:\n\n1. **A high novel-isoform fraction is a RED FLAG, not a success** - it usually means an under-powered filter or degraded RNA, not unusually rich biology.\n2. **ISM (incomplete-splice-match) is the RNA-degradation thermometer, not a discovery.** ISMs are 5'-truncated FSMs; a high ISM fraction signals bad RNA integrity. Do not report ISMs as novel isoforms without CAGE 5' support.\n3. **The orthogonal validation triad is mandatory:** CAGE peaks for the 5' TSS (catches 5' degradation), poly-A atlas\u002Fmotif for the 3' TES (catches intra-priming), and short-read STAR junctions for splice sites (catches RT-switch\u002FNNC junk).\n\n## SQANTI3 Structural Categories (trust order)\n\nReference comparison is junction-chain based. NIC > NNC in trust, always; ISM is a diagnostic, not a discovery.\n\n| Category (field value) | Meaning | Trust |\n|------------------------|---------|-------|\n| FSM (`full-splice_match`) | every internal junction matches a reference transcript; ends may differ | highest (known); ends still need CAGE\u002FpolyA |\n| ISM (`incomplete-splice_match`) | junction subset of a reference (fewer 5' exons) | low - the 5'-degradation\u002FRT-dropoff signature; trust only with CAGE |\n| NIC (`novel_in_catalog`) | novel combination of KNOWN splice sites | high among novels - RT-switching cannot fake a NIC |\n| NNC (`novel_not_in_catalog`) | >=1 genuinely novel splice site | lower - where junction artifacts concentrate; needs canonical\u002Fshort-read support |\n| genic \u002F genic_intron | overlaps introns\u002Fexons; within an intron | low - pre-mRNA \u002F gDNA carryover |\n| fusion | spans >=2 genes | RT-chimera until proven by short-read split reads |\n| intergenic \u002F antisense | no gene overlap \u002F antisense | novel-gene candidate or artifact; needs ORF\u002FCAGE\u002Fconservation |\n\nMono-exon transcripts have no junctions to validate and are the false-discovery sink (intra-priming + gDNA run unchecked) - require ORF + CAGE + polyA + conservation before belief.\n\n## Platform \u002F Tool Decision Tree\n\n| Data \u002F goal | Tool | Why |\n|-------------|------|-----|\n| PacBio Iso-Seq\u002FKinnex, turnkey | isoseq + pigeon | native PacBio collapse + SQANTI-style classify\u002Ffilter, SMRT Link integrated |\n| Any long-read transcriptome, full curation | SQANTI3 | structural classification + ~50 QC descriptors + rules\u002FML filter + rescue; PacBio and ONT |\n| ONT bulk discovery + quantification | IsoQuant | intron-graph; lowest novel FP rate among ONT tools |\n| ONT, want built-in differential splicing | FLAIR | align -> correct junctions -> collapse -> diffSplice |\n| Quantification with a precision knob | Bambu | NDR (novel discovery rate) calibrates precision; R\u002FBioconductor |\n| Genome-guided assembly \u002F hybrid short+long | StringTie2 `-L` (`--mix`) | fast long-read transcript assembly |\n| ONT single-cell long-read isoforms | FLAMES | single-cell\u002Fspatial full-length isoforms |\n| Differential isoform usage (DTU\u002FDTE) | -> alternative-splicing | this skill yields the filtered set + counts and hands off |\n\n## cDNA vs Direct-RNA and Spliced Alignment\n\nPacBio Iso-Seq and ONT cDNA sequence reverse-transcribed cDNA (modifications erased; strand from primers); ONT direct-RNA sequences native RNA (true strand, poly-A length, modifications preserved, lower accuracy). Match the minimap2 preset to the chemistry:\n\n```bash\nminimap2 -ax splice ref.fa ont_cdna.fq        # ONT cDNA (orient first with pychopper)\nminimap2 -ax splice -uf -k14 ref.fa drna.fq   # ONT direct RNA (stranded -> -uf, small k)\nminimap2 -ax splice:hq -uf ref.fa hifi.fa     # PacBio HiFi (or pbmm2 --preset ISOSEQ)\n```\n\n`-uf` forces the forward transcript strand - correct for stranded dRNA\u002FIso-Seq, wrong for unoriented ONT PCR-cDNA (orient with pychopper first).\n\n## PacBio Iso-Seq \u002F Kinnex Pipeline\n\n```bash\n# 0. Kinnex (MAS-seq) ONLY: deconcatenate the array into segmented reads FIRST\nskera split movie.hifi_reads.bam mas_adapters.fasta movie.segmented.bam   # skip for classic Iso-Seq\n\n# 1. Remove cDNA primers; 2. produce FLNC (full-length non-chimeric)\nlima movie.segmented.bam primers.fasta movie.fl.bam --isoseq --peek-guess\nisoseq refine movie.fl.5p--3p.bam primers.fasta movie.flnc.bam --require-polya\n\n# 3. cluster (reference-free) or skip and align FLNC directly; 4. map; 5. collapse to isoforms\nisoseq cluster2 movie.flnc.bam clustered.bam                              # cluster2 scales to large sets\npbmm2 align --preset ISOSEQ --sort ref.fa clustered.bam mapped.bam\nisoseq collapse --do-not-collapse-extra-5exons mapped.bam movie.flnc.bam collapsed.gff\n#   collapsed.flnc_count.txt = FLNC molecules per isoform = the real DEPTH metric\n\n# 6. classify + filter with pigeon (needs the collapsed.sorted.gff after prepare, NOT a BAM)\npigeon prepare collapsed.gff            # sorts the transcript GFF\npigeon prepare annotation.gtf ref.fa    # sorts the annotation -> annotation.sorted.gtf, indexes genome\npigeon classify collapsed.sorted.gff annotation.sorted.gtf ref.fa \\\n    --fl collapsed.flnc_count.txt --cage-peak cage.refTSS.bed --poly-a polyA.motif.list\npigeon filter collapsed_classification.txt --isoforms collapsed.sorted.gff\npigeon report --exclude-singletons collapsed_classification.filtered_lite_classification.txt saturation.txt\n```\n\npigeon is PacBio's productized SQANTI3 (classify\u002Ffilter, NOT a quantifier). Substitute SQANTI3 itself for the full descriptor set, ML filter, rescue module, and ONT support:\n\n```bash\nsqanti3_qc.py collapsed.gff annotation.gtf ref.fa --CAGE_peak cage.bed --polyA_motif_list polyA.txt \\\n    --short_reads short_reads_fofn.txt    # isoforms positional defaults to GTF\u002FGFF; add --fasta for FASTA input\nsqanti3_filter.py rules collapsed_classification.txt   # or: sqanti3_filter.py ml ...\n```\n\n## Per-Method Failure Modes\n\n### Counting ISMs as novel isoforms\n**Trigger:** reporting incomplete-splice-match transcripts as discoveries. **Mechanism:** 5' RNA degradation truncates FSMs into ISMs. **Symptom:** inflated novel\u002FISM fraction tracking RNA quality, not biology. **Fix:** treat ISM fraction as an integrity QC; keep ISMs only with CAGE 5' support.\n\n### Intra-priming false 3' ends\n**Trigger:** trusting 3' ends without poly-A validation. **Mechanism:** oligo-dT primes on a genomic internal A-stretch. **Symptom:** spurious short\u002Fmono-exon transcripts; `perc_A_downstream_TTS` >59%. **Fix:** SQANTI3\u002Fpigeon filter on downstream genomic A-content and poly-A motif; `--require-polya` alone does NOT catch this.\n\n### Believing NNC novels without scrutiny\n**Trigger:** treating NNC like NIC. **Mechanism:** novel splice sites are where RT template-switching and mapping artifacts land. **Symptom:** novel junctions absent from short-read data. **Fix:** require canonical junctions or short-read SJ coverage; prefer NIC.\n\n### Feeding pigeon a BAM\n**Trigger:** `pigeon classify mapped.bam ...`. **Mechanism:** pigeon classifies the collapsed.sorted.gff after `pigeon prepare`, not an alignment. **Symptom:** wrong-input error. **Fix:** `isoseq collapse` -> `pigeon prepare` -> `pigeon classify`.\n\n### Comparing isoform counts across libraries of different depth\n**Trigger:** raw isoform counts as abundance. **Mechanism:** discovery is depth-unsaturated; truncated reads are multi-isoform-compatible. **Symptom:** deeper libraries \"have more isoforms\"; double-counted abundance. **Fix:** rarefaction curve (`--exclude-singletons`); EM quantification (Bambu\u002FIsoQuant\u002FNanoCount), not raw FLNC counts.\n\n## Quantitative Thresholds\n\n| Threshold | Source | Rationale |\n|-----------|--------|-----------|\n| `perc_A_downstream_TTS` > 59-60% = intra-priming | SQANTI (Tardaguila 2018) | genomic A-rich window means the poly-A was internal, not the real tail |\n| novel junction trusted if canonical OR short-read cov >= 3 | SQANTI3 rules filter | a single criterion for RT-switch\u002FNNC artifacts |\n| ML filter needs >= 250 Reference-Match FSM | SQANTI3 | enough true-positive labels to train; else falls back to rules |\n| exclude singletons (1-FLNC) for saturation | pigeon report | singletons are the dominant unreliable novel bucket |\n| FLNC count = depth metric | isoseq collapse | independently sequenced full-length molecules, before clustering\u002Fdedup |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| `isoseq3: command not found` | renamed in v4 | use `isoseq` (subcommands unchanged) |\n| pigeon classify wrong input | fed a BAM | give the collapsed.sorted.gff after `pigeon prepare` |\n| Huge novel-isoform count | filter skipped\u002Funderpowered | run pigeon\u002FSQANTI3 filter with CAGE\u002FpolyA\u002Fshort-read support |\n| Many mono-exon novels | intra-priming \u002F gDNA carryover | filter on poly-A; require ORF\u002FCAGE for mono-exon |\n| Wrong-strand spliced alignment | `-uf` on unoriented cDNA | orient with pychopper, or drop `-uf` for cDNA |\n| Isoform counts not comparable across samples | depth-unsaturated discovery | EM quantification + rarefaction curve |\n\n## References\n\n- Tardaguila M, de la Fuente L, Marti C, et al. 2018. SQANTI: extensive characterization of long-read transcript sequences for quality control in full-length transcriptome identification and quantification. *Genome Res* 28(3):396-411.\n- Pardo-Palacios FJ, Arzalluz-Luque A, Kondratova L, et al. 2024. SQANTI3: curation of long-read transcriptomes for accurate identification of known and novel isoforms. *Nat Methods* 21(5):793-797.\n- Prjibelski AD, Mikheenko A, Joglekar A, et al. 2023. Accurate isoform discovery with IsoQuant using long reads. *Nat Biotechnol* 41(7):915-918.\n- Tang AD, Soulette CM, van Baren MJ, et al. 2020. Full-length transcript characterization of SF3B1 mutation in chronic lymphocytic leukemia (FLAIR). *Nat Commun* 11:1438.\n- Chen Y, Sim A, Wan YK, et al. 2023. Context-aware transcript quantification from long-read RNA-seq data with Bambu. *Nat Methods* 20(8):1187-1195.\n- Al'Khafaji AM, Smith JT, Garimella KV, et al. 2024. High-throughput RNA isoform sequencing using programmed cDNA concatenation (MAS-ISO-seq\u002FKinnex). *Nat Biotechnol* 42(4):582-586.\n\n## Related Skills\n\n- long-read-alignment - Spliced alignment of cDNA\u002Fdirect-RNA (splice\u002Fsplice:hq, `-uf`)\n- basecalling - Direct-RNA (RNA004) basecalling; cDNA vs direct-RNA chemistry\n- nanopore-methylation - Direct-RNA modifications are separate from isoform structure\n- alternative-splicing\u002Flong-read-splicing - Long-read splicing analysis (define the boundary)\n- alternative-splicing\u002Fisoform-switching - Differential isoform usage (DTU) downstream\n- alternative-splicing\u002Fdifferential-splicing - Differential splicing downstream\n- rna-quantification\u002Ftximport-workflow - Transcript-level quantification downstream\n- genome-annotation\u002Feukaryotic-gene-prediction - Long-read isoforms as annotation evidence\n","## Version Compatibility\n\nReference examples tested with: isoseq 4.3+, pigeon 1.2+, SQANTI3 5.2+, pbmm2 1.13+, minimap2 2.28+, IsoQuant 3.4+.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- CLI: `\u003Ctool> --version` then `\u003Ctool> --help` to confirm flags\n- Python\u002FR: `pip show \u003Cpkg>` \u002F `packageVersion('\u003Cpkg>')` for SQANTI3\u002FIsoQuant\u002FBambu\n\nResults depend on inputs that outlive the binary version - record them:\n- The reference annotation + genome version drive SQANTI3\u002Fpigeon classification; record them.\n- Orthogonal support files (CAGE refTSS BED, poly-A motif\u002Fatlas, short-read STAR SJ.out) determine which novels survive; record their provenance.\n- The Iso-Seq binary was renamed `isoseq3` -> `isoseq` in v4; the classifier `pigeon` is a separate binary.\n\nIf code throws an error, introspect the installed tool (`isoseq --help`, `pigeon --help`, `sqanti3_qc.py --help`) and adapt the example to the actual API rather than retrying.\n\n# Full-Length Isoform Analysis\n\n**\"Find the isoforms in my long-read RNA data\"** -> Build a full-length isoform catalog, then classify and filter it against the reference with orthogonal end\u002Fjunction support - because discovery without curation is a catalog of artifacts.\n- CLI: `isoseq refine ... && isoseq collapse ... && pigeon classify ... && pigeon filter ...` (PacBio), `IsoQuant`\u002F`FLAIR`\u002F`Bambu` (ONT)\n\n## The Single Most Important Modern Insight -- A Novel Isoform Is an Artifact Until Proven Otherwise\n\nRT template-switching, intra-priming on genomic poly-A, and 5' RNA degradation actively MANUFACTURE novel junctions and truncated isoforms. So the classification + filter + orthogonal validation IS the analysis, not a QC postscript. Invert the posture from \"I discovered N novel isoforms\" to \"I curated N novel isoforms that survived artifact filtering.\" Three consequences:\n\n1. **A high novel-isoform fraction is a RED FLAG, not a success** - it usually means an under-powered filter or degraded RNA, not unusually rich biology.\n2. **ISM (incomplete-splice-match) is the RNA-degradation thermometer, not a discovery.** ISMs are 5'-truncated FSMs; a high ISM fraction signals bad RNA integrity. Do not report ISMs as novel isoforms without CAGE 5' support.\n3. **The orthogonal validation triad is mandatory:** CAGE peaks for the 5' TSS (catches 5' degradation), poly-A atlas\u002Fmotif for the 3' TES (catches intra-priming), and short-read STAR junctions for splice sites (catches RT-switch\u002FNNC junk).\n\n## SQANTI3 Structural Categories (trust order)\n\nReference comparison is junction-chain based. NIC > NNC in trust, always; ISM is a diagnostic, not a discovery.\n\n| Category (field value) | Meaning | Trust |\n|------------------------|---------|-------|\n| FSM (`full-splice_match`) | every internal junction matches a reference transcript; ends may differ | highest (known); ends still need CAGE\u002FpolyA |\n| ISM (`incomplete-splice_match`) | junction subset of a reference (fewer 5' exons) | low - the 5'-degradation\u002FRT-dropoff signature; trust only with CAGE |\n| NIC (`novel_in_catalog`) | novel combination of KNOWN splice sites | high among novels - RT-switching cannot fake a NIC |\n| NNC (`novel_not_in_catalog`) | >=1 genuinely novel splice site | lower - where junction artifacts concentrate; needs canonical\u002Fshort-read support |\n| genic \u002F genic_intron | overlaps introns\u002Fexons; within an intron | low - pre-mRNA \u002F gDNA carryover |\n| fusion | spans >=2 genes | RT-chimera until proven by short-read split reads |\n| intergenic \u002F antisense | no gene overlap \u002F antisense | novel-gene candidate or artifact; needs ORF\u002FCAGE\u002Fconservation |\n\nMono-exon transcripts have no junctions to validate and are the false-discovery sink (intra-priming + gDNA run unchecked) - require ORF + CAGE + polyA + conservation before belief.\n\n## Platform \u002F Tool Decision Tree\n\n| Data \u002F goal | Tool | Why |\n|-------------|------|-----|\n| PacBio Iso-Seq\u002FKinnex, turnkey | isoseq + pigeon | native PacBio collapse + SQANTI-style classify\u002Ffilter, SMRT Link integrated |\n| Any long-read transcriptome, full curation | SQANTI3 | structural classification + ~50 QC descriptors + rules\u002FML filter + rescue; PacBio and ONT |\n| ONT bulk discovery + quantification | IsoQuant | intron-graph; lowest novel FP rate among ONT tools |\n| ONT, want built-in differential splicing | FLAIR | align -> correct junctions -> collapse -> diffSplice |\n| Quantification with a precision knob | Bambu | NDR (novel discovery rate) calibrates precision; R\u002FBioconductor |\n| Genome-guided assembly \u002F hybrid short+long | StringTie2 `-L` (`--mix`) | fast long-read transcript assembly |\n| ONT single-cell long-read isoforms | FLAMES | single-cell\u002Fspatial full-length isoforms |\n| Differential isoform usage (DTU\u002FDTE) | -> alternative-splicing | this skill yields the filtered set + counts and hands off |\n\n## cDNA vs Direct-RNA and Spliced Alignment\n\nPacBio Iso-Seq and ONT cDNA sequence reverse-transcribed cDNA (modifications erased; strand from primers); ONT direct-RNA sequences native RNA (true strand, poly-A length, modifications preserved, lower accuracy). Match the minimap2 preset to the chemistry:\n\n```bash\nminimap2 -ax splice ref.fa ont_cdna.fq        # ONT cDNA (orient first with pychopper)\nminimap2 -ax splice -uf -k14 ref.fa drna.fq   # ONT direct RNA (stranded -> -uf, small k)\nminimap2 -ax splice:hq -uf ref.fa hifi.fa     # PacBio HiFi (or pbmm2 --preset ISOSEQ)\n```\n\n`-uf` forces the forward transcript strand - correct for stranded dRNA\u002FIso-Seq, wrong for unoriented ONT PCR-cDNA (orient with pychopper first).\n\n## PacBio Iso-Seq \u002F Kinnex Pipeline\n\n```bash\n# 0. Kinnex (MAS-seq) ONLY: deconcatenate the array into segmented reads FIRST\nskera split movie.hifi_reads.bam mas_adapters.fasta movie.segmented.bam   # skip for classic Iso-Seq\n\n# 1. Remove cDNA primers; 2. produce FLNC (full-length non-chimeric)\nlima movie.segmented.bam primers.fasta movie.fl.bam --isoseq --peek-guess\nisoseq refine movie.fl.5p--3p.bam primers.fasta movie.flnc.bam --require-polya\n\n# 3. cluster (reference-free) or skip and align FLNC directly; 4. map; 5. collapse to isoforms\nisoseq cluster2 movie.flnc.bam clustered.bam                              # cluster2 scales to large sets\npbmm2 align --preset ISOSEQ --sort ref.fa clustered.bam mapped.bam\nisoseq collapse --do-not-collapse-extra-5exons mapped.bam movie.flnc.bam collapsed.gff\n#   collapsed.flnc_count.txt = FLNC molecules per isoform = the real DEPTH metric\n\n# 6. classify + filter with pigeon (needs the collapsed.sorted.gff after prepare, NOT a BAM)\npigeon prepare collapsed.gff            # sorts the transcript GFF\npigeon prepare annotation.gtf ref.fa    # sorts the annotation -> annotation.sorted.gtf, indexes genome\npigeon classify collapsed.sorted.gff annotation.sorted.gtf ref.fa \\\n    --fl collapsed.flnc_count.txt --cage-peak cage.refTSS.bed --poly-a polyA.motif.list\npigeon filter collapsed_classification.txt --isoforms collapsed.sorted.gff\npigeon report --exclude-singletons collapsed_classification.filtered_lite_classification.txt saturation.txt\n```\n\npigeon is PacBio's productized SQANTI3 (classify\u002Ffilter, NOT a quantifier). Substitute SQANTI3 itself for the full descriptor set, ML filter, rescue module, and ONT support:\n\n```bash\nsqanti3_qc.py collapsed.gff annotation.gtf ref.fa --CAGE_peak cage.bed --polyA_motif_list polyA.txt \\\n    --short_reads short_reads_fofn.txt    # isoforms positional defaults to GTF\u002FGFF; add --fasta for FASTA input\nsqanti3_filter.py rules collapsed_classification.txt   # or: sqanti3_filter.py ml ...\n```\n\n## Per-Method Failure Modes\n\n### Counting ISMs as novel isoforms\n**Trigger:** reporting incomplete-splice-match transcripts as discoveries. **Mechanism:** 5' RNA degradation truncates FSMs into ISMs. **Symptom:** inflated novel\u002FISM fraction tracking RNA quality, not biology. **Fix:** treat ISM fraction as an integrity QC; keep ISMs only with CAGE 5' support.\n\n### Intra-priming false 3' ends\n**Trigger:** trusting 3' ends without poly-A validation. **Mechanism:** oligo-dT primes on a genomic internal A-stretch. **Symptom:** spurious short\u002Fmono-exon transcripts; `perc_A_downstream_TTS` >59%. **Fix:** SQANTI3\u002Fpigeon filter on downstream genomic A-content and poly-A motif; `--require-polya` alone does NOT catch this.\n\n### Believing NNC novels without scrutiny\n**Trigger:** treating NNC like NIC. **Mechanism:** novel splice sites are where RT template-switching and mapping artifacts land. **Symptom:** novel junctions absent from short-read data. **Fix:** require canonical junctions or short-read SJ coverage; prefer NIC.\n\n### Feeding pigeon a BAM\n**Trigger:** `pigeon classify mapped.bam ...`. **Mechanism:** pigeon classifies the collapsed.sorted.gff after `pigeon prepare`, not an alignment. **Symptom:** wrong-input error. **Fix:** `isoseq collapse` -> `pigeon prepare` -> `pigeon classify`.\n\n### Comparing isoform counts across libraries of different depth\n**Trigger:** raw isoform counts as abundance. **Mechanism:** discovery is depth-unsaturated; truncated reads are multi-isoform-compatible. **Symptom:** deeper libraries \"have more isoforms\"; double-counted abundance. **Fix:** rarefaction curve (`--exclude-singletons`); EM quantification (Bambu\u002FIsoQuant\u002FNanoCount), not raw FLNC counts.\n\n## Quantitative Thresholds\n\n| Threshold | Source | Rationale |\n|-----------|--------|-----------|\n| `perc_A_downstream_TTS` > 59-60% = intra-priming | SQANTI (Tardaguila 2018) | genomic A-rich window means the poly-A was internal, not the real tail |\n| novel junction trusted if canonical OR short-read cov >= 3 | SQANTI3 rules filter | a single criterion for RT-switch\u002FNNC artifacts |\n| ML filter needs >= 250 Reference-Match FSM | SQANTI3 | enough true-positive labels to train; else falls back to rules |\n| exclude singletons (1-FLNC) for saturation | pigeon report | singletons are the dominant unreliable novel bucket |\n| FLNC count = depth metric | isoseq collapse | independently sequenced full-length molecules, before clustering\u002Fdedup |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| `isoseq3: command not found` | renamed in v4 | use `isoseq` (subcommands unchanged) |\n| pigeon classify wrong input | fed a BAM | give the collapsed.sorted.gff after `pigeon prepare` |\n| Huge novel-isoform count | filter skipped\u002Funderpowered | run pigeon\u002FSQANTI3 filter with CAGE\u002FpolyA\u002Fshort-read support |\n| Many mono-exon novels | intra-priming \u002F gDNA carryover | filter on poly-A; require ORF\u002FCAGE for mono-exon |\n| Wrong-strand spliced alignment | `-uf` on unoriented cDNA | orient with pychopper, or drop `-uf` for cDNA |\n| Isoform counts not comparable across samples | depth-unsaturated discovery | EM quantification + rarefaction curve |\n\n## References\n\n- Tardaguila M, de la Fuente L, Marti C, et al. 2018. SQANTI: extensive characterization of long-read transcript sequences for quality control in full-length transcriptome identification and quantification. *Genome Res* 28(3):396-411.\n- Pardo-Palacios FJ, Arzalluz-Luque A, Kondratova L, et al. 2024. SQANTI3: curation of long-read transcriptomes for accurate identification of known and novel isoforms. *Nat Methods* 21(5):793-797.\n- Prjibelski AD, Mikheenko A, Joglekar A, et al. 2023. Accurate isoform discovery with IsoQuant using long reads. *Nat Biotechnol* 41(7):915-918.\n- Tang AD, Soulette CM, van Baren MJ, et al. 2020. Full-length transcript characterization of SF3B1 mutation in chronic lymphocytic leukemia (FLAIR). *Nat Commun* 11:1438.\n- Chen Y, Sim A, Wan YK, et al. 2023. Context-aware transcript quantification from long-read RNA-seq data with Bambu. *Nat Methods* 20(8):1187-1195.\n- Al'Khafaji AM, Smith JT, Garimella KV, et al. 2024. High-throughput RNA isoform sequencing using programmed cDNA concatenation (MAS-ISO-seq\u002FKinnex). *Nat Biotechnol* 42(4):582-586.\n\n## Related Skills\n\n- long-read-alignment - Spliced alignment of cDNA\u002Fdirect-RNA (splice\u002Fsplice:hq, `-uf`)\n- basecalling - Direct-RNA (RNA004) basecalling; cDNA vs direct-RNA chemistry\n- nanopore-methylation - Direct-RNA modifications are separate from isoform structure\n- alternative-splicing\u002Flong-read-splicing - Long-read splicing analysis (define the boundary)\n- alternative-splicing\u002Fisoform-switching - Differential isoform usage (DTU) downstream\n- alternative-splicing\u002Fdifferential-splicing - Differential splicing downstream\n- rna-quantification\u002Ftximport-workflow - Transcript-level quantification downstream\n- genome-annotation\u002Feukaryotic-gene-prediction - Long-read isoforms as annotation evidence\n",{"name":5,"source":24,"license":15,"tool_type":25,"description":7,"imported_at":26,"source_path":27,"primary_tool":28,"source_repository":29,"goal_approach_exempt":30},"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills","mixed","2026-09-20","long-read-sequencing\u002Fisoseq-analysis\u002FSKILL.md","SQANTI3","GPTomics\u002FbioSkills",true,"main","2d1750717747097b602acf30bd09a7cbd4b4c6ea","awesome_skills\u002Fbiology\u002Fbio-long-read-sequencing-isoseq-analysis","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":38,"prompt":48,"zipAvailable":30},[39,42,45],{"tool":40,"command":41},"npx","npx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-long-read-sequencing-isoseq-analysis",{"tool":43,"command":44},"bunx","bunx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-long-read-sequencing-isoseq-analysis",{"tool":46,"command":47},"pnpm","pnpm dlx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-long-read-sequencing-isoseq-analysis","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-long-read-sequencing-isoseq-analysis\u002FSKILL.md",[50,56,60],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"examples\u002Fisoseq_workflow.sh","SCRIPT","脚本",2357,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-long-read-sequencing-isoseq-analysis\u002Fexamples\u002Fisoseq_workflow.sh",{"path":57,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":58,"sourceHtmlUrl":59},"examples\u002Fsqanti3_qc.sh",1843,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-long-read-sequencing-isoseq-analysis\u002Fexamples\u002Fsqanti3_qc.sh",{"path":61,"resourceType":62,"resourceTypeDesc":63,"sizeBytes":64,"sourceHtmlUrl":65},"usage-guide.md","REFERENCE","参考文档",4641,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-long-read-sequencing-isoseq-analysis\u002Fusage-guide.md",[67,75,82,89,96,103],{"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":74},"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":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":74},"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":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":74},"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":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":74},"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":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":74},"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":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":74},"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",[],[]]