Design cat villas from scratch and turn fuzzy ideas into concrete layouts and OpenSCAD models.
If you want to design a cat villa but keep getting vague ideas, generic cabinet layouts, or models that look wrong once rendered, this repo is for you.
It helps you turn a fuzzy idea into a concrete plan you can actually review: first clarify the living needs, then generate a first-pass layout, then turn that layout into an OpenSCAD model with multi-angle previews before you commit to fabrication.
Cat Villa Studio packages that into reusable agent skills, OpenSCAD tooling, and concrete examples.
It contains:
- reusable design skills for requirement discovery and layout planning
- an OpenSCAD skill with validation, preview, and STL export helpers
- example
.scadmodels, rendered previews, and a sample cut list
This is a skill-and-examples repository, not a web app or npm package.
- Clarify the real requirements for a cat cabinet or cat villa.
- Turn the approved layout into a parameterized OpenSCAD model.
- Render the model from multiple angles and review it visually.
- Export STL or derive a cut list for fabrication planning.
Chinese workflow for requirement discovery, constraint mapping, first-pass layout design, and ASCII visualization.
Path: ./.agents/skills/cat-villa-designer
English version of the same workflow.
Path: ./.agents/skills/cat-villa-designer-en
OpenSCAD workflow for model creation, syntax validation, multi-angle preview rendering, parameter extraction, and STL export.
Path: ./.agents/skills/openscad
.
|-- .agents/skills/
| |-- cat-villa-designer/
| |-- cat-villa-designer-en/
| `-- openscad/
|-- examples/
| |-- cat_villa.scad
| |-- cat_villa_1000x600x1200.scad
| `-- renders/
|-- materials/
| `-- cat_villa_cut_list.csv
`-- skills-lock.json
Front view:
Isometric view:
Source model: ./examples/cat_villa_1000x600x1200.scad
Isometric view:
Front view:
Source model: ./examples/cat_villa.scad
Sample cut list: ./materials/cat_villa_cut_list.csv
Use cat-villa-designer or cat-villa-designer-en first.
The goal is to lock:
- outer dimensions
- cat count, size, mobility, and temperament
- required zones such as entry, litter, food, sleep, and lookout
- zones that must stay separated
- main circulation and litter circulation
Recommended prompt:
Use $cat-villa-designer-en to help me design a cat villa from scratch. Assume I have no design background. Ask questions to clarify my real needs, then give me a concrete first-pass design with an ASCII sketch.
Once the layout is stable, hand it to openscad.
Recommended prompt:
Use $openscad to turn this approved cat-villa design into a parameterized OpenSCAD model. Keep the key dimensions editable, generate preview images from multiple angles, and validate the result visually.
Do not stop at "the script ran." A model that compiles can still have bad openings, awkward climbing paths, or broken proportions.
Recommended prompt:
Use $openscad to validate this cat-villa model visually. Render front, back, left, right, top, and isometric previews, inspect the model from all angles, and tell me what looks wrong or risky before exporting anything.
./examples/cat_villa.scad: larger multi-level concept with separate functional zones./examples/cat_villa_1000x600x1200.scad: compact cabinet-sized example for a living room./examples/renders/: rendered previews for visual inspection./materials/cat_villa_cut_list.csv: sample fabrication-oriented cut list
The OpenSCAD skill expects OpenSCAD to be installed locally.
brew install openscadUse this repository if you want to:
- turn a rough cat-villa idea into something concrete and reviewable
- get better answers from an agent than "here is a random cabinet shape"
- keep example models, renders, and fabrication references in one place
- iterate on a design with visible feedback before committing to fabrication