generating-mod-envs

name	generating-mod-envs
description	Generates and reviews mod learning env JSON files for Letta Code local mods. Use when asked to teach, learn, or optimize a mod behavior; create, draft, validate, improve, or explain envs for `/mods learn --env`; or design evaluation scenarios, memory fixtures, requiredResultMarkers, requiredTraceMarkers, negative controls, and candidate diversity hints.
disable-model-invocation	true
user-invocable	true

Generating mod learning envs

Use this skill to create JSON envs consumed by /mods learn --env=<path> or bun scripts/mod-learning/learn-mod.ts --env <path>. An env describes the mod behavior to learn and the scenario-suite eval used to score candidates.

Workflow

1. Define the behavior and eval before writing JSON.
   • What should the mod do? Tool, turn event, tool event, provider, command, status, etc.
   • What would a placebo/no-op mod fail?
   • What unique sentinel strings make success unambiguous?
2. Choose a path:
   • Repo example: docs/examples/mods/learning/<slug>.env.json
   • Local/private: any user-requested path
3. Draft strict JSON. Start from assets/mod-learning-env.template.json if useful. No comments or trailing commas.
4. Prefer evaluation.scenarios with at least:
   • happy path