[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75K92YQJ0NPMD8R6C1XZSF4":3,"skill-same:01M75K92YQJ0NPMD8R6C1XZSF4":46},{"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":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M75K92YQJ0NPMD8R6C1XZSF4","hisat2-alignment",null,"Splice-aware RNA-seq alignment with HISAT2 — fast, memory-efficient, and the default in many bulk RNA-seq pipelines alongside STAR.","pradyumnasagar\u002Fopen-research-skills","pradyumnasagar","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10559871?v=4","01M75K78MYCCVKRTYGT8KKC380","Pradyumna Jayaram","01M75K78NTNE41F2PE1XBVFHAS",8,"MIT","https:\u002F\u002Fgithub.com\u002Fpradyumnasagar\u002Fopen-research-skills\u002Fblob\u002Fmain\u002Fskills\u002Fbioinformatics-sequence\u002Fhisat2-alignment\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\n\nname: hisat2-alignment\ndescription: \"Splice-aware RNA-seq alignment with HISAT2 — fast, memory-efficient, and the default in many bulk RNA-seq pipelines alongside STAR.\"\nlicense: MIT\n---\n\u003C!-- metadata:\n  category: bioinformatics-sequence\n  oversight: low\n  version: 1.0.0\n  author: Pradyumna Jayaram\n  tags: [bioinformatics-sequence, research]\n  difficulty: intermediate\n-->\n\n# HISAT2 RNA-seq Alignment\n\n## Hard rules\n\n1. **No fabricated citations.** Every cited work must resolve to a verifiable\n2. **No claim without provenance.** Every quantitative or factual claim\n3. **No silent failure.** Every script invocation, API call, or tool use must declare its exit status and what to do on non-zero. A skill that silently swallows errors is a violation.\n\n## When to use\n\n- Bulk RNA-seq alignment to a reference transcriptome\u002Fgenome.\n- Small-genome RNA-seq where STAR's index cost is too high.\n- 3' tag-seq (e.g., Lexogen QuantSeq) with appropriate flag settings.\n- Long RNA-seq (>250 bp reads, e.g., ONT cDNA).\n\n## When NOT to use\n\n- De novo transcript assembly → use `STAR` (better novel junction discovery).\n- DNA-seq variant calling → use `bwa-mem` or `bwa-mem2`.\n- Long reads → use `minimap2` with `-ax splice`.\n\n## Prerequisites\n\n- `hisat2` ≥ 2.2\n- `samtools` ≥ 1.19\n- Reference FASTA + HISAT2 index\n- For best sensitivity: known splice sites from a GTF file\n\n## Core workflow\n\n1. **Extract splice sites and exons from a GTF** to build a sensitive index.\n2. **Build the HISAT2 index** (`hisat2-build` or `hisat2-build-s` with known splice sites).\n3. **Align** with `hisat2 --dta` for downstream transcriptome assembly (StringTie \u002F Cufflinks) or `--no-spliced-alignment` for general use.\n4. **Sort and index** the BAM with `samtools`.\n\n## Code patterns\n\n### Extract splice sites and exons from a GTF\n\n```bash\nhisat2_extract_splice_sites.py genes.gtf > splice_sites.txt\nhisat2_extract_exons.py genes.gtf > exons.txt\n```\n\n### Build a sensitive index (with known splice sites)\n\n```bash\nhisat2-build -p 16 --ss splice_sites.txt --exon exons.txt reference\u002Fgenome.fa genome_hs2\n```\n\n### Build a basic index (no annotation, faster)\n\n```bash\nhisat2-build -p 16 reference\u002Fgenome.fa genome_hs2\n```\n\n### Paired-end alignment (typical bulk RNA-seq)\n\n```bash\nhisat2 -p 16 --dta -x genome_hs2 \\\n    -1 reads_R1.fq.gz -2 reads_R2.fq.gz \\\n    --rg-id sample1 --rg SM:sample1 --rg PL:ILLUMINA --rg LB:lib1 \\\n    -S sample1.sam\nsamtools sort -@ 8 -o sample1.bam sample1.sam\nsamtools index sample1.bam\nrm sample1.sam\n```\n\n`--dta` (downstream-transcriptome-assembly) is required if you'll run StringTie; it reports alignments tailored to transcript assembly.\n\n### Single-end alignment\n\n```bash\nhisat2 -p 16 --dta -x genome_hs2 -U reads.fq.gz --rg-id s1 --rg SM:s1 |\n  samtools sort -@ 8 -o s1.bam -\n```\n\n### rRNA-aware alignment (filter rRNA first, or use `--un-gz` to drop)\n\n```bash\nhisat2 -p 16 --dta --un-gz unmapped.fq.gz -x genome_hs2 -1 R1.fq -2 R2.fq |\n  samtools sort -@ 8 -o s.bam -\n```\n\n`--un-gz` writes reads that didn't align (often rRNA or contaminant) for downstream QC.\n\n### Strand-specific libraries (dUTP \u002F Ligation)\n\nHISAT2 doesn't natively set XS tags; the convention is to use `featureCounts` or `StringTie` to infer strand from spliced alignments. For library prep-specific strand:\n\n```bash\n# Ligation protocol (Illumina TruSeq stranded)\n# HISAT2 reports XS:A:+ \u002F XS:A:- via the spliced alignment orientation\n# featureCounts -s 2 (reverse stranded) will pick this up\n```\n\n### Long-read cDNA (ONT \u002F PacBio Iso-Seq)\n\n```bash\nhisat2 -p 16 --dta -x genome_hs2 -U iso_seq.fq.gz --no-temp-splicesite |\n  samtools sort -@ 8 -o iso.bam -\n```\n\n### nf-core integration\n\n`nf-core\u002Frnaseq` defaults to STAR. To use HISAT2, pass `--aligner hisat2` on the CLI.\n\n## Common pitfalls\n\n- **Forgetting `--dta` for transcriptome assembly.** StringTie\u002FCufflinks require the special scoring.\n- **Building an index without splice sites.** The basic index works but is less sensitive for novel junctions.\n- **Mixing up `--rna-strandness` (legacy flag removed in 2.2).** In HISAT2 2.2+, use downstream tools (`featureCounts -s`) to handle strand.\n- **Not using `--rg-id`.** `featureCounts` and `StringTie` need read groups for multi-sample merges.\n- **STAR's memory cost is too high → HISAT2 with low sensitivity.** If STAR fails on RAM, HISAT2 with the basic index will also miss junctions. Consider subsampling reads or using a known-splice-site index.\n\n## Validation\n\n- `samtools flagstat s.bam` — high mapping rate expected (≥80% for human bulk RNA-seq).\n- `samtools view -c -f 2 s.bam` — properly-paired count.\n- `samtools view s.bam | grep -c 'N:M:'` — spliced alignment count (look for `N` in CIGAR).\n- `samtools view s.bam | awk '$6 ~ \u002FN\u002F' | wc -l` — spliced reads.\n- rRNA fraction should be \u003C 10% for poly-A selected, \u003C 25% for ribo-depleted.\n\n## Open alternatives\n\n| Need | Tool |\n|------|------|\n| Best novel junction discovery | `STAR` |\n| Lower memory footprint | `HISAT2` (this skill) |\n| Long-read cDNA | `minimap2 -ax splice:hq` |\n| Pseudo-alignment (transcripts only) | `salmon`, `kallisto` |\n| Standard bulk RNA-seq | `nf-core\u002Frnaseq` (default STAR, --aligner hisat2 optional) |\n\n## References\n\n- HISAT2 paper: Kim et al. 2019, *Nature Methods* — `10.1038\u002Fs41587-019-0201-4`\n- HISAT2 manual: \u003Chttp:\u002F\u002Fdaehwankimlab.github.io\u002Fhisat2\u002Fmanual\u002F>\n- Companion: `ors-bioinformatics-sequence-star-alignment`, `ors-bioinformatics-sequence-bwa-alignment`.\n\n## Changelog\n\n- 1.0.0 (2026-06-10): Initial adaptation by Pradyumna Jayaram from `bio-hisat2-alignment` (bioSkills-main\u002Fread-alignment\u002Fhisat2-alignment).\"\n\n## Cross-references\n\nOther skills in this category:\n\n- batch-processing\n- bowtie2-alignment\n- bwa-alignment\n- bwa-mem2-alignment\n- codon-usage\n- compressed-sequence-files\n- fastq-quality-scores\n- filter-sequences\n- format-conversion\n- motif-search\n- paired-end-fastq\n- pysam-genomics\n- read-write-sequences\n- reverse-complement\n- sam-bam-basics\n- samtools-bam-processing\n- seq-objects\n- sequence-properties\n- sequence-slicing\n- sequence-statistics\n- star-alignment\n- transcription-translation\n","\u003C!-- metadata:\n  category: bioinformatics-sequence\n  oversight: low\n  version: 1.0.0\n  author: Pradyumna Jayaram\n  tags: [bioinformatics-sequence, research]\n  difficulty: intermediate\n-->\n\n# HISAT2 RNA-seq Alignment\n\n## Hard rules\n\n1. **No fabricated citations.** Every cited work must resolve to a verifiable\n2. **No claim without provenance.** Every quantitative or factual claim\n3. **No silent failure.** Every script invocation, API call, or tool use must declare its exit status and what to do on non-zero. A skill that silently swallows errors is a violation.\n\n## When to use\n\n- Bulk RNA-seq alignment to a reference transcriptome\u002Fgenome.\n- Small-genome RNA-seq where STAR's index cost is too high.\n- 3' tag-seq (e.g., Lexogen QuantSeq) with appropriate flag settings.\n- Long RNA-seq (>250 bp reads, e.g., ONT cDNA).\n\n## When NOT to use\n\n- De novo transcript assembly → use `STAR` (better novel junction discovery).\n- DNA-seq variant calling → use `bwa-mem` or `bwa-mem2`.\n- Long reads → use `minimap2` with `-ax splice`.\n\n## Prerequisites\n\n- `hisat2` ≥ 2.2\n- `samtools` ≥ 1.19\n- Reference FASTA + HISAT2 index\n- For best sensitivity: known splice sites from a GTF file\n\n## Core workflow\n\n1. **Extract splice sites and exons from a GTF** to build a sensitive index.\n2. **Build the HISAT2 index** (`hisat2-build` or `hisat2-build-s` with known splice sites).\n3. **Align** with `hisat2 --dta` for downstream transcriptome assembly (StringTie \u002F Cufflinks) or `--no-spliced-alignment` for general use.\n4. **Sort and index** the BAM with `samtools`.\n\n## Code patterns\n\n### Extract splice sites and exons from a GTF\n\n```bash\nhisat2_extract_splice_sites.py genes.gtf > splice_sites.txt\nhisat2_extract_exons.py genes.gtf > exons.txt\n```\n\n### Build a sensitive index (with known splice sites)\n\n```bash\nhisat2-build -p 16 --ss splice_sites.txt --exon exons.txt reference\u002Fgenome.fa genome_hs2\n```\n\n### Build a basic index (no annotation, faster)\n\n```bash\nhisat2-build -p 16 reference\u002Fgenome.fa genome_hs2\n```\n\n### Paired-end alignment (typical bulk RNA-seq)\n\n```bash\nhisat2 -p 16 --dta -x genome_hs2 \\\n    -1 reads_R1.fq.gz -2 reads_R2.fq.gz \\\n    --rg-id sample1 --rg SM:sample1 --rg PL:ILLUMINA --rg LB:lib1 \\\n    -S sample1.sam\nsamtools sort -@ 8 -o sample1.bam sample1.sam\nsamtools index sample1.bam\nrm sample1.sam\n```\n\n`--dta` (downstream-transcriptome-assembly) is required if you'll run StringTie; it reports alignments tailored to transcript assembly.\n\n### Single-end alignment\n\n```bash\nhisat2 -p 16 --dta -x genome_hs2 -U reads.fq.gz --rg-id s1 --rg SM:s1 |\n  samtools sort -@ 8 -o s1.bam -\n```\n\n### rRNA-aware alignment (filter rRNA first, or use `--un-gz` to drop)\n\n```bash\nhisat2 -p 16 --dta --un-gz unmapped.fq.gz -x genome_hs2 -1 R1.fq -2 R2.fq |\n  samtools sort -@ 8 -o s.bam -\n```\n\n`--un-gz` writes reads that didn't align (often rRNA or contaminant) for downstream QC.\n\n### Strand-specific libraries (dUTP \u002F Ligation)\n\nHISAT2 doesn't natively set XS tags; the convention is to use `featureCounts` or `StringTie` to infer strand from spliced alignments. For library prep-specific strand:\n\n```bash\n# Ligation protocol (Illumina TruSeq stranded)\n# HISAT2 reports XS:A:+ \u002F XS:A:- via the spliced alignment orientation\n# featureCounts -s 2 (reverse stranded) will pick this up\n```\n\n### Long-read cDNA (ONT \u002F PacBio Iso-Seq)\n\n```bash\nhisat2 -p 16 --dta -x genome_hs2 -U iso_seq.fq.gz --no-temp-splicesite |\n  samtools sort -@ 8 -o iso.bam -\n```\n\n### nf-core integration\n\n`nf-core\u002Frnaseq` defaults to STAR. To use HISAT2, pass `--aligner hisat2` on the CLI.\n\n## Common pitfalls\n\n- **Forgetting `--dta` for transcriptome assembly.** StringTie\u002FCufflinks require the special scoring.\n- **Building an index without splice sites.** The basic index works but is less sensitive for novel junctions.\n- **Mixing up `--rna-strandness` (legacy flag removed in 2.2).** In HISAT2 2.2+, use downstream tools (`featureCounts -s`) to handle strand.\n- **Not using `--rg-id`.** `featureCounts` and `StringTie` need read groups for multi-sample merges.\n- **STAR's memory cost is too high → HISAT2 with low sensitivity.** If STAR fails on RAM, HISAT2 with the basic index will also miss junctions. Consider subsampling reads or using a known-splice-site index.\n\n## Validation\n\n- `samtools flagstat s.bam` — high mapping rate expected (≥80% for human bulk RNA-seq).\n- `samtools view -c -f 2 s.bam` — properly-paired count.\n- `samtools view s.bam | grep -c 'N:M:'` — spliced alignment count (look for `N` in CIGAR).\n- `samtools view s.bam | awk '$6 ~ \u002FN\u002F' | wc -l` — spliced reads.\n- rRNA fraction should be \u003C 10% for poly-A selected, \u003C 25% for ribo-depleted.\n\n## Open alternatives\n\n| Need | Tool |\n|------|------|\n| Best novel junction discovery | `STAR` |\n| Lower memory footprint | `HISAT2` (this skill) |\n| Long-read cDNA | `minimap2 -ax splice:hq` |\n| Pseudo-alignment (transcripts only) | `salmon`, `kallisto` |\n| Standard bulk RNA-seq | `nf-core\u002Frnaseq` (default STAR, --aligner hisat2 optional) |\n\n## References\n\n- HISAT2 paper: Kim et al. 2019, *Nature Methods* — `10.1038\u002Fs41587-019-0201-4`\n- HISAT2 manual: \u003Chttp:\u002F\u002Fdaehwankimlab.github.io\u002Fhisat2\u002Fmanual\u002F>\n- Companion: `ors-bioinformatics-sequence-star-alignment`, `ors-bioinformatics-sequence-bwa-alignment`.\n\n## Changelog\n\n- 1.0.0 (2026-06-10): Initial adaptation by Pradyumna Jayaram from `bio-hisat2-alignment` (bioSkills-main\u002Fread-alignment\u002Fhisat2-alignment).\"\n\n## Cross-references\n\nOther skills in this category:\n\n- batch-processing\n- bowtie2-alignment\n- bwa-alignment\n- bwa-mem2-alignment\n- codon-usage\n- compressed-sequence-files\n- fastq-quality-scores\n- filter-sequences\n- format-conversion\n- motif-search\n- paired-end-fastq\n- pysam-genomics\n- read-write-sequences\n- reverse-complement\n- sam-bam-basics\n- samtools-bam-processing\n- seq-objects\n- sequence-properties\n- sequence-slicing\n- sequence-statistics\n- star-alignment\n- transcription-translation\n",{"name":5,"license":15,"description":7},"main","9c0b41e2036cc5588c699f06e658ea6dc3b9685d","skills\u002Fbioinformatics-sequence\u002Fhisat2-alignment",2,"https:\u002F\u002Fgithub.com\u002Fpradyumnasagar\u002Fopen-research-skills","https:\u002F\u002Fgithub.com\u002Fpradyumnasagar","PhD Scholar,\r\nManipal School Of Life Sciences, Manipal\r\n #OpenSourceDeveloper #LifeSciences #ComputationalBiology","2026-10-30 01:30:52",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add pradyumnasagar\u002Fopen-research-skills --skill hisat2-alignment",{"tool":38,"command":39},"bunx","bunx skills add pradyumnasagar\u002Fopen-research-skills --skill hisat2-alignment",{"tool":41,"command":42},"pnpm","pnpm dlx skills add pradyumnasagar\u002Fopen-research-skills --skill hisat2-alignment","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpradyumnasagar\u002Fopen-research-skills\u002Fblob\u002Fmain\u002Fskills\u002Fbioinformatics-sequence\u002Fhisat2-alignment\u002FSKILL.md",true,[],[47,54,60,67,74,81],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M75KTS5K9QNX8FQBTJW2GQSH","good-skill","A well-formed test fixture for the validation script.","https:\u002F\u002Fgithub.com\u002Fpradyumnasagar\u002Fopen-research-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fgood-skill\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M75KTR7FAT0MMMED2EGC9WZZ","BadSkill","https:\u002F\u002Fgithub.com\u002Fpradyumnasagar\u002Fopen-research-skills\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fbad-skill\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M75KTN949EDF77GJDS8H6VR8","my-new-skill","One sentence (max 200 chars) — what the skill does and when to use it.","https:\u002F\u002Fgithub.com\u002Fpradyumnasagar\u002Fopen-research-skills\u002Fblob\u002Fmain\u002Ftemplate\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M75KTHTFS121SSF1Q5X2FXDA","thesis-structure","Use when planning or checking the architecture of a PhD \u002F MPhil thesis in the life sciences or bioinformatics — monograph vs article-based, chapter sequence, IMRaD-based chapters, abstract-to-conclusion flow, and the examiner expectations that the structure must meet.","https:\u002F\u002Fgithub.com\u002Fpradyumnasagar\u002Fopen-research-skills\u002Fblob\u002Fmain\u002Fskills\u002Fthesis-writing\u002Fthesis-structure\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M75KTE3WKW46FXFHQ579H8YP","thesis-methods-reproducibility","Use when writing or checking the Methods, figures, data, and code of a bioinformatics \u002F microbiology \u002F life-science PhD thesis — the FAIR data, versioned code, report-generation, figure-and-table discipline, and the reproducibility expectations that examiners probe at viva.","https:\u002F\u002Fgithub.com\u002Fpradyumnasagar\u002Fopen-research-skills\u002Fblob\u002Fmain\u002Fskills\u002Fthesis-writing\u002Fthesis-methods-reproducibility\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M75KTA033ZQCJY3DC8P5VQET","thesis-defense-viva","Use when preparing for the viva voce \u002F oral thesis defense — building the examiner's question set, rehearsing the presentation, and the pre-defense polish (slides, summary, the 'what if I'm stuck' responses) for a life-science or bioinformatics PhD.","https:\u002F\u002Fgithub.com\u002Fpradyumnasagar\u002Fopen-research-skills\u002Fblob\u002Fmain\u002Fskills\u002Fthesis-writing\u002Fthesis-defense-viva\u002FSKILL.md",[],[]]