Ranch Agent Templates

A registry of installable agent templates for the Ranch platform.

A template bundles everything needed to spin up a new agent: persona (.agent/), evaluation scenarios (.paddock/), declared skills, declared MCP servers, secrets it needs from the operator, and an optional set of installation parameters.

Layout

agent-templates/
├── README.md         this file
├── SPEC.md           manifest specification (agent.yaml v1)
└── <template-id>/
    ├── agent.yaml manifest — the marketplace card
    ├── README.md     human description rendered in the marketplace UI
    ├── .agent/       persona files copied to the agent at install time
    └── .paddock/     evaluation scenarios + paddock config

One folder per template. Versions are tracked via git tags on this repo (e.g. default-v1.0.0), not via vN/ subfolders. Reasoning: keeps each template directory clean and matches how Helm and similar tools work.

Templates

ID	What it is
default	Minimal, neutral chat agent. No admin powers, no preinstalled skills, no MCP. Starting point for customization.

Authoring a new template

1. Read SPEC.md — manifest schema, semantics, edge cases.
2. Copy default/ to <your-id>/ and edit.
3. Validate that .agent/agent.config.json and .paddock/config.json parse as JSON.
4. Tag a release: git tag <id>-v<semver> and push.

Installing

Installation is performed by the Ranch API (see ranch source). This repo is content-only.