AMPL experts support with Agentic AI

On demand expert knowledge for modeling, solver tuning, debugging, explainability, installation for Mathematical Optimization with AMPL. This repository includes Skills, Agents, and Rules for agentic tools like Claude Code, Codex, Cursor…

Knowledge consists in Markdown files for Skills, Agents, Rules, and also a References section pointing to official documentation sources to improve quality of replies and reduce hallucinations (internet connection is recommended when using this repo).

Install

This repo is laid out so agentic tools discover it automatically. Place it where your tool already looks:

# Project-local (from your AMPL project root) — pick one
git clone  .cursor
git clone  .claude
git clone  .codex

# Or globally for every project
git clone  ~/.cursor
git clone  ~/.claude
git clone  ~/.codex

Recommended: keep skills/, agents/, rules/, and references/ as separate folders under .cursor, .claude, or .codex (project or home). Most tools infer those paths correctly even if the layout is flatter, but the separated folders match how Cursor, Claude Code, and Codex discover content and avoid collisions with other config in the same directory.

If that folder already exists, clone elsewhere and copy (or symlink) skills/, agents/, rules/, and references/ into it.

That is enough. The repo root maps onto the tool folder, so:

• skills/ — on-demand playbooks (ampl-installer, ampl-modeler, ampl-tuner, ampl-python, ampl-callbacks, ampl-energy, ampl-supply-chain)
• agents/ — delegated specialists (ampl-debugger, ampl-explainer, ampl-supervisor)
• rules/ — always-on constraints (verified solve, model structure, verified URLs, session hygiene, routing)
• references/references.md — URL library the agent should open and fetch from before inventing AMPL syntax or solver options

The skill ↔ agent split is a packaging hint, not a hard law — move a file either way if your harness behaves better that way. Any single markdown file also works pasted or @-attached as a system prompt (portability note).