Installs into .claude/skills of the current project.
Are you the author of Canonical Specyml Format Diffractionspec?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/vamseeachanta-canonical-specyml-format-diffractionspec)
---
name: diffraction-analysis-canonical-specyml-format-diffractionspec
description: 'Sub-skill of diffraction-analysis: Canonical spec.yml Format (DiffractionSpec).'
version: 1.0.0
category: engineering
type: reference
scripts_exempt: true
---
# Canonical spec.yml Format (DiffractionSpec)
## Canonical spec.yml Format (DiffractionSpec)
All diffraction analyses should be driven by a `spec.yml` conforming to `DiffractionSpec` (`input_schemas.py`). This is the solver-agnostic input that both OrcaWave and AQWA backends consume.
**Template structure:** `version`, `analysis_type`, `vessel` (name/type/geometry/inertia), `environment`, `frequencies`, `wave_headings`, `solver_options`, `outputs`, `metadata`.
**Live examples:**
- `docs/modules/orcawave/L02_barge_benchmark/spec.yml` -- standard diffraction
- `docs/modules/orcawave/L03_ship_benchmark/spec.yml` -- full QTF + external roll damping
- `docs/modules/orcawave/L04_spar_benchmark/spec.yml` -- rad/s frequency input
**Critical unit rule:** Spec uses pure SI (kg, m, s). Backends convert. But `external_damping`/`external_stiffness` matrices pass through without conversion -- see `orcawave-analysis` skill for details.
