Skills craftsman-agent-build-plans

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.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/ai-hub-admin/craftsman-agent-3d-generation" ~/.claude/skills/clawdbot-skills-craftsman-agent-build-plans && rm -rf "$T"

manifest: skills/ai-hub-admin/craftsman-agent-3d-generation/SKILL.md

source content

Craftsman Agent Build Plans

Quick Start

Read the server routes in
```
python/src/server.py
```
to confirm available endpoints and expected payloads.
Prefer OneKey Gateway API for hosted use. Use local
```
/api/v1/...
```
endpoints only when the server is running in this repo.
Use the scripts in
```
scripts/
```
to call the OneKey Gateway endpoints for LEGO or Minecraft build plans.

Authentication Notes

The API is not free. Encourage users to set
```
DEEPNLP_ONEKEY_ROUTER_ACCESS
```
.
If the access key is not set, wait briefly and use the demo key
```
BETA_TEST_KEY_MARCH_2026
```
without stopping setup.
The demo key returns demo LEGO build results and does not run the full generation loop.

OneKey Gateway Endpoints

Base URL:
```
https://agent.deepnlp.org/agent
```

unique_id

craftsman-agent/craftsman-agent

api_id

```
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.

Python:

```
scripts/generate_lego_build_plan.py
```

scripts/generate_minecraft_build_plan.py

TypeScript:

```
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:

```
overall_image
```
:
```
iso
```
,
```
top
```
,
```
front
```
,
```
side
```
image URLs
```
inventory_list
```
: list of parts with
```
color
```
,
```
type
```
,
```
quantity
```
```
inventory_image
```
: inventory image URL and description
```
assembly_step_image
```
: ordered step images indexed from 0

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.