
Open Architecture Standards (OAS) is a lightweight, LLM-friendly schema for describing architectural layouts, programs, rooms, walls, and openings using simple JSON in millimeter coordinates.
概览
Open Architecture Standards (OAS) is a lightweight, LLM-friendly schema for describing architectural layouts, programs, rooms, walls, and openings using simple JSON in millimeter coordinates. Designed for generative design, editing by prompts, and easy rendering in web tools. This is not an industry standard, but rather one approach to interacting with an LLM to generate more accurate 2D floor plans. The .claude/skills/ tree contains six skills, one per OAS module, that follow Anthropic's Agent Skills progressive-disclosure pattern. Each skill is a lean entry point (YAML frontmatter + a short body) that: - triggers automatically when Claude detects relevant authoring work, - contains the 3–7 most critical authoring rules for that OAS module, - links to the full module reference in docs/ for deep dives. Skills are auto-discovered when you open this repo in Claude Code — no install step.
README
以下为原文 README 节选,完整内容请查看原文。
Open Architecture Standards
Open Architecture Standards (OAS) is a lightweight, LLM-friendly schema for describing architectural layouts, programs, rooms, walls, and openings using simple JSON in millimeter coordinates. Designed for generative design, editing by prompts, and easy rendering in web tools.
Important Note:
This is not an industry standard, but rather one approach to interacting with an LLM to generate more accurate 2D floor plans.
Repository contents
This repo combines three things:
| Folder | Purpose |
|---|---|
docs/ |
The OAS specification — Core, Geometry, Program, Layout, Render, Extensions. Built as a static site with MkDocs. |
.claude/skills/ |
Six progressive-disclosure Claude Code skills that help an LLM author and edit OAS JSON without ingesting the whole spec. |
svg-viewer/ |
A dependency-free, single-page SVG viewer for OAS floor-plan JSON. Open index.html in any browser. |
Skills for Claude Code
The .claude/skills/ tree contains six skills, one per OAS module, that follow Anthropic’s Agent Skills progressive-disclosure pattern. Each skill is a lean entry point (YAML frontmatter + a short body) that:
- triggers automatically when Claude detects relevant authoring work,
- contains the 3–7 most critical authoring rules for that OAS module,
- links to the full module reference in
docs/for deep dives.
| Skill | Trigger |
|---|---|
oas-core |
Authoring rooms, walls, openings, slabs, roofs, furniture, railings |
oas-geometry |
Points, polygons, arcs, units, coordinate conventions |
oas-program |
Design intent: area targets, adjacency, constraints |
oas-layout |
Fully resolved multi-level geometry, connections |
oas-render |
SVG / Canvas / WebGL rendering rules |
oas-extensions |
Machinery, materials, Autodesk metadata, MEP, site |
Skills are auto-discovered when you open this repo in Claude Code — no install step. Describe a plan in natural language (“a 70 m² 2-bedroom apartment with the living areas facing south”) and Claude routes through the relevant skills to produce schema-correct JSON you can drop into the viewer.
SVG Viewer
svg-viewer/ is a zero-dependency, no-build viewer for OAS floor-plan JSON. Open svg-viewer/index.html in any modern browser, click Upload JSON, and load a plan. See svg-viewer/README.md for controls and the bundled example.
The viewer is read-only by design — pair it with the skills above to author or edit plans.
Documentation
推荐工具
换一个关键词,或者移除筛选条件。
安装
npx skillfish add autodesk-platform-services/open-architecture-standards-2d-floor-plans