hpc-orca
ORCA quantum chemistry program. Supports DFT, TDDFT, MP2, CCSD, and spectroscopy calculations. Use for electronic structure calculations, geometry optimization, and spectral simulations.
SKILL.mdskills/hpc-orca/SKILL.md
GitHubHPC-ORCA Skill
ORCA is a quantum chemistry program supporting DFT, TDDFT, frequency calculations, spectrum simulations, and advanced electronic structure methods (MP2, CCSD, CASSCF).
Quick Start
Typical Workflow
- Write ORCA input file (keyword line, module settings, coordinates) — see references/01-input-structure.md
- Select DFT functional and dispersion correction — see references/02-dft-methods.md
- Choose basis set for your system — see references/03-basis-sets.md
- Set up geometry optimization or transition state search — see references/04-optimization.md
- Run frequency calculation to validate stationary point — see references/05-frequency.md
- For excited states / spectroscopy — see references/06-tddft.md
- Add implicit solvent if needed — see references/07-solvation.md
- For advanced features (ONIOM, relativistic, open-shell) — see references/08-advanced.md
- Submit to HPC cluster — see references/09-cluster-execution.md
- Handle errors — see references/error-recovery.md
Skill Map
User Requirements
├─ Input File Authoring
│ ├─ Keyword line structure (! method basis OPT FREQ) → 01-input-structure.md
│ ├─ Module settings (%maxcore, %pal, %geom) → 01-input-structure.md
│ └─ Coordinate input (xyz, z-matrix, external) → 01-input-structure.md
├─ Method Selection
│ ├─ DFT functional (B3LYP, PBE0, wB97X-D, M06-2X) → 02-dft-methods.md
│ ├─ Dispersion correction (D3BJ, D4) → 02-dft-methods.md
│ ├─ RI acceleration (RIJCOSX, RI-J) → 02-dft-methods.md
│ └─ Wavefunction methods (MP2, DLPNO-CCSD(T)) → 02-dft-methods.md
├─ Basis Set Selection
│ └─ def2, Pople, cc-pVnZ, ECP → 03-basis-sets.md
├─ Geometry Optimization
│ ├─ OPT / OPT FREQ → 04-optimization.md
│ ├─ OptTS (transition state) → 04-optimization.md
│ ├─ NEB-TS → 04-optimization.md
│ └─ Convergence criteria → 04-optimization.md
├─ Frequency & Thermochemistry
│ ├─ FREQ / FREQ RAMAN → 05-frequency.md
│ ├─ Thermodynamic corrections → 05-frequency.md
│ └─ Stationary point verification → 05-frequency.md
├─ Spectroscopy
│ ├─ TDDFT (UV-Vis) → 06-tddft.md
│ ├─ ECD (Electronic Circular Dichroism) → 06-tddft.md
│ └─ Excited state optimization → 06-tddft.md
├─ Solvent Effects
│ └─ CPCM, SMD implicit solvent → 07-solvation.md
├─ Advanced Features
│ ├─ ONIOM (QM/MM) → 08-advanced.md
│ ├─ Relativistic (ZORA, DKH2) → 08-advanced.md
│ ├─ Open-shell / broken symmetry → 08-advanced.md
│ └─ NBO, cube file generation → 08-advanced.md
└─ HPC Execution
├─ SLURM/PBS job scripts → 09-cluster-execution.md
├─ %pal nprocs (parallel) → 09-cluster-execution.md
├─ %maxcore (memory) → 09-cluster-execution.md
└─ Checkpoint restart (MOREAD) → 09-cluster-execution.md
Reference Documents
| Document | Content |
|---|---|
| references/01-input-structure.md | Input file anatomy: keyword line, %module blocks, coordinate input formats, output files |
| references/02-dft-methods.md | Functional classification (LDA/GGA/meta-GGA/hybrid/range-separated/double-hybrid), dispersion, RI acceleration |
| references/03-basis-sets.md | def2, Pople, cc-pVnZ, aug-cc-pVnZ, ECP basis sets and selection guide |
| references/04-optimization.md | OPT, OptTS, NEB-TS, constraints, convergence criteria |
| references/05-frequency.md | FREQ, RAMAN, thermodynamic corrections, stationary point verification, isotope effects |
| references/06-tddft.md | TDDFT, UV-Vis, ECD, excited state optimization, spin-flip TDDFT |
| references/07-solvation.md | CPCM, SMD implicit solvent, solvent keywords, pKa calculation |
| references/08-advanced.md | ONIOM, ZORA, DKH2, open-shell, broken symmetry, NBO, cube files |
| references/09-cluster-execution.md | SLURM/PBS scripts, %pal nprocs, %maxcore, checkpoint restart, job monitoring |
| references/error-recovery.md | SCF, geometry optimization, memory, basis set, parallel errors; recovery workflows |
Key Decision Points
| Question | Guide | Summary |
|---|---|---|
| Quick geometry optimization? | 02-dft-methods.md | B3LYP/def2-SVP + RIJCOSX — balance speed and precision |
| High-accuracy energy? | 02-dft-methods.md | DLPNO-CCSD(T)/def2-TZVP — high precision, low computational cost |
| Large molecular system? | 03-basis-sets.md | def2-SVP for pre-optimization, then def2-TZVP |
| Excited state calculation? | 06-tddft.md | TDDFT/wB97X-D/def2-TZVP |
| Transition state search? | 04-optimization.md | OptTS or NEB-TS |
| Spectrum simulation? | 05-frequency.md + 06-tddft.md | FREQ for IR, TDDFT for UV-Vis |
| Solvation effects? | 07-solvation.md | CPCM(solvent) or SMD(solvent) |
| Running on HPC cluster? | 09-cluster-execution.md | SLURM with %pal nprocs |
Guardrails
- Do not run large calculations in root directory — use dedicated run directories.
- Do not ignore SCF convergence warnings — see references/error-recovery.md
- Do not use incompatible functional/basis set combinations — consult references/02-dft-methods.md and references/03-basis-sets.md
- ORCA input is case-insensitive; multiplicity = 2S+1 (closed-shell = 1, radical = 2)
- Always run
FREQafterOPTto verify stationary point (no imaginary freq = minimum, 1 imaginary = TS)
Outputs
Always report:
- Calculation type and method (functional, basis set)
- Charge and multiplicity
- SCF convergence status
- Key output files (.out, .xyz, .gbw, .hess)
- Total energy and optimized geometry (if applicable)
Template Files
Template files in assets/templates/ are ready-to-use starting scaffolds that can be copied and modified:
| Template | Type | Use Case | Reference |
|---|---|---|---|
| assets/templates/sp_dft.inp | Input (.inp) | Single point DFT energy | 01-input-structure.md, 02-dft-methods.md, 03-basis-sets.md |
| assets/templates/opt_freq.inp | Input (.inp) | Geometry optimization + frequency | 04-optimization.md, 05-frequency.md, 07-solvation.md |
| assets/templates/tddft_uvvis.inp | Input (.inp) | TDDFT UV-Vis spectrum | 06-tddft.md, 07-solvation.md |
| assets/templates/neb_ts.inp | Input (.inp) | NEB-TS transition state search | 04-optimization.md, 02-dft-methods.md |
| assets/templates/orca_slurm.sh | Batch script | SLURM submission for ORCA jobs | 09-cluster-execution.md |
Error Recovery
Consult references/error-recovery.md for structured diagnosis of:
- SCF convergence failures (damping, level shift, initial guess)
- Geometry optimization failures (trust radius, Hessian, optimizer choice)
- Memory allocation errors (%maxcore, %pal nprocs)
- Basis set errors (spelling, availability)
- Parallel execution issues (OpenMPI, environment)
- Checkpoint and restart from .gbw file