onboard-model

Orchestrates onboarding a new environmental model into A2MC as a calibration-ready adapter.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/jingtao-lbl/A2MC --skill onboard-model-jingtao-lbl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: onboard-model
Source: https://github.com/jingtao-lbl/A2MC/tree/main/.claude/skills/onboard-model
Command: npx skills add https://github.com/jingtao-lbl/A2MC --skill onboard-model-jingtao-lbl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coupling a new process-based environmental model (EcoSIM, ATS, PFLOTRAN, CLM/CTSM, TEM) to the A2MC autonomous calibration framework requires building an adapter package, a source-grounded knowledge base, a RAG index, and calibration wiring — a long multi-stage arc that is easy to get wrong. This Skill is the single top-level runbook that drives that entire adapter-kit pipeline from a filled modeler questionnaire to a calibration-ready instance. ## Core Features & Use Cases - Adapter scaffolding and intake: Reads the modeler questionnaire and scaffolds the models/<name>/ adapter package (spec, parsers, version detector, backend, datasets) via init_adapter.py, with conformance validation. - Knowledge-chain orchestration: Delegates the wiki → curated seed → RAG → validate sub-chain to the knowledge-layer skills, with gates (V1–V5 validators, seed-coverage checks, milestone registration) at each stage. - Calibration wiring: Authors the per-model site-config template, canonical parameter list, validation targets, and smoke-tests the reasoning phases so the model can actually be calibrated. - Use Case: A modeler wants to run A2MC's autonomous calibration on ATS. This Skill walks them through characterizing the codebase, building and running a sample case, writing parsers, building the RAG index, and wiring the first calibration case. ## Quick Start Ask the agent to onboard your model into A2MC by providing the filled modeler questionnaire, the model source checkout, a parameter file, and a sample output file.

Frequently Asked Questions about onboard-model

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new model to A2MC for calibration?▼

Run the onboard-model workflow with a filled modeler questionnaire, the model source tree at a known commit, a parameter file, and a sample output. It scaffolds the models/<name>/ adapter package, builds the knowledge chain, and wires the calibration configuration end to end.

What is the difference between onboard-model and build-rag-from-scratch?▼

onboard-model is the top-level orchestrator covering the full adapter arc from questionnaire to calibration-ready instance. build-rag-from-scratch handles only the RAG sub-chain, and onboard-model delegates that portion to it rather than duplicating it.

Which models can be onboarded with this adapter kit?▼

The kit targets process-based environmental models such as EcoSIM, ATS, PFLOTRAN, CLM/CTSM, and TEM. CIME-configured models reuse the CIME runtemplate and CDL parsers, while standalone-binary models use the non-CIME machine config and their own backend.

When should I not use onboard-model?▼

Do not use it to reindex an existing model's RAG (use rebuild-rag) or to run only the RAG sub-chain (use build-rag-from-scratch). It is specifically for taking a model that has no A2MC adapter through the full onboarding arc.

Why does the onboarding require building and running the model's own sample case?▼

The orientation run produces the real output file and working run recipe that the parsers and curated seed are written against. Writing a curated seed for a model nobody has run produces confidently wrong mechanism knowledge that breaks Phase 3 diagnosis.