nota-america/forgecat-agent-profiles / profiles/anthropics/knowledge-work-plugins/anthropics_knowledge-work-plugins_bio-research/for-forgecat/skills/nextflow-development
nextflow-development
UnverifiedRun nf-core bioinformatics pipelines (rnaseq, sarek, atacseq) on sequencing data. Use when analyzing RNA-seq, WGS/WES, or ATAC-seq data—either local FASTQs or public datasets from GEO/SRA. Triggers on nf-core, Nextflow, FASTQ analysis, variant calling, gene expression, differential expression, GEO reanalysis, GSE/GSM/SRR accessions, or samplesheet creation.
| File | Kind | Size |
|---|---|---|
| LICENSE.txt | markdown | 10.0 KB |
| SKILL.md | skill md | 8.7 KB |
| references/geo-sra-acquisition.md | markdown | 13.8 KB |
| references/installation.md | markdown | 1.8 KB |
| references/pipelines/atacseq.md | markdown | 4.1 KB |
| references/pipelines/rnaseq.md | markdown | 3.5 KB |
| references/pipelines/sarek.md | markdown | 3.9 KB |
| references/troubleshooting.md | markdown | 3.3 KB |
| scripts/check_environment.py | script | 13.8 KB |
| scripts/config/genomes.yaml | config | 3.4 KB |
| scripts/config/pipelines/atacseq.yaml | config | 5.0 KB |
| scripts/config/pipelines/rnaseq.yaml | config | 4.1 KB |
| scripts/config/pipelines/sarek.yaml | config | 6.1 KB |
| scripts/detect_data_type.py | script | 9.7 KB |
| scripts/generate_samplesheet.py | script | 15.1 KB |
| scripts/manage_genomes.py | script | 16.3 KB |
| scripts/sra_geo_fetch.py | script | 24.4 KB |
| scripts/utils/__init__.py | script | 1.7 KB |
| scripts/utils/file_discovery.py | script | 5.0 KB |
| scripts/utils/ncbi_utils.py | script | 27.8 KB |
| scripts/utils/sample_inference.py | script | 7.7 KB |
| scripts/utils/validators.py | script | 8.2 KB |
references/troubleshooting.md
View on GitHub# Troubleshooting
Quick fixes for common nf-core pipeline issues.
## Contents
- [Exit Codes](#exit-codes)
- [HPC/Singularity Issues](#hpcsingularity-issues)
- [Pipeline Failures](#pipeline-failures)
- [RNA-seq Specific](#rna-seq-specific)
- [Sarek Specific](#sarek-specific)
- [ATAC-seq Specific](#atac-seq-specific)
- [Resource Management](#resource-management)
- [Getting Help](#getting-help)
## Exit Codes
Common exit codes indicating resource issues (per [nf-core docs](https://nf-co.re/docs/usage/troubleshooting/crash_halfway)):
| Code | Cause | Fix |
|------|-------|-----|
| 137 | Out of memory | `--max_memory '32.GB'` or `'64.GB'` for WGS |
| 143 | Out of memory | `--max_memory '32.GB'` or `'64.GB'` for WGS |
| 104, 134, 139, 247 | Out of memory | Increase `--max_memory` |
| 1 | General error | Check `.nextflow.log` for details |
Most pipelines auto-retry with 2x then 3x resources before failing.
## HPC/Singularity Issues
### Singularity cache issues
```bash
export NXF_SINGULARITY_CACHEDIR="$HOME/.singularity/cache"
mkdir -p $NXF_SINGULARITY_CACHEDIR
```
### Using Singularity instead of Docker
On HPC systems without Docker, use Singularity:
```bash
nextflow run nf-core/<pipeline> -profile singularity ...
```
> **Note**: For basic environment setup (Docker, Nextflow, Java installation), see the inline instructions in Step 1 of SKILL.md.
## Pipeline Failures
### Container pull failed
- Check network connectivity
- Try: `-profile singularity` instead of docker
- For offline: `nf-core download <pipeline> -r <version>`
### "No such file" errors
- Use **absolute paths** in samplesheet
- Verify files exist: `ls /path/to/file`
### Resume not working
```bash
# Check work directory exists
ls -la work/
# Force clean restart (loses cache)
rm -rf work/ .nextflow*
nextflow run nf-core/<pipeline> ...
```
## RNA-seq Specific
### STAR index fails
- Increase memory: `--max_memory '64.GB'`
- Or provide pre-built: `--star_index /path/to/star/`
### Low alignment rate
- Verify genome matches species
- Check FastQC for adapter contamination
- Try different aligner: `--aligner hisat2`
### Strandedness detection fails
- Specify explicitly: `--strandedness reverse`
- Common values: `forward`, `reverse`, `unstranded`
## Sarek Specific
### BQSR fails
- Check known sites for genome
- Skip for non-standard references: `--skip_bqsr`
### Mutect2 no variants
- Verify tumor/normal pairing
- Check samplesheet `status` column: 0=normal, 1=tumor
### Out of memory for WGS
```bash
--max_memory '128.GB' --max_cpus 16
```
### DeepVariant GPU issues
- Ensure NVIDIA Docker runtime configured
- Or use CPU mode (slower)
## ATAC-seq Specific
### Low FRiP score
- Check library complexity in `plotFingerprint/`
- May indicate over-transposition
### Few peaks called
- Lower threshold: `--macs_qvalue 0.1`
- Use broad peaks: `--narrow_peak false`
### High duplicates
- Normal for low-input samples
- Pipeline removes by default
- Consider deeper sequencing
## Resource Management
### Set resource limits
```bash
--max_cpus 8 --max_memory '32.GB' --max_time '24.h'
```
### Check available resources
```bash
# CPUs
nproc
# Memory
free -h
# Disk
df -h .
```
## Getting Help
1. Check `.nextflow.log` for error details
2. Search nf-core Slack: https://nf-co.re/join
3. Open issue on GitHub: https://github.com/nf-core/<pipeline>/issues
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |