bioepic-data/ecosim-agent / .agents/skills/ameriflux-namelist-generator
ameriflux-namelist-generator
UnverifiedCreate EcoSIM Fortran namelists, run folders, and sourced HTML site guides from site-specific grid, plant management, climate forcing, and greenhouse-gas inputs. Use when preparing or updating an EcoSIM namelist, run folder, run directory, or runnable site case for AmeriFlux or FLUXNET sites.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| agents/openai.yaml | config | 229 B |
| assets/ameriflux_namelist.template | other | 2.4 KB |
| references/case_preflight.md | markdown | 4.1 KB |
| references/namelist_contract.md | markdown | 5.8 KB |
| references/runfolder_workflow.md | markdown | 34.5 KB |
| scripts/create_ameriflux_namelist.py | script | 13.9 KB |
| scripts/create_site_run_folder.py | script | 13.1 KB |
| scripts/create_site_smoke_run.py | script | 20.9 KB |
| scripts/run_site_full.py | script | 10.9 KB |
| scripts/test_create_site_run_folder.py | script | 10.1 KB |
| scripts/test_create_site_smoke_run.py | script | 10.6 KB |
| scripts/test_run_site_full.py | script | 6.1 KB |
references/case_preflight.md
View on GitHub# Mandatory case preflight
Case assembly and model launch must use `Tools/case_preflight.py`. This is an
executable gate, not an optional inspection or a previous report to trust.
Run it from the ecosim-agent root to inspect an existing case without running it:
```bash
python Tools/case_preflight.py result/SITE/run_dir/SITE.namelist
```
`create_site_run_folder.py` runs it before returning success.
`create_site_smoke_run.py` checks both the full production request (as a fresh
run) and the proposed short namelist before deleting any previous smoke output;
it repeats these checks after a PFT correction. The one-year evaluation checker
checks both the source production request and the prepared scratch case before
launch. `run_site_full.py` checks the proposed fresh configuration before
changing `continue_run` and checks again before each launch, including the one
permitted continuation. Any new case/run entry point must call the same gate.
Do not bypass it with a direct executable launch when preparing a site case.
Reports contain the assessment time, exact configuration hash, selected input
paths and SHA-256 hashes, requested model/forcing years, climate findings and
site-conflict evidence. The default is `<namelist-stem>.preflight.json` beside
the namelist; smoke checks use the site root and evaluation checks their scratch
root. Reports describe those exact inputs at that time; input, output-selection,
namelist or scope changes require a fresh check. Reports are expected run-folder
artifacts, not model output.
The gate blocks on:
- Unsupported/invalid namelist syntax; unknown groups or keys against the local
standalone Fortran declarations; invalid workflow timing, solver counts,
logical controls or explicit history names.
- Missing selected files or required reader variables; invalid numeric active
entries and incompatible checked dimensions, topographic bounds or capacity.
- Missing/invalid weather records over the actual requested period, using the
climate-readiness validator, including its restart scope and calendar rules.
A stop duration longer than the forcing schedule is an error in this workflow.
- Invalid grid layers and physical/site contradictions from the site-conflict
validator. Only supplied layers are checked for missing data; derived bottom
layers and inactive PFT/event slots can contain padding.
- Incompatible PFT table/management identifiers (including the grid Koppen
override), active/event counts, malformed event strings, invalid dates,
harvest enums and fractions, or missing annual management records. Constant plant management (`pft_dflag=0`)
is supported with one reusable year record; its year label need not cover the
forcing calendar. Bounds, PFT identifiers, planting strings and event counts
still pass the same checks.
- Missing soil-management selector targets or malformed records; monthly GHG
gaps/units or coverage missing **model years**, including spin-up, rather
than merely the cycled weather years.
Unsupported active climate-factor files, fixed-climate/warming modes,
plant-management modes other than constant (0) or forcing-year annual (1), and explicit `restartFileFullPath`
configurations block until a reader-specific validator is implemented. Extend
and test the validator for an additional format/mode; do not add a skip flag or
record an unsupported check as passed. Strict syntax is intentionally narrower
than all possible Fortran namelist syntax; resolve unsupported syntax explicitly.
Scientific provenance and representativeness are separate from these mechanical
checks. Unverified aspect, soil priors, conditional pore-domain comparisons,
weather-clock metadata and absent field evidence remain warnings. A successful
preflight does not establish complete parameter plausibility, management budgets,
all event-code semantics, full CF compliance, restart state equivalence, or
agreement with observations/literature. Continue the sourced field-data review,
two-year trait smoke test and one-year evaluation-output check. The contract is
against the local model source; it does not prove that an arbitrary binary was
built from that source. Preserve the executable/build checks.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |