| name | machina-constructor |
| description | Construct and scaffold Machina agent-templates and connectors with correct YAML structure, then install them via MCP. Use when users ask to "create a template", "scaffold an agent", "init template", "build a new connector", "install template", "validate template", "analyze template", "trace agent", or "configure secrets". Trigger phrases: "create a template", "scaffold an agent", "init template", "build a new connector", "install template", "validate template", "analyze template", "trace agent", or "configure secrets". |
Template Constructor
End-to-end skill for building, validating, and deploying Machina agent-templates and connectors.
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 | All available connectors with docs |
| frontend-api.md | Next.js frontend API integration |
Schemas
Authoritative field definitions for every Machina entity:
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", "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 |
| "frontend", "Next.js", "API integration", "document search" | frontend-api.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
skill: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
- 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
<error_handling>
If any schema validation or template construction fails:
- Output an
<error> block detailing the exact YAML syntax error or missing field.
- Suggest opening an issue using the links in the Feedback & Contributing section.
- DO NOT silently ignore schema violations.
</error_handling>