Docs · Agents & Skills

How Axle Keys
organizes intelligent work.

Physical objects need more than a good prompt. They need context, rules, parts, dimensions, validation, and review. Agents and Skills help Axle Keys manage that complexity through clear roles, reusable knowledge, and safe workflows.

Core pipelineSpecialistsSkillsHuman approvalRouting examplesWhat agents should not doMCP relationship
The basic idea

Divide the work.
Preserve the context.

A single assistant trying to plan, design, code, validate, and repair all at once often becomes unreliable. Axle Keys separates the work into agent roles — each with a clearer responsibility.

What the system has to understand

What is the user trying to build?
What System does it belong to?
What files are available?
What model already exists?
What parts are involved?
What parameters should be exposed?
What code should change?
Did the model build correctly?
Did the geometry fail?
What should be repaired?
What should the user approve?

The safest agent is not the most autonomous one. The safest agent knows its job, uses the right context, and makes changes in reviewable steps.

Core pipeline

Six agent roles.

Not every request needs every role. A parameter change may only touch three. A new model may need the full chain. A failed model routes directly to repair.

Project ManagerDesign PlannerParameter DesignerCode AgentValidatorRepair Agent
Project Manager
The orchestrator

Always-on coordinator. Understands the request, checks project context, chooses the workflow, loads the right skills, routes tasks to the right roles, and keeps the user informed. Prevents agents from guessing when context already exists.

Design Planner
The geometry planner

Translates the user's request into a practical modeling plan before code is written. Defines object type, System selection, main parts, spatial relationships, modeling approach, build sequence, and areas that need user confirmation.

Parameter Designer
The controls designer

Decides which dimensions and options become editable parameters. Defines labels, safe ranges, default values, and hidden internal values. Goal: useful control, not endless control — protect the model from confusing or invalid changes.

Code Agent
The model builder

Creates or updates CAD model code using Replicad and System-specific modeling patterns. Should read the existing model before changing it, follow the Design Planner's plan, preserve working code, and make focused changes. Executes the plan — does not guess the whole design.

Validator
The checker

Checks whether the model built correctly and the output appears usable. Covers build status, syntax errors, geometry errors, missing parts, invalid outputs, warning flags, and System-specific checks. Not a fabrication guarantee — a structured error check.

Repair Agent
The focused fixer

Acts when something fails. Job is not to redesign the object — it is to identify the failure and make the smallest useful repair. Reads the validation error, inspects the current model, preserves working parts, creates a focused fix, and re-runs validation.

Specialist agents

Extra expertise when
the task needs it.

Visual Reference Interpreter

Converts images, sketches, screenshots, or visual references into useful project context — object type, proportions, visible parts, style cues, layout, likely dimensions, and areas that need confirmation. Useful when the user uploads reference images.

Technical Reference Interpreter

Reads technical documents, drawings, manuals, diagrams, specifications, or CAD-related reference material — extracting dimensions, constraints, material references, part names, hardware references, tolerances, and warnings.

Textual Reference Interpreter

Turns written briefs, notes, emails, client descriptions, or project instructions into structured requirements — goals, constraints, object types, dimensions, user preferences, missing information, and action items.

Cabinet Systems specialist

Understands panels, openings, shelves, doors, drawer fronts, material thickness, backs, toe kicks, edge banding, and cut lists — helps the workflow stay inside Cabinet Systems logic.

T-Slot Systems specialist

Understands profiles, cut lengths, brackets, fasteners, panels, plates, clearances, and modular assembly logic — helps the workflow stay inside T-Slot Systems logic.

Skills

Reusable knowledge
for repeatable work.

A skill is a reusable packet of knowledge, instructions, rules, examples, or tool guidance. Without skills, agents guess. With skills, agents follow established patterns.

The agent is the role

The skill is the knowledge

The tool is the action

The project is the context

Skills make the workflow consistent: same startup process, same routing logic, same validation approach, same System rules, same repair process. A skill is not just documentation for humans — it is operational context for agents.

Master Skill Pack

Entry point for an agent session. Defines what to do at startup: identify the active model, load core pipeline skills, load System-specific skills, read existing model code before changing it, choose a workflow route, use drafts for meaningful changes, validate before promotion.

Pipeline skills

Define how each core role works — Project Manager, Design Planner, Parameter Designer, Code Agent, Validator, Repair Agent. Each describes responsibilities, inputs, outputs, rules, and failure behavior. Keeps the agent workflow predictable.

System skills

Describe a way of building — Open Design, Cabinet Systems, T-Slot Systems. Include available parts, parameter rules, modeling assumptions, material defaults, output expectations, constraints, examples, and validation checks. What makes agents more useful than generic CAD helpers.

API and tool skills

Explain how to use specific software tools — Replicad API reference, Three.js view rules, file/model/draft/validation/export tools, MCP tool descriptions. Help agents use tools correctly instead of inventing unsupported actions.

Example skills

Working patterns — a simple cabinet, a T-slot frame, a closet bay, a working parameter setup, a known repair pattern. Agents often perform better when they can follow a known pattern.

Human approval

Agents should not
replace review.

Axle Keys works with physical objects. Agent output should be reviewed before it becomes important.

The safe pattern

DraftValidatePromote after review

When approval matters most

  • Changes to model code
  • Fabrication outputs
  • Published models or Showroom products
  • Billing or credits
  • Account settings
  • Destructive actions
  • Public visibility changes
  • Safety-sensitive details

What each step means

  • DraftProposed change without overwriting the live model.
  • ValidateSystem checks for errors, warnings, and build status.
  • PromoteDraft becomes live only after it passes review or approval.
Routing examples

The right workflow
for the task.

Different tasks route through different agent combinations. Simple changes stay shallow. Complex tasks use the full pipeline.

Create a new cabinet
PM selects Cabinet SystemsDesign Planner defines structureParameter Designer sets controlsCode Agent creates draftValidator checks buildRepair if neededUser reviews → promote
Change a dimension
PM checks active modelParameter Designer updates valueValidator checks resultUser reviews

Should not require a full model rewrite.

Repair a failed model
Validator reports errorRepair Agent inspects failureRepair Agent makes focused fixValidator checks againPM reports result

Repair should be narrow.

Use a reference image
Visual Reference Interpreter extracts detailsPM identifies missing informationDesign Planner creates modeling planCode Agent creates draftValidator checks result

The image becomes project context, not just inspiration.

Limits, MCP,
and what's next.

● What agents should not do

Agents should make work more understandable, not more mysterious

  • Guess when project context already exists
  • Overwrite live models without review
  • Rewrite working code unnecessarily
  • Ignore validation failures
  • Hide uncertainty from the user
  • Claim a model is fabrication-ready without review
  • Expose private files publicly
  • Publish without permission
  • Spend credits without user control
  • Change account settings without approval
● Relationship to MCP

Agents & Skills is the structure. MCP is the access layer.

MCP is how agents call Axle Keys tools. Agents & Skills describes how work is organised. Together they form the intelligence layer above Studio.

Agents & Skillsreasoning structure
MCP & APItechnical access layer
Studiohuman workspace
Systemsbuild context
Read MCP & API docs →
○ Future direction

Planned additions

  • More specialist agents: fabrication, materials, drawings, quoting
  • Skill versioning and project-specific skills
  • User-created and System-authored skills
  • Private and public skill packs
  • Session and knowledge graphs — track how a model was created, revised, repaired, validated, published
  • Decision history, skill history, validation history per project

Related pages

MCP & APIStudio DocumentationSystemsFAQRoadmapLegalAll Docs

Structured work
produces better objects.

Clear roles, reusable knowledge, validation, and human review make agent-assisted CAD more reliable — not less. The point is not to remove responsibility. The point is to make the work easier to inspect.