Melodie Skills

AI coding agent skills for designing and developing agent-based models (ABM) with the Melodie framework and tab2dict data management library.

What’s Included

skills_cn/ (or skills_en/)
├── melodie-design/                # Model design skill
│   ├── SKILL.md                   # Skill entry point — structured design dialogue
│   └── design-template.md         # README.md template for design documents
├── melodie-develop/               # Model development skill
│   └── SKILL.md                   # Skill entry point — code generation workflow
└── melodie-reference/             # Shared reference docs (loaded by both skills)
    ├── melodie-framework.md       # Core architecture and API reference
    ├── melodie-quickref.md        # Compact API cheat sheet
    ├── melodie-code-templates.md  # Boilerplate code templates
    ├── melodie-data-guide.md      # Input data file format guide
    ├── tab2dict-guide.md          # TabKey / TabDict usage guide
    ├── abm-suitability.md         # When (not) to use ABM
    ├── abm-agent-design.md        # Agent design patterns
    ├── change-impact.md           # Change impact analysis matrices
    └── modules/
        ├── module-grid.md         # Grid (2D space) module
        ├── module-network.md      # Network (graph) module
        ├── module-calibrator.md   # Calibrator (parameter tuning)
        └── module-trainer.md      # Trainer (agent behavior evolution)

melodie-design — Model Design

Guides a structured conversation to help the user design an ABM:

• Phase 0 — Evaluates whether ABM is the right approach for the research question
• Phase A — Collects requirements through a systematic checklist (agents, interactions, decisions, scenarios, data, etc.)
• Phase B — Generates a README.md design document from a template

melodie-develop — Model Development

Takes a README.md design document and turns it into a working Melodie project:

• Reads the design doc, plans the implementation, generates project structure and code
• Creates input data files with correct formats
• Runs the model, handles errors, and reports results

melodie-reference — Shared Reference

Not invoked directly. Both skills load these documents as needed for API details, code patterns, and domain knowledge.

Quick Start (Claude Code)

1. Install the skills — copy the skill files into your project’s .claude/skills/ directory.

2. Design your model — start Claude Code in your project directory and run:

/melodie-design I want to simulate how a carbon tax affects household energy choices

This opens a structured conversation where the AI walks you through research question validation, agent design, interaction mechanisms, and scenario setup. At the end it produces a README.md design document in your project root.