Craftsman Agent Build Plans

---

name: craftsman-agent-build-plans

description: Turn prompts or ideas into 3D assembly/build plans such as LEGO Minecraft via the Craftsman Agent API (OneKey Gateway or local server). Use when generating build plans, inventory lists, or step-by-step assembly images for LEGO/Minecraft from text or reference images, or when wiring clients to the Craftsman Agent endpoints.

env:

DEEPNLP_ONEKEY_ROUTER_ACCESS:

required: true

description: OneKey Gateway API key

dependencies:

npm:

- "@aiagenta2z/onekey-gateway"

python:

- "ai-agent-marketplace"

installation:

npm: npm -g install @aiagenta2z/onekey-gateway

python: pip install ai-agent-marketplace

---

# Craftsman Agent Build Plans

Quick Start

1. Read the server routes in `python/src/server.py` to confirm available endpoints and expected payloads.

1. Prefer OneKey Gateway API for hosted use. Use local `/api/v1/...` endpoints only when the server is running in this repo.

1. Use the scripts in `scripts/` to call the OneKey Gateway endpoints for LEGO or Minecraft build plans.

Authentication Notes

OneKey Gateway Endpoints

- `generate_lego_build_plan`

- `generate_minecraft_build_plan`

Payload shape:

{
  "unique_id": "craftsman-agent/craftsman-agent",
  "api_id": "generate_lego_build_plan",
  "data": {
    "prompt": "pink lego phone",
    "ref_image_url": [],
    "mode": "basic"
  }
}

Scripts

Use these scripts to call the OneKey Gateway endpoints. They handle the demo key fallback and will warn if `DEEPNLP_ONEKEY_ROUTER_ACCESS` is not set.

- `scripts/generate_lego_build_plan.py`

- `scripts/generate_minecraft_build_plan.py`

- `scripts/generate_lego_build_plan.ts`

- `scripts/generate_minecraft_build_plan.ts`

Examples

export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_API_KEY
python3 scripts/generate_lego_build_plan.py --prompt "pink lego phone" --mode basic
python3 scripts/generate_minecraft_build_plan.py --prompt "minecraft pink castle" --mode basic

node scripts/generate_lego_build_plan.ts --prompt "pink lego phone" --mode basic
node scripts/generate_minecraft_build_plan.ts --prompt "minecraft pink castle" --mode basic

Output Expectations

Both endpoints return:

Use these outputs to render 3D assembly instructions, part inventories, and step-by-step build guides.

Dependencies

CLI Dependency

Install onekey-gateway from npm

npm install @aiagenta2z/onekey-gateway

Script Dependency

Install the required Python package before running any scripts.

pip install ai-agent-marketplace

Alternatively, install dependencies from the requirements file:

pip install -r requirements.txt

If the package is already installed, skip installation.

Agent rule

Before executing command lines or running any script in the scripts/ directory, ensure the dependencies are installed.

Use the `onekey` CLI as the preferred method to run the skills.