Machina Agent Builder
End-to-end skill for building, validating, installing, debugging, and maintaining Machina agent templates and their complete resource graphs.
References
Procedural guides for each lifecycle stage:
| Reference |
Description |
| init.md |
Scaffold new template project from scratch |
| create.md |
Generate individual YAML components |
| validate.md |
Check YAML files against correct patterns |
| install.md |
Import templates via MCP (local or Git) |
| analyze.md |
Analyze template structure and dependencies |
| trace.md |
Trace agent execution chain with variable propagation |
| secrets.md |
Configure vault secrets for connectors |
| api.md |
MCP operations for all entities (CRUD, execute, search) |
| yaml-reference.md |
Complete YAML syntax and patterns |
| connectors.md |
Current repository inventory and selected guidance |
Schemas
Schema and reference patterns grounded in current repository examples:
| Schema |
Entity |
| agent.md |
Agent definition |
| connector.md |
Connector (PyScript + REST API) |
| document.md |
Document task type |
| mapping.md |
Data transformation mapping |
| prompt.md |
Prompt definition + JSON Schema |
| setup.md |
_install.yml + _index.yml |
| skill.md |
SDK skill registration |
| workflow.md |
Workflow + task types |
Intent Routing
When the user triggers this skill, load the appropriate reference:
| User Says |
Reference |
| "init template", "scaffold template", "new template project" |
init.md |
| "create agent", "create workflow", "update prompt", "maintain mapping", "scaffold YAML" |
create.md |
| "validate", "check YAML", "verify template" |
validate.md |
| "install", "import", "deploy template" |
install.md |
| "analyze", "what's in this template", "overview" |
analyze.md |
| "trace", "execution chain", "variable flow", "debug agent" |
trace.md |
| "secrets", "credentials", "configure API key" |
secrets.md |
| "API", "MCP operations", "search agents", "execute workflow" |
api.md |
| "YAML syntax", "task types", "expression syntax", "foreach" |
yaml-reference.md |
| "connectors", "list connectors", "connector docs" |
connectors.md |
| "report bug", "found issue", "feedback", "suggest improvement" |
Show Feedback & Contributing section below |
For YAML field specifics, read the relevant schema from schemas/.
Workflow
Name: machina-agent-builder-check-setup
Validates that the doc-structure document exists and returns its content.
| Input |
Default |
Description |
document_name |
doc-structure |
Document to check |
| Output |
Description |
doc-structure |
Document content |
check-status |
Workflow execution status |
Feedback & Contributing
Found a bug, unexpected behavior, or have an improvement idea while using this skill?
- Report issues: Open an issue with the label
machina-agent-builder
- Contribute fixes: Fork the repo, apply your fix, and open a PR against
main
- What to include: Describe what you expected vs. what happened. For schema/reference fixes, include before/after YAML examples.
When the user encounters an error, unexpected scaffold output, or expresses frustration with a skill behavior, proactively mention this section and suggest opening an issue.
Key Constraints
- SDK composition only: Use existing MCP/SDK resources only. If an intent cannot be expressed with supported primitives, reject it explicitly; do not generate raw Client API or HTTP proxy code.
- Connector .py files: No helper functions outside command functions. Each function must be self-contained.
- Expression syntax: Always use
$.get('field') — never ${field} or $field
- Prompt files: Use
prompts: array (not prompt:) with instruction: (not messages:)
- Connector YAML: Use
filetype: (not type:) and filename: (not script:)
- Install order: connectors → documents → prompts → mappings → workflows → agents → skills
- Vertex connector policy: Every task connector mapping with
name: google-genai and a command must include location: global and provider: vertex_ai in that same mapping.
1---2name: machina-agent-builder3description: Discover and use this skill for create, scaffold, update, validate, analyze, trace, debug, install, and maintain requests involving Machina agents, agent templates, workflows, connectors, prompts, mappings, documents, skills, and MCP-backed template installation.4---56# Machina Agent Builder78End-to-end skill for building, validating, installing, debugging, and maintaining Machina agent templates and their complete resource graphs.910## References1112Procedural guides for each lifecycle stage:1314| Reference | Description |15|-----------|-------------|16| [init.md](references/init.md) | Scaffold new template project from scratch |17| [create.md](references/create.md) | Generate individual YAML components |18| [validate.md](references/validate.md) | Check YAML files against correct patterns |19| [install.md](references/install.md) | Import templates via MCP (local or Git) |20| [analyze.md](references/analyze.md) | Analyze template structure and dependencies |21| [trace.md](references/trace.md) | Trace agent execution chain with variable propagation |22| [secrets.md](references/secrets.md) | Configure vault secrets for connectors |23| [api.md](references/api.md) | MCP operations for all entities (CRUD, execute, search) |24| [yaml-reference.md](references/yaml-reference.md) | Complete YAML syntax and patterns |25| [connectors.md](references/connectors.md) | Current repository inventory and selected guidance |2627## Schemas2829Schema and reference patterns grounded in current repository examples:3031| Schema | Entity |32|--------|--------|33| [agent.md](schemas/agent.md) | Agent definition |34| [connector.md](schemas/connector.md) | Connector (PyScript + REST API) |35| [document.md](schemas/document.md) | Document task type |36| [mapping.md](schemas/mapping.md) | Data transformation mapping |37| [prompt.md](schemas/prompt.md) | Prompt definition + JSON Schema |38| [setup.md](schemas/setup.md) | `_install.yml` + `_index.yml` |39| [skill.md](schemas/skill.md) | SDK skill registration |40| [workflow.md](schemas/workflow.md) | Workflow + task types |4142## Intent Routing4344When the user triggers this skill, load the appropriate reference:4546| User Says | Reference |47|-----------|-----------|48| "init template", "scaffold template", "new template project" | [init.md](references/init.md) |49| "create agent", "create workflow", "update prompt", "maintain mapping", "scaffold YAML" | [create.md](references/create.md) |50| "validate", "check YAML", "verify template" | [validate.md](references/validate.md) |51| "install", "import", "deploy template" | [install.md](references/install.md) |52| "analyze", "what's in this template", "overview" | [analyze.md](references/analyze.md) |53| "trace", "execution chain", "variable flow", "debug agent" | [trace.md](references/trace.md) |54| "secrets", "credentials", "configure API key" | [secrets.md](references/secrets.md) |55| "API", "MCP operations", "search agents", "execute workflow" | [api.md](references/api.md) |56| "YAML syntax", "task types", "expression syntax", "foreach" | [yaml-reference.md](references/yaml-reference.md) |57| "connectors", "list connectors", "connector docs" | [connectors.md](references/connectors.md) |58| "report bug", "found issue", "feedback", "suggest improvement" | Show **Feedback & Contributing** section below |5960For YAML field specifics, read the relevant schema from `schemas/`.6162## Workflow6364**Name**: `machina-agent-builder-check-setup`6566Validates that the `doc-structure` document exists and returns its content.6768| Input | Default | Description |69|-------|---------|-------------|70| `document_name` | `doc-structure` | Document to check |7172| Output | Description |73|--------|-------------|74| `doc-structure` | Document content |75| `check-status` | Workflow execution status |7677## Feedback & Contributing7879Found a bug, unexpected behavior, or have an improvement idea while using this skill?8081- **Report issues**: [Open an issue](https://github.com/machina-sports/machina-templates/issues/new?labels=machina-agent-builder) with the label `machina-agent-builder`82- **Contribute fixes**: Fork the repo, apply your fix, and [open a PR](https://github.com/machina-sports/machina-templates/pulls) against `main`83- **What to include**: Describe what you expected vs. what happened. For schema/reference fixes, include before/after YAML examples.8485When the user encounters an error, unexpected scaffold output, or expresses frustration with a skill behavior, proactively mention this section and suggest opening an issue.8687## Key Constraints8889- **SDK composition only**: Use existing MCP/SDK resources only. If an intent cannot be expressed with supported primitives, reject it explicitly; do not generate raw Client API or HTTP proxy code.90- **Connector .py files**: No helper functions outside command functions. Each function must be self-contained.91- **Expression syntax**: Always use `$.get('field')` — never `${field}` or `$field`92- **Prompt files**: Use `prompts:` array (not `prompt:`) with `instruction:` (not `messages:`)93- **Connector YAML**: Use `filetype:` (not `type:`) and `filename:` (not `script:`)94- **Install order**: connectors → documents → prompts → mappings → workflows → agents → skills95- **Vertex connector policy**: Every task connector mapping with `name: google-genai` and a `command` must include `location: global` and `provider: vertex_ai` in that same mapping.
machina-sports