orcaflex-yaml-gotchas
Production-proven OrcaFlex YAML traps and solutions covering dormant properties, boolean mismatches, section ordering, Pydantic integration, and section name aliases.
Best use case
orcaflex-yaml-gotchas is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Production-proven OrcaFlex YAML traps and solutions covering dormant properties, boolean mismatches, section ordering, Pydantic integration, and section name aliases.
Teams using orcaflex-yaml-gotchas should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/yaml-gotchas/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How orcaflex-yaml-gotchas Compares
| Feature / Agent | orcaflex-yaml-gotchas | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Production-proven OrcaFlex YAML traps and solutions covering dormant properties, boolean mismatches, section ordering, Pydantic integration, and section name aliases.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Orcaflex Yaml Gotchas ## Related Skills - [orcaflex-monolithic-to-modular](../orcaflex-monolithic-to-modular/SKILL.md) - Extraction pipeline - [orcaflex-model-generator](../orcaflex-model-generator/SKILL.md) - Builder architecture - [orcaflex-environment-config](../orcaflex-environment-config/SKILL.md) - Environment setup ## References - Source: `src/digitalmodel/solvers/orcaflex/modular_generator/` - Memory: `memory/semantic-validation.md` - OrcaFlex YAML documentation --- ## Version History - **1.0.0** (2026-02-10): Initial release consolidating all production-proven OrcaFlex YAML gotchas from modular generator development (10+ fixes across 5 models). ## Sub-Skills - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+3)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Symptom (+2)](symptom/SKILL.md) - [Safe YAML Builder Pattern (+1)](safe-yaml-builder-pattern/SKILL.md) - [Execution: Validating Generated YAML](execution-validating-generated-yaml/SKILL.md)
Related Skills
OrcaFlex Specialist Skill
```yaml
orcaflex-reporting-fixture-proof-pattern
Build and extend fixture-backed OrcaFlex reporting proof paths in digitalmodel using stable metadata baselines, normalized HTML snapshots, and reusable reporting test helpers.
digitalmodel-orcawave-orcaflex-proof-workflows
Class-level digitalmodel OrcaWave/OrcaFlex readiness, semantic-proof, fixture-proof, and closeout workflows.
orcawave-orcaflex-readiness-audit
Audit the real readiness of digitalmodel OrcaWave/OrcaFlex spec-driven workflows by reconciling workspace-hub issues, source/tests, semantic-equivalence boundaries, and wiki synthesis gaps.
digitalmodel-orcawave-orcaflex-workflow
Current-state workflow for navigating and extending digitalmodel OrcaWave/OrcaFlex capabilities across code, tests, issues, queue tooling, and licensed-machine boundaries.
orcawave-orcaflex-semantic-proof-wave-closeout
Close out an OrcaWave/OrcaFlex semantic-proof wave after a PR merges, split unrelated CI blockers, and seed the next semantic-proof issue wave without duplicating existing issues.
github-actions-trigger-and-shell-gotchas
Prevent false verification gaps in GitHub Actions by checking push path filters, shell compatibility, and shared CI environment failures before concluding a workflow fix worked or failed.
github-actions-cross-platform-validation-gotchas
Execution-time GitHub Actions pitfalls discovered while fixing cross-platform CI workflows — path-filter non-triggers, Windows shell parsing mismatches, and job-scoped validation.
orcawave-to-orcaflex
Integration specialist for converting OrcaWave diffraction results to OrcaFlex vessel types. Handles hydrodynamic database generation, RAO import, viscous damping addition, and coordinate system transformations.
orcaflex-visualization
Generate visualizations from OrcaFlex and OrcaWave simulations using the shared OrcFxAPI — model views (SaveModelView), time series plots, range graphs, and interactive HTML reports. Covers both .dat/.sim (OrcaFlex) and .owd (OrcaWave) files via the same API surface.
orcaflex-vessel-setup
Configure 6-DOF vessels in OrcaFlex with hydrodynamic properties, RAO import from AQWA, and vessel type creation. Covers initial position, orientation, calculation settings, and motion options.
orcaflex-static-debug
Troubleshoot and resolve OrcaFlex static analysis convergence issues. Diagnose common problems including line connectivity, tensions, environmental conditions, and numerical instabilities.