smoothstone — Claude Code skill for 3D models and setup
smoothstone is a Claude Code skill that turns text requests or images into 3D-printable parts. It runs on requests for an STL, a printer model, or a part based on a photo or drawing.
MIT ★ 81 updated 2026-11-15
npx skills add baney75/smoothstone --skill smoothstone -a claude-codeWhat smoothstone does
smoothstone uses the stone CLI to select a parametric recipe, set its values, and create an STL through OpenSCAD. It checks properties such as a closed mesh, a flat base, wall thickness, overhangs, and size.
For images, it can trace outlines for items such as keychains, cookie cutters, and signs, or make a height map for lithophanes and reliefs. Work steps stay in a job folder, and stone status reports the next command so a session can continue after context compaction. The workflow requires the stone CLI and OpenSCAD.
What it helps with
- generate an STL from a written part description
- make a printable model from a photo or drawing
- turn an image into a lithophane or relief
- check a model's geometry for 3D printing
Example prompts for the agent
- Create an STL keychain from this description.
- Make a cookie cutter from the outline in
photo.png. - Create a lithophane from
photo.png.
How to install smoothstone
1Skills CLI (Vercel)
npx skills add baney75/smoothstone --skill smoothstone -a claude-code2Manually: put the files in place
~/.claude/skills/skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill/
1Skills CLI (Vercel)
npx skills add baney75/smoothstone --skill smoothstone -a codex2Manually: put the files in place
.agents/skills/skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add baney75/smoothstone --skill smoothstone -a cursor2Manually: put the files in place
.cursor/skills/skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install baney75/smoothstone skill2Manually: put the files in place
.github/skills/skill/SKILL.md1Skills CLI (Vercel)
npx skills add baney75/smoothstone --skill smoothstone -a gemini-cli2Platform CLI
gemini skills install https://github.com/baney75/smoothstone --path skillManually: put the files in place
.devin/skills/skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about smoothstone
How do I install smoothstone in Claude Code?
Run npx skills add baney75/smoothstone --skill smoothstone -a claude-code. The skill file is at ~/.claude/skills/skill/SKILL.md.
What does smoothstone do?
It chooses and configures a parametric recipe to make an STL from text or an image. The stone CLI builds the part with OpenSCAD and checks its print-related geometry.
What does smoothstone need to run?
It uses the stone CLI and OpenSCAD. For an image, pass its path to a command such as stone new "<request>" --image photo.png.
Source text
SKILL.md · MIT
--- name: smoothstone description: Make 3D printable parts that look designed, from a text request or a picture, by choosing and setting tested parametric recipes with the stone CLI. Works for small local models (tier S), mid models (M) and large models (L), and keeps its state on disk so it survives context compaction. Use when someone asks for a printable part, an STL, a 3D model for a printer, or something to 3D print from a photo or drawing. --- # smoothstone stone turns a request into a print-ready STL. The model picks a recipe and sets its numbers; stone builds the part with OpenSCAD, checks that it prints (watertight, one piece, flat base, walls, overhangs, size), and keeps every step in a job folder. Every stone message ends with one line, NEXT: <command>, and `stone status` repeats it, so a model that loses its context goes on from where it was. ## Pick your tier and follow that card - Tier S, about 3B parameters and under: tiers/S.md - Tier M, about 4B to 30B: tiers/M.md - Tier L, frontier models: tiers/L.md Set the tier with STONE_TIER=S|M|L or `tier = "S"` in stone.toml. stone status prints the card's rules on every call, so they come back after a compaction. ## Pictures `stone new "<request>" --image photo.png` (or `stone image photo.png`) traces outlines for keychains, cookie cutters and signs, and makes a height map for lithophanes and reliefs. ## Start stone status
© baney75 · MIT · baney75/smoothstone