formulate-quantum-problem
About
This skill helps developers formulate quantum mechanics or chemistry problems by defining the mathematical framework, including Hilbert space, operators, and boundary conditions. It assists in translating physical scenarios into formalisms like Schrödinger's equation and selecting appropriate solution methods such as perturbation theory or DFT. Use it when setting up a quantum problem for analytical or numerical solution.
Quick Install
Claude Code
Recommendednpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/formulate-quantum-problemCopy and paste this command in Claude Code to install this skill
Documentation
Formulate Quantum Problem
Physical system → well-posed QM problem: ID DOFs → build H + Hilbert space → BCs → pick approx method → validate vs known limits.
Use When
- Set up QM problem for analytic/numerical solution
- QChem calc (MOs, electronic structure)
- Physical scenario → Dirac/Schrödinger
- Choose perturbation / variational / DFT / exact diag
- Theoretical model for spectroscopic/scattering comparison
In
- Required: system desc (atom, molecule, solid, field)
- Required: target observable (spectrum, rates, ground state)
- Optional: experimental constraints
- Optional: accuracy / compute budget
- Optional: formalism (wave mech, matrix mech, 2nd quant, path int)
Do
Step 1: ID system + DOFs
- Particles: list (electrons, nuclei, photons, phonons) + quantum nums (spin, charge, mass)
- Symmetries: spatial (sph/cyl/trans/crystal), internal (spin/gauge), discrete (P, T)
- Energy scales: which DOFs active vs frozen/adiabatic
- Reduction: Born-Oppenheimer if nuclear/electronic timescales separate; collective coords for many-body
## System Characterization
- **Particles**: [list with quantum numbers]
- **Active degrees of freedom**: [coordinates, spins, fields]
- **Frozen degrees of freedom**: [and justification for freezing]
- **Symmetry group**: [continuous and discrete]
- **Energy scale hierarchy**: [e.g., electronic >> vibrational >> rotational]
→ Complete inventory: particles, QNs, symmetries, active vs frozen justified.
If err: hierarchy unclear → keep all DOFs, flag for scale analysis. Premature truncation → wrong physics.
Step 2: Build H + Hilbert space
- Hilbert space: finite-dim → basis (|↑>, |↓>). Infinite → function space (L²(R³) for 3D single particle).
- Kinetic: each particle. Position rep: T = -ℏ²/(2m) nabla².
- Potential: all interactions (Coulomb, harmonic, spin-orbit, external). Explicit form + coupling.
- Composite H: H = T + V, group by type. Multi-particle: exchange/correlation or note via approx.
- Operator algebra: H Hermitian? Constants of motion ([H,O]=0) → block-diagonalize.
## Hamiltonian Structure
- **Hilbert space**: [definition and basis]
- **H = T + V decomposition**:
- T = [kinetic terms]
- V = [potential terms, grouped by type]
- **Constants of motion**: [operators commuting with H]
- **Symmetry-adapted basis**: [if block diagonalization is possible]
→ Complete Hermitian H w/ all terms, Hilbert space defined, constants of motion ID'd.
If err: not Hermitian → missing conjugate / gauge phase. Ambiguous Hilbert space (relativistic) → specify formalism.
Step 3: BCs + initial conditions
- BCs: bound → normalizability (psi→0 at ∞). Scattering → incoming wave. Periodic → Bloch / Born-von Karman.
- Domain: spatial. Box walls. H atom: radial + angular. Lattice + topology.
- Initial state (time-dep): t=0 expansion in eigenbasis or wave packet w/ center + width.
- Constraints: indistinguishable → sym (bosons) / antisym (fermions). Gauge → gauge-fixing.
## Boundary and Initial Conditions
- **Spatial domain**: [definition]
- **Boundary type**: [Dirichlet / Neumann / periodic / scattering]
- **Normalization**: [condition]
- **Particle statistics**: [bosonic / fermionic / distinguishable]
- **Initial state** (if time-dependent): [specification]
→ BCs physically motivated, consistent w/ H domain, unique solution (or scattering matrix).
If err: over/under-determined → check self-adjointness on domain. Non-self-adjoint → handle deficiency indices.
Step 4: Pick approx method
-
Exact solvable: matches known model (HO, H atom, Ising)? → exact + perturbation corrections.
-
Perturbation (weak coupling):
- H = H0 + lambda V, H0 solvable
- lambda V small vs H0 level spacing
- Degeneracy? → degenerate perturbation
- Fits: weak interaction, few-body, analytic needed
-
Variational (ground state):
- Trial wf w/ params
- Satisfies BCs + symmetry
- Fits: ground state energy primary, many-body
-
DFT (many-electron):
- XC functional (LDA, GGA, hybrid)
- Basis (plane waves, Gaussian, NAOs)
- Fits: many-electron, ground state density + energy
-
Numerical exact (small/benchmark):
- Exact diag for small Hilbert
- QMC for ground state sampling
- DMRG for 1D/quasi-1D
- Fits: high accuracy, small system
## Approximation Method Selection
- **Method chosen**: [name]
- **Justification**: [why this method fits the problem structure]
- **Expected accuracy**: [order of perturbation, variational bound quality, DFT functional accuracy]
- **Computational cost**: [scaling with system size]
- **Alternatives considered**: [and why they were rejected]
→ Justified method + expected accuracy + compute cost + alternatives.
If err: no single method fits → formulate for 2 + compare. Disagreement reveals difficulty.
Step 5: Validate vs limits
- Classical (ℏ→0 or large QNs): H reduces to classical mech.
- Non-interacting: couplings → 0 → product of single-particle states.
- Symmetry: respects all symmetries. H transforms correctly under group.
- Dimensional: every H term = energy. Length/energy/time scales reasonable.
- Known exact: special cases (H atom Z=1, HO quadratic) → reproduced.
## Validation Checks
| Check | Expected Result | Status |
|-------|----------------|--------|
| Classical limit (hbar -> 0) | [classical Hamiltonian] | [Pass/Fail] |
| Non-interacting limit | [product states] | [Pass/Fail] |
| Symmetry transformation | [correct representation] | [Pass/Fail] |
| Dimensional analysis | [all terms in energy units] | [Pass/Fail] |
| Known exact case | [reproduced result] | [Pass/Fail] |
→ All pass. Self-consistent, ready to solve.
If err: fail → err in H construction or BCs. Trace to specific term/condition, fix before solving.
Check
- Particles + QNs listed
- Hilbert space + basis
- H Hermitian + correct units
- Constants of motion used
- BCs physically + mathematically sufficient
- Statistics (bos/ferm) enforced
- Method justified + accuracy stated
- Classical, non-interacting, symmetry limits checked
- Known exact reproduced
- Reproducible
Traps
- Premature DOF drop: freeze w/o energy scale arg → wrong physics. Justify every reduction.
- Non-Hermitian H: missing conjugate in spin-orbit / complex V. Verify H=H† explicitly.
- Wrong scattering BCs: bound-state BCs for scattering → discards continuum. Match to question.
- Degeneracy in perturbation: non-deg perturbation on deg level → divergent. Check first.
- Single-method reliance: variational → upper bound but misses excited; perturbation diverges at strong coupling. Cross-validate.
- Unit inconsistency: mixing natural (ℏ=1) + SI. Pick consistent system, state explicitly.
→
derive-theoretical-result— analytic from formulated problemsurvey-theoretical-literature— prior work on similar QM systems
GitHub Repository
Related Skills
llamaguard
OtherLlamaGuard is Meta's 7-8B parameter model for moderating LLM inputs and outputs across six safety categories like violence and hate speech. It offers 94-95% accuracy and can be deployed using vLLM, Hugging Face, or Amazon SageMaker. Use this skill to easily integrate content filtering and safety guardrails into your AI applications.
cost-optimization
OtherThis Claude Skill helps developers optimize cloud costs through resource rightsizing, tagging strategies, and spending analysis. It provides a framework for reducing cloud expenses and implementing cost governance across AWS, Azure, and GCP. Use it when you need to analyze infrastructure costs, right-size resources, or meet budget constraints.
quantizing-models-bitsandbytes
OtherThis skill quantizes LLMs to 8-bit or 4-bit precision using bitsandbytes, achieving 50-75% memory reduction with minimal accuracy loss. It's ideal for running larger models on limited GPU memory or accelerating inference, supporting formats like INT8, NF4, and FP4. The skill integrates with HuggingFace Transformers and enables QLoRA training and 8-bit optimizers.
dispatching-parallel-agents
OtherThis Claude Skill dispatches multiple agents to investigate and fix 3+ independent problems concurrently. It is designed for scenarios involving unrelated failures that can be resolved without shared state or dependencies. The core capability is parallel problem-solving, assigning one agent per independent problem domain to maximize efficiency.
