Agent skill

Running a CraftBot Experiment

by lukapiskorec in lukapiskorec/craftbot

Runs the six-agent CraftBot workflow in this specific repository, turning a design brief and references into versioned Blender Python scripts, renders, a rationale and an archived transcript.

Custom licenceAuto-check passedAgent Workflows

Install Running a CraftBot Experiment

skills CLI
$ npx skills add lukapiskorec/craftbot --skill running-craftbot-experiment -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lukapiskorec/craftbot running-craftbot-experiment --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lukapiskorec/craftbot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/running-craftbot-experiment .claude/skills/running-craftbot-experiment && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
running-craftbot-experiment
GitHub stars
152
Token cost
~9.1k tokens
SKILL.md length
4,832 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Custom licence

At a glance

Runs the six-agent CraftBot workflow in this specific repository, turning a design brief and references into versioned Blender Python scripts, renders, a rationale and an archived transcript.

  • Works in 6 steps: Set-up (CraftBot). Agent detected and… → Concept (Designer, Researcher).… → Build to the brief (Builders,… → …
  • Starting a new CraftBot design experiment from a brief and reference materials
  • SKILL.md covers Overview, Run folder and agent name, Models per tier and Roles and hand-off files, plus 13 more sections
  • Calls python, gemini and claude

What it does

One run turns an experiments/NN_Name/ folder's brief and references into a building design, carried out since experiment 15 by six agents defined in .claude/agents/: CraftBot as orchestrator, plus Designer, Researcher, Builder, Inspector and Runner roles that it spawns. The user watches narration as the run proceeds and gets a full report at the end; each agent's own procedure lives in its own agent file, with modelling knowledge in separate skills and in tools/. Earlier experiments 01 to 14 were single-agent runs of the same workflow and produce the same output shape minus the hand-off files.

Every run belongs to one model and writes into a run folder named after that model, discovered by the bundled tools rather than registered anywhere else; a fixed naming table turns a reported model name like claude-opus-5-1 into a folder name like Opus 5.1 and a file slug like opus51, with Fable alone keeping its bare name for compatibility with eleven earlier experiments. The default run designs a single building; a brief that explicitly asks for several variations triggers a separate multi-variation workflow with one shared stage followed by one team per variation.

When your agent uses it

  • Starting a new CraftBot design experiment from a brief and reference materials
  • Resuming or redoing an existing experiment run in this repository
  • Running a multi-variation CraftBot experiment that designs several versions of a building

Example prompts

  • “Run the experiment in experiments/16_courtyard-house with the brief in its input folder.”
  • “Resume the Opus run of experiment 12 where it left off.”
  • “Run experiment 18 as a multi-variation run with three design variations.”

Requirements

  • The CraftBot repository with its tools/, skills/ and .claude/agents/ setup
  • Blender for the generated Python scripts and renders

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Set-up (CraftBot). Agent detected and /agent.md written (the folder created if missing, the agent, the mechanical model and the folder…
  2. Concept (Designer, Researcher). concept.md, research through one or more Researchers (each returns a verdict table; the Designer works…
  3. Build to the brief (Builders, Inspectors, Runner). The version loop, one fresh Builder per version: write, render, overlap and contact…
  4. Comparison and structural review (Designer with an Inspector). Against the reference (rationale 3b): the last model versus the photos…
  5. User review rounds. A user message with changes is a new phase: CraftBot appends it verbatim to the prompt file, splits it into scope (its…
  6. Close-out (CraftBot, Runner). Rationale compiled from the notes files, callouts written and checked, the Runner's run check, the final…

What it can do on your machine

Read from SKILL.md and the folder at commit 2c9715b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • gemini
    • claude
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Running a CraftBot Experiment loads about 9.1k tokens when it runs. Until then it costs about 142 tokens; SKILL.md has 4,832 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~142
When it runs · the whole SKILL.md, loaded when a task matches
~9.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 4,832 words (~9,103 tokens).

“One run turns a brief plus reference materials into versioned Blender Python scripts, renders, a design rationale with callouts, models in the web viewer and an archived transcript. Since experiment 15 the run is done by a team of six…”

— opening of SKILL.md by lukapiskorec, Custom licence
name
running-craftbot-experiment

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/running-craftbot-experiment of lukapiskorec/craftbot.

Open the folder on GitHubat commit 2c9715b

Compare with similar skills

Running a CraftBot Experiment next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Running a CraftBot Experiment compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Running a CraftBot Experiment this skilllukapiskorec/craftbot152—~9.1kAutomated safety check: PassCustom licence
Codex with ChatGPT Planning LoopXiaoDuoYa/codex-with-chatgpt7.1k—~11kAutomated safety check: NotesMIT
CCG Tri-Model Orchestrationzereight/gitlab-mcp2k1 repos~657Automated safety check: PassMIT
WebGPTNhahan/WebGPT120—~1.4kAutomated safety check: PassMIT
Codex Workflowsscasella/claude-dynamic-workflows-codex325—~13kAutomated safety check: PassMIT
Council External Codex Reviewaffaan-m/ECC276k—~1.5kAutomated safety check: PassMIT

Similar skills

  • Codex with ChatGPT Planning Loop

    XiaoDuoYa/codex-with-chatgpt

    Uses ChatGPT in the browser as the planning and review brain for a Codex session, with Codex keeping all execution and ChatGPT reading the workspace through a bridge.

    7.1k GitHub stars~11k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check: notes
  • CCG Tri-Model Orchestration

    zereight/gitlab-mcp

    Runs a task through Codex and Gemini CLIs in parallel alongside Claude, then synthesizes the three outputs into one answer with agreements and conflicts called out.

    2k GitHub starsUsed in 1 repo~657 tokens
    Agent WorkflowsAuto-check passed
  • WebGPT

    Nhahan/WebGPT

    Hands bounded tasks from Codex to a signed-in ChatGPT web session at a chosen reasoning level, or opens a terminal chat in your project that you control.

    120 GitHub stars~1.4k tokensUpdated 16 days ago
    Agent WorkflowsAuto-check passed
  • Codex Workflows

    scasella/claude-dynamic-workflows-codex

    Run a dynamic-workflow script on a local Codex App Server — orchestrate many Codex / GPT agents (the agent / parallel / pipeline / phase / budget DSL) instead of Claude subagents, for codebase…

    325 GitHub stars~13k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Adds one optional external Codex critique that tries to break a council's decision draft, sent to OpenAI only after you consent.

    276k GitHub stars~1.5k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Agent Squad Python Guide

    2FastLabs/agent-squad

    Map of the agent-squad Python framework for async multi-agent orchestration: which agent, classifier, storage and tool provider to pick, and the pitfalls to avoid.

    7.8k GitHub stars~4.7k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

More from lukapiskorec/craftbot

All 13 skills in this repo
  • Turns a finished CraftBot building model into cut lists, stick orders and full-scale printable sheets for building a physical scale model by hand.

    152 GitHub stars~2.8k tokensUpdated 9 days ago
    Auto-check passed
  • Rules for continuing or remodeling a prior CraftBot building script: treat the inherited model as a found object, audit it against the brief, and track every change.

    152 GitHub stars~750 tokensUpdated 9 days ago
    Auto-check passed
  • Modular Grids and Panelization

    lukapiskorec/craftbot

    Derives a building's dimensional grid from real sheet, panel, and transport constraints instead of hard-coding spacing numbers.

    152 GitHub stars~1.5k tokensUpdated 9 days ago
    Auto-check passed
  • Non-Orthogonal Timber Geometry

    lukapiskorec/craftbot

    Rules for modeling sloped, twisted and warped timber structures from straight members: ruled surfaces, per-bay framing, plane-cut legs and slab-exact clipping.

    152 GitHub stars~1.2k tokensUpdated 9 days ago
    Auto-check passed
  • Guides Blender Python that generates construction geometry from derived parametric expressions instead of hand-typed coordinates, so changes propagate and overlaps stay checkable.

    152 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed
  • Reading Visual References

    lukapiskorec/craftbot

    A skill your agent uses when the reference material for an experiment is photographs, drawings, or floor plans rather than (or alongside) a dimensioned manual, and dimensions or topology must be…

    152 GitHub stars~994 tokensUpdated 9 days ago
    Auto-check passed

Works with

Categories

Questions about Running a CraftBot Experiment

What does Running a CraftBot Experiment do?

Runs the six-agent CraftBot workflow in this specific repository, turning a design brief and references into versioned Blender Python scripts, renders, a rationale and an archived transcript. claude/agents/: CraftBot as orchestrator, plus Designer, Researcher, Builder, Inspector and Runner roles that it spawns. The user watches narration as the run proceeds and gets a full report at the end; each agent's own procedure lives in its own agent file, with modelling knowledge in separate skills and in tools/.

When should I use Running a CraftBot Experiment?

Running a CraftBot Experiment fits situations like: starting a new CraftBot design experiment from a brief and reference materials; resuming or redoing an existing experiment run in this repository; running a multi-variation CraftBot experiment that designs several versions of a building.

How do I install Running a CraftBot Experiment in Claude Code?

Run `npx skills add lukapiskorec/craftbot --skill running-craftbot-experiment -a claude-code`. Or copy the skill folder (skills/running-craftbot-experiment in lukapiskorec/craftbot) into .claude/skills/running-craftbot-experiment in your project. Claude Code loads it when a task matches its description.

How do I install Running a CraftBot Experiment in Codex?

Run `npx skills add lukapiskorec/craftbot --skill running-craftbot-experiment -a codex`. Or copy the skill folder (skills/running-craftbot-experiment in lukapiskorec/craftbot) into .agents/skills/running-craftbot-experiment in your project. Codex loads it when a task matches its description.

Can I use Running a CraftBot Experiment in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lukapiskorec/craftbot --skill running-craftbot-experiment -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/running-craftbot-experiment, .gemini/skills/running-craftbot-experiment, .github/skills/running-craftbot-experiment and .opencode/skills/running-craftbot-experiment in your project.

What does Running a CraftBot Experiment need to run?

Going by SKILL.md and its folder, Running a CraftBot Experiment needs the command-line tools its instructions call (python, gemini, claude and curl). Our summary lists: The CraftBot repository with its tools/, skills/ and .claude/agents/ setup; Blender for the generated Python scripts and renders.

Does Running a CraftBot Experiment access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Running a CraftBot Experiment safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Running a CraftBot Experiment use?

Running a CraftBot Experiment has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Running a CraftBot Experiment use?

About 9.1k tokens (SKILL.md is roughly 36k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Running a CraftBot Experiment?

Skills that share tags, products or a category with Running a CraftBot Experiment: Codex with ChatGPT Planning Loop (XiaoDuoYa/codex-with-chatgpt, 7.1k stars), CCG Tri-Model Orchestration (zereight/gitlab-mcp, 2k stars), WebGPT (Nhahan/WebGPT, 120 stars) and Codex Workflows (scasella/claude-dynamic-workflows-codex, 325 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Running a CraftBot Experiment?

lukapiskorec (a GitHub user) maintains it in lukapiskorec/craftbot, which has 152 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 30, 2026.

Source: lukapiskorec/craftbot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.