Machina Agent Builder (Deprecated Alias)
Deprecated: mkn-constructor is a compatibility alias. Use machina-agent-builder for all new work.
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: mkn-constructor-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
mkn-constructor
- 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: mkn-constructor3description: 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 Builder (Deprecated Alias)78> **Deprecated:** `mkn-constructor` is a compatibility alias. Use `machina-agent-builder` for all new work.910End-to-end skill for building, validating, installing, debugging, and maintaining Machina agent templates and their complete resource graphs.1112## References1314Procedural guides for each lifecycle stage:1516| Reference | Description |17|-----------|-------------|18| [init.md](references/init.md) | Scaffold new template project from scratch |19| [create.md](references/create.md) | Generate individual YAML components |20| [validate.md](references/validate.md) | Check YAML files against correct patterns |21| [install.md](references/install.md) | Import templates via MCP (local or Git) |22| [analyze.md](references/analyze.md) | Analyze template structure and dependencies |23| [trace.md](references/trace.md) | Trace agent execution chain with variable propagation |24| [secrets.md](references/secrets.md) | Configure vault secrets for connectors |25| [api.md](references/api.md) | MCP operations for all entities (CRUD, execute, search) |26| [yaml-reference.md](references/yaml-reference.md) | Complete YAML syntax and patterns |27| [connectors.md](references/connectors.md) | Current repository inventory and selected guidance |2829## Schemas3031Schema and reference patterns grounded in current repository examples:3233| Schema | Entity |34|--------|--------|35| [agent.md](schemas/agent.md) | Agent definition |36| [connector.md](schemas/connector.md) | Connector (PyScript + REST API) |37| [document.md](schemas/document.md) | Document task type |38| [mapping.md](schemas/mapping.md) | Data transformation mapping |39| [prompt.md](schemas/prompt.md) | Prompt definition + JSON Schema |40| [setup.md](schemas/setup.md) | `_install.yml` + `_index.yml` |41| [skill.md](schemas/skill.md) | SDK skill registration |42| [workflow.md](schemas/workflow.md) | Workflow + task types |4344## Intent Routing4546When the user triggers this skill, load the appropriate reference:4748| User Says | Reference |49|-----------|-----------|50| "init template", "scaffold template", "new template project" | [init.md](references/init.md) |51| "create agent", "create workflow", "update prompt", "maintain mapping", "scaffold YAML" | [create.md](references/create.md) |52| "validate", "check YAML", "verify template" | [validate.md](references/validate.md) |53| "install", "import", "deploy template" | [install.md](references/install.md) |54| "analyze", "what's in this template", "overview" | [analyze.md](references/analyze.md) |55| "trace", "execution chain", "variable flow", "debug agent" | [trace.md](references/trace.md) |56| "secrets", "credentials", "configure API key" | [secrets.md](references/secrets.md) |57| "API", "MCP operations", "search agents", "execute workflow" | [api.md](references/api.md) |58| "YAML syntax", "task types", "expression syntax", "foreach" | [yaml-reference.md](references/yaml-reference.md) |59| "connectors", "list connectors", "connector docs" | [connectors.md](references/connectors.md) |60| "report bug", "found issue", "feedback", "suggest improvement" | Show **Feedback & Contributing** section below |6162For YAML field specifics, read the relevant schema from `schemas/`.6364## Workflow6566**Name**: `mkn-constructor-check-setup`6768Validates that the `doc-structure` document exists and returns its content.6970| Input | Default | Description |71|-------|---------|-------------|72| `document_name` | `doc-structure` | Document to check |7374| Output | Description |75|--------|-------------|76| `doc-structure` | Document content |77| `check-status` | Workflow execution status |7879## Feedback & Contributing8081Found a bug, unexpected behavior, or have an improvement idea while using this skill?8283- **Report issues**: [Open an issue](https://github.com/machina-sports/machina-templates/issues/new?labels=mkn-constructor) with the label `mkn-constructor`84- **Contribute fixes**: Fork the repo, apply your fix, and [open a PR](https://github.com/machina-sports/machina-templates/pulls) against `main`85- **What to include**: Describe what you expected vs. what happened. For schema/reference fixes, include before/after YAML examples.8687When the user encounters an error, unexpected scaffold output, or expresses frustration with a skill behavior, proactively mention this section and suggest opening an issue.8889## Key Constraints9091- **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.92- **Connector .py files**: No helper functions outside command functions. Each function must be self-contained.93- **Expression syntax**: Always use `$.get('field')` — never `${field}` or `$field`94- **Prompt files**: Use `prompts:` array (not `prompt:`) with `instruction:` (not `messages:`)95- **Connector YAML**: Use `filetype:` (not `type:`) and `filename:` (not `script:`)96- **Install order**: connectors → documents → prompts → mappings → workflows → agents → skills97- **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