// For agents

Agent skills pack

Install the SimForge agent skills into Claude Code, Codex or any agent that reads AGENTS.md, from the CLI or as a zip download.

View as Markdown

The skills teach a coding agent to use SimForge: which command comes next, what each error means, and what never to do (such as spending past a cost cap). Each skill is a folder with a SKILL.md, in the Agent Skills format.

Install from the CLI#

The skills ship inside the simforge binary, so they always match its commands:

simforge skills list
simforge skills install --claude          # ~/.claude/skills
simforge skills install --codex           # $CODEX_HOME/skills, else ~/.codex/skills
simforge skills install --dir ./skills    # any folder

skills install records what it wrote. Installing again updates those files; a file you changed by hand is refused (exit 2, skills_modified) unless you pass --force.

Download the pack#

simforge-skills.zip holds the same skills, an AGENTS.md index and a README:

curl -fsSLO https://simforge.ai/docs/simforge-skills.zip
unzip simforge-skills.zip

Agent	Install
Claude Code	`cp -R simforge-skills/skills/* ~/.claude/skills/`, or a project's `.claude/skills/`
Codex	`cp -R simforge-skills/skills/* "${CODEX_HOME:-$HOME/.codex}/skills/"`
Agents that read AGENTS.md	Copy `simforge-skills/skills/` into the repository and add `simforge-skills/AGENTS.md` to its AGENTS.md
Any other agent	Give it /llms.txt, or the `SKILL.md` files as instructions

The skills#

Skill	Use it for
`simforge-quickstart`	A first task: install, sign in, download a map, author, render, RL
`simforge-cli`	The JSON contract, sign-in, cost caps and the MCP server
`simforge-authoring`	Building and editing scenarios with typed operations
`simforge-render`	Previews and renders in 2D, schematic and 3D
`simforge-cloud`	Hosted runs with `--cloud`, caps, runs and results
`simforge-closed-loop`	Local reinforcement learning with SimForge Gym (`simforge-rl`)
`simforge-maps-assets`	Map and actor downloads, caches and licences
`simforge-scenario-package`	Verifying and importing `.scenario.zip` packages
`simforge-troubleshoot`	Reading `simforge doctor` and error codes