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 guides the translation of physical scenarios into formalisms like Schrödinger's equation and selects 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
Turn physical system into well-posed quantum problem. Find relevant degrees of freedom. Build Hamiltonian + state space. Set boundary conditions. Pick approximation method. Validate formulation vs known limits.
When Use
- Set up quantum mechanics problem for analytic or numerical solution
- Formulate quantum chemistry calculation (molecular orbitals, electronic structure)
- Translate physical scenario into Dirac or Schrodinger formalism
- Pick between perturbation theory, variational, DFT, exact diagonalization
- Prep theoretical model for comparison with experimental spectroscopic or scattering data
Inputs
- Required: Physical system description (atom, molecule, solid, field)
- Required: Observables (energy spectrum, transition rates, ground state)
- Optional: Experimental constraints or data (spectral lines, binding energies)
- Optional: Desired accuracy or computational budget
- Optional: Preferred formalism (wave mechanics, matrix mechanics, second quantization, path integral)
Steps
Step 1: Find Physical System + Relevant Degrees of Freedom
Characterize system before writing equations:
- Particle content: List particles (electrons, nuclei, photons, phonons) + quantum numbers (spin, charge, mass).
- Symmetries: Find spatial (spherical, cylindrical, translational, crystal group), internal (spin rotation, gauge), discrete (parity, time reversal).
- Energy scales: Find relevant energy scales. Decide which degrees of freedom active, which frozen or adiabatic.
- Degrees of freedom shrink: Apply Born-Oppenheimer if nuclear + electronic timescales separate. Find collective coordinates if many-body simplify.
## 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]
Got: Complete inventory — particles, quantum numbers, symmetries, justified active vs frozen degrees of freedom.
If fail: Energy scale hierarchy unclear? Keep all degrees of freedom, flag need for scale analysis. Premature truncation → qualitatively wrong physics.
Step 2: Build Hamiltonian + State Space
Build math framework from degrees of freedom in Step 1:
- Hilbert space: Define state space. Finite-dim → specify basis (spin-1/2 |up>, |down>). Infinite-dim → specify function space (L2(R^3) for single particle in 3D).
- Kinetic terms: Kinetic operator each particle. Position: T = -hbar^2/(2m) nabla^2.
- Potential terms: All interaction potentials (Coulomb, harmonic, spin-orbit, external). Explicit functional form + coupling constants.
- Composite Hamiltonian: Assemble H = T + V, group by interaction type. Multi-particle → include exchange + correlation or note approximation entry.
- Operator algebra: Verify Hamiltonian Hermitian. Find constants of motion ([H, O] = 0) for block-diagonalization.
## 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]
Got: Complete Hermitian Hamiltonian, all terms explicit. Hilbert space defined. Constants of motion identified.
If fail: Not manifestly Hermitian? Check missing conjugate terms or gauge phases. Hilbert space ambiguous (relativistic)? Specify formalism explicit, note issue.
Step 3: Set Boundary + Initial Conditions
Constrain problem for unique solution:
- Boundary conditions: Bound state → normalizability (psi -> 0 at infinity). Scattering → incoming wave boundary. Periodic → Bloch or Born-von Karman.
- Domain restrictions: Spatial domain. Particle in box → walls. Hydrogen atom → radial + angular. Lattice models → lattice + topology.
- Initial state (time-dependent): State at t=0 as expansion in energy eigenbasis or wave packet with center + width.
- Constraint equations: Indistinguishable particles → symmetrize (bosons) or antisymmetrize (fermions). Gauge theories → 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]
Got: Boundary conditions physically motivated, mathematically consistent with Hamiltonian domain, sufficient for unique solution (or well-defined scattering matrix).
If fail: Over- or under-determined? Check self-adjointness of Hamiltonian on chosen domain. Non-self-adjoint → careful treatment of deficiency indices.
Step 4: Pick Approximation Method
Pick solution strategy for problem structure:
-
Check exact solvability: Problem reduces to known exactly solvable model (harmonic oscillator, hydrogen atom, Ising)? Yes → use exact + perturbation for corrections.
-
Perturbation theory (weak coupling):
- Split H = H0 + lambda V, H0 exactly solvable
- Verify lambda V small vs level spacing of H0
- Check degeneracy; degenerate perturbation theory if needed
- Good for: weak interaction, few-body, analytic results
-
Variational methods (ground state):
- Trial wave function with adjustable parameters
- Trial function satisfies boundary + symmetry
- Good for: ground state energy target, many-body
-
Density Functional Theory (many-electron):
- Exchange-correlation functional (LDA, GGA, hybrid)
- Basis set (plane waves, Gaussian, numerical atomic orbitals)
- Good for: many-electron, ground state density + energy
-
Numerical exact methods (small, benchmarking):
- Exact diagonalization for small Hilbert spaces
- Quantum Monte Carlo for ground state sampling
- DMRG for 1D or quasi-1D
- Good for: 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]
Got: Justified choice with clear accuracy + cost. Alternatives documented.
If fail: No single method clearly right? Formulate for two methods + compare. Disagreement reveals difficulty + guides refinement.
Step 5: Validate Formulation vs Known Limits
Before solving, verify formulation reproduces known physics:
- Classical limit: Take hbar -> 0 (or large quantum numbers), verify Hamiltonian reduces to correct classical mechanics.
- Non-interacting limit: Set couplings to zero, verify solution = product of single-particle states.
- Symmetry limits: Verify formulation respects all identified symmetries. Check Hamiltonian transforms correctly under symmetry group.
- Dimensional analysis: Verify every term has units of energy. Check characteristic length, energy, time scales physically reasonable.
- Known exact results: Special cases (hydrogen atom Z=1, harmonic oscillator quadratic potential)? Verify formulation reproduces them.
## 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] |
Got: All validation checks pass. Formulation self-consistent, ready to solve.
If fail: Failed check = error in Hamiltonian construction or boundary. Trace to term or condition, fix before solving.
Checks
- All particles + quantum numbers explicit
- Hilbert space defined with clear basis
- Hamiltonian Hermitian + all terms correct units
- Constants of motion identified + used for simplification
- Boundary conditions physically motivated + mathematically sufficient
- Particle statistics (bosonic/fermionic) correctly enforced
- Approximation method choice justified + accuracy stated
- Classical, non-interacting, symmetry limits checked
- Known exact results reproduced special cases
- Formulation complete for implementation
Pitfalls
- Dropping degrees of freedom early: Freezing without energy scale check misses physics. Always justify with scale argument.
- Non-Hermitian Hamiltonian: Forgetting conjugate terms in spin-orbit or complex potentials. Verify H = H-dagger explicit.
- Wrong boundary for scattering: Bound-state boundary (normalizability) for scattering discards continuous spectrum. Match boundary to physical question.
- Ignoring degeneracy in perturbation theory: Non-degenerate on degenerate level → divergent corrections. Check degeneracy before expanding.
- Over-rely on single approximation: Different methods = complementary failure modes. Variational → upper bounds but miss excited states. Perturbation diverges at strong coupling. Cross-validate when possible.
- Dimensional inconsistency: Mixing natural units (hbar = 1) with SI in same expression. Pick unit system at start, state it explicit.
See Also
derive-theoretical-result-- derive analytic results from formulated problemsurvey-theoretical-literature-- prior work on similar quantum 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.
