Updated 5d ago
by lukapiskorec
craftbot
An open toolkit that equips a coding agent to design buildings as executable CAD code. It supplies skills, Python modelling tools, a six-agent team definition and summaries of construction manuals.
183 GitHub stars (183)
+3 in 4 days
| Period | New stars |
|---|---|
| Nov 19 | 0 |
| Nov 20 | +1 |
| Nov 21 | +1 |
| Nov 22 | +1 |
- 14 skills (14 skills found in its SKILL.md files)
- 29 forks (29 forks)
- 5d ago last update (Last updated 5d ago)
Install
Skills CLI
npx skills add lukapiskorec/craftbot
Asks which skills and agents to install. Just one: npx skills add lukapiskorec/craftbot --skill draft-fabrication-plans — add -g for every project.
Claude Code
git clone https://github.com/lukapiskorec/craftbotcp -r "craftbot/skills/draft-fabrication-plans" ~/.claude/skills/
Copies the draft-fabrication-plans skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add lukapiskorec/craftbot
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
draft-fabrication-plans
Use when asked for fabrication files, production drawings, printable A2 or A3 plans, sections, elevations, glue-up templates, a cut list or a stick or material order for building a physical scale model of a finished CraftBot experiment model. Not part of an experiment run.
skills/draft-fabrication-plans/ on GitHub (opens in a new tab)SKILL.md -
extending-previous-models
Use when an experiment continues, layers onto, remodels, or compares against a previous experiment's model or script (inherited geometry, sheathing over an existing frame, deconstruction of an earlier building).
skills/extending-previous-models/ on GitHub (opens in a new tab)SKILL.md -
modular-grids-and-panelization
Use when a brief involves prefabrication, panels, sheet materials, modular dimensioning, CLT or mass timber, or a multi-storey building assembled from factory elements.
skills/modular-grids-and-panelization/ on GitHub (opens in a new tab)SKILL.md -
non-orthogonal-geometry
Use when a brief involves sloped, tilted, twisted, or warped surfaces built from straight timber stock, such as pitched members meeting at angles, hips and valleys, hypar walls or roofs, or deconstructivist forms.
skills/non-orthogonal-geometry/ on GitHub (opens in a new tab)SKILL.md -
procedural-geometry
Use when writing or revising Blender Python that generates construction geometry, before placing members by hand-typed coordinates.
skills/procedural-geometry/ on GitHub (opens in a new tab)SKILL.md -
reading-visual-references
Use 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 read off images.
skills/reading-visual-references/ on GitHub (opens in a new tab)SKILL.md -
roof-framing-and-sheathing
Use when modelling any pitched roof (gable, hip, valley, dormer), roof sheathing, or roof coverings; also when a brief names a roof pitch or covering material.
skills/roof-framing-and-sheathing/ on GitHub (opens in a new tab)SKILL.md -
running-craftbot-experiment
Use when asked to run, start, redo, continue or resume a CraftBot experiment in this repository (an experiments/NN_Name/ folder with input/ and optionally references/), whether invoked as /run-experiment or in plain words. The workflow of the six-agent team (CraftBot, Designer, Researcher, Builder, Inspector, Runner), its hand-off files, phases, rules, cost rules, the multi-variation variant and…
skills/running-craftbot-experiment/ on GitHub (opens in a new tab)SKILL.md -
structural-logic
Use for every building regardless of material, when settling the bearing stack before geometry, when checking that every element has a load path to ground and a bearing at every seat, when checking lateral stability per direction, when sizing concrete, steel or masonry members without an engineer, and when running the independent structural review. The Designer and the Builder load it always; tim…
skills/structural-logic/ on GitHub (opens in a new tab)SKILL.md -
timber-framing
Use when modelling any framed timber structure (stud walls, floors, post-and-beam frames, trusses), when choosing member sizes without a manual, or when reviewing whether a model works as a structure.
skills/timber-framing/ on GitHub (opens in a new tab)SKILL.md -
verifying-models
Use when setting up or running the render-inspect-revise loop for a generated model, when an overlap check reports pairs, or when a model looks right but has not been verified.
skills/verifying-models/ on GitHub (opens in a new tab)SKILL.md -
working-from-reference-documents
Use when an experiment is grounded in a construction manual, design guide, or standard (typically a summarized md document with a source PDF behind it) and the model must stay traceable to it.
skills/working-from-reference-documents/ on GitHub (opens in a new tab)SKILL.md -
writing-design-rationale
Use at the end of every experiment run, before archiving the session transcript, to record decisions, deviations, iterations, and verification honestly.
skills/writing-design-rationale/ on GitHub (opens in a new tab)SKILL.md -
run-experiment
Start, continue, or redo a CraftBot experiment in experiments/ using the repository's coordinated design, build, inspection, and close-out workflow.
.agents/skills/ on GitHub (opens in a new tab)run-experiment/ SKILL.md
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.