bioepic-data/ecosim-agent / .agents/skills/ecosim-soil-mgmt
ecosim-soil-mgmt
VerifiedPrepare, validate, inspect, and edit EcoSIM soil management inputs using soil_mgmt_in NetCDF, editable Excel workbooks, and optional JSON files. Use when checking fertilizer, tillage, or irrigation management data; converting soil-mngt NetCDF to Excel for editing; converting edited Excel back to JSON or NetCDF; decoding fertf/tillf/irrigf selector variables; or validating EcoSIM ReadManagementMod.F90 soil-management inputs.
EcoSIM Soil Management
Overview
Use this skill to build, inspect, validate, or edit EcoSIM soil_mgmt_in files. Soil management files use yearly selectors (fertf, tillf, irrigf) that point to event-table variables inside the same NetCDF file. Existing NetCDF files can be exported to Excel for editing, then converted back to JSON or NetCDF.
Read references/soil_mgmt_contract.md when you need exact NetCDF dimensions, Excel sheet columns, field order, units, or Fortran reader behavior.
Workflow
- Identify the EcoSIM branch/reader when possible. The canonical reader contract for this skill is
f90src/IOutils/ReadManagementMod.F90. - For an existing
.nc, inspect it first:
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py inspect soil-mngt.nc
- Choose the editing path:
- Existing NetCDF: export to Excel, edit the workbook, then convert the edited workbook back to JSON or NetCDF.
- New file: create JSON directly or an Excel workbook matching the contract schema.
- In Excel, keep event-table names in the
event_filessheet so empty but intentional variables are preserved during round trips. - Keep selector strings short:
fertf,tillf, andirrigfentries are fixed 10-character names. UseNOfor inactive management. - Fertilizer quantities are read as
g m-2. Convert annual or field-rate values before writing:1 g m-2 = 10 kg ha-1. - Use actual calendar years in
DDMMYYYYfor year-specific schedules. The Fortran reader uses the year embedded in the event string for leap-year day-of-year conversion. - After conversion, inspect the new file and check date-year mismatches, missing selector targets, nonzero nutrient totals, and whether expected tillage/irrigation events are present.
- Before accepting generated files or Excel roundtrips, perform the raw-byte
selector check in
references/soil_mgmt_contract.mdunder "Fixed-width string compatibility". Test every year/topographic unit, including defaultNOand short active names. Decoded string equality alone is insufficient. - Evaluate against the consuming branch's
ReadManagementMod.F90,FertilizerMod.F90, andDayMod.F90. Check irrigation-borne nutrients, same-day properties, daily-slot overwrites, and tillage mixing using the contract below. The bridge'sinspectcommand currently summarizes fertilizer tables; it is not a complete irrigation or process-semantics validator.
Conversion Commands
Use the bundled bridge for NetCDF, Excel, and JSON conversions:
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py nc-to-xlsx soil-mngt.nc soil-mngt.xlsx
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py xlsx-to-json soil-mngt.xlsx soil-mngt.json
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py xlsx-to-nc soil-mngt.xlsx soil-mngt-edited.nc --json-output soil-mngt-edited.json
JSON remains supported:
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py nc-to-json soil-mngt.nc soil-mngt.json
.venv-cmip6/bin/python .agents/skills/ecosim-soil-mgmt/scripts/soil_mgmt_excel_bridge.py json-to-nc soil-mngt.json soil-mngt.nc
Validation
For fertilizer-only files, verify that:
fertfselectors point to existing fertilizer variables for every active year.tillfandirrigfareNOif there are no tillage or irrigation events.- Each fertilizer row has 27 fields.
- Fertilizer dates are valid
DDMMYYYYand match the selector year unless deliberately yearless. - Annual N and P totals are plausible for the site and management intensity.
For tillage and irrigation files, also verify row counts do not exceed reader limits: fertilizer <=12, scheduled irrigation <=24, and tillage <=367.
Check every configured forcing year and selector, not just the first/last year. Keep source schedules and record provenance when merging. Carry missing years forward only when authorized, rebase event dates to the target year, and label the originating year and assumptions. Recompute water and nutrient totals after NetCDF readback and Excel roundtrips. See the contract's process checks for the specific equations and reader limitations.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |