Guide · Agent skill
How to use the Pascal 3D Scene Builder agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The pascal-3d skill teaches an AI agent to work inside Pascal, an open-source 3D building editor, so it can create and change rooms, storeys, doors, windows, roofs and furniture as an editable scene. This guide explains what the skill does, how to install it from the ZIP or the Claude apps, how to ask for work in plain language, and what it needs. By the end you will know how to run a first local project and where the safety limits are.
Pascal 3D Scene Builderpascalorg/editor · MIT Download the skill Quick start
- 1Install the skill. Download the pascal-3d ZIP and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills in the Claude apps.
- 2Set up the local CLI. Install the Pascal CLI with npm install --global @pascal-app/cli and check that your Node.js version meets the stated minimum.
- 3Start the local editor. Run pascal editor --no-open to start Pascal without opening a browser window.
- 4Connect your host. Configure your MCP host with pascal mcp setup <host> so the agent can reach the Pascal tools.
- 5Ask for a model. Describe the room in metres and say it should stay local, for example a 4 m by 3 m room with one door.
- 6Check and get the link. Ask the agent to validate the scene, save it as a draft and return the exact editorUrl with any unresolved issues.
What the skill makes the agent do
Without this skill, an agent tends to guess at raw scene data. With it, the agent is directed to use Pascal's own semantic tools, such as create_story_shell, create_room, add_door, add_window, create_roof and furnish_room, and to treat Pascal as the scene authority.
After building, the agent validates the result with Pascal's tools, saves it when the store supports persistence, and returns the editorUrl that Pascal supplies rather than a link it invents.
- Create rooms, storeys, doors, windows, roofs and furniture as an editable 3D scene
- Inspect and edit an existing Pascal project with small, requested changes
- Validate the scene and return a verified Pascal editor link
- Keep local projects on your machine unless you say otherwise
Install the skill from the ZIP or the Claude apps
Download the ZIP for pascal-3d from this page. Unzip it into ~/.claude/skills/ to make it available to you across projects, or into a project's .claude/skills/ folder to limit it to that project.
If you use the Claude apps, open Settings, go to Capabilities, and upload the skill under Skills instead.
- Personal install: unzip into ~/.claude/skills/
- Project install: unzip into the project's .claude/skills/ folder
- Claude apps: Settings → Capabilities → Skills, then upload
Connect Pascal before you ask for a model
The skill needs an MCP-capable host such as Claude Code or another MCP client. For local work, the skill's local path uses the Pascal CLI, which needs Node.js 22.23.4+ on 22.x, 24.22.1+ on 24.x, or 26.12.1+. The local example installs the CLI with npm install --global @pascal-app/cli, starts the editor with pascal editor --no-open, and configures your host with pascal mcp setup <host>.
Local use does not need an account or API key. The hosted endpoint is the other option, and it can use an optional PASCAL_API_KEY.
- Local: no account or key needed; keep the project on this machine
- Hosted existing account: use an API key created in Pascal Settings by the owner of the project
- Hosted autonomous: only if you explicitly authorise a separate agent account
npm install --global @pascal-app/cliTrigger the skill with natural requests
You do not need special syntax. Ask for the outcome in plain language, and say where the work should live. The skill is meant to trigger on requests to work in Pascal, make a room or building model, inspect a Pascal project, make spatial edits, connect Pascal MCP, or return a verified Pascal editor link.
Be specific about dimensions and storage. Meter values help the agent place walls and doors accurately, and saying 'keep this on my Mac' tells it to stay on the local path.
- Keep this on my Mac. Create a 4 m by 3 m room with one door, validate it, and give me the local editor link.
- Add one window to the project in my Pascal workspace and leave everything else alone.
- Connect Pascal MCP and read the agent guide before changing anything.
Know the safety limits
The skill declares that it runs scripts and uses the network. It treats API keys and connector tokens as secrets and keeps them out of source files, prompts and command output. It does not publish, invite collaborators, spend credits or upload unrelated files unless you authorise that action.
Hosted projects are stored on Pascal's servers, so check which account owns the key before you use the hosted option for private work. An autonomous agent account is separate from your browser account, and its projects do not appear there automatically. The agent also cannot claim it has an email inbox or browser login.
- Local projects stay on your machine; the skill never moves them to hosted storage on its own
- Use a key created in Settings for work that must appear in your existing workspace
- Registering an agent account happens only when you explicitly ask for it
Tips for better results
Ask for one change at a time when editing an existing project. The skill is built to make the smallest requested change, re-read the target, and check that unrelated parts are unchanged.
If a request is about a furniture or clearance check and the furniture-fit skill is installed, the agent can use that focused workflow. Otherwise it does not assume that skill exists.
- Give dimensions in metres
- Name the storage choice: local, existing hosted account, or autonomous
- Run only one active agent client per local Pascal service, since concurrent clients share scene state
What people use it for
- Sketch a single room with a door and window for a layout check
- Build a storey with several rooms and a roof for a small house or flat
- Add one window to an existing hosted project without changing anything else
- Furnish a room with a bed or desk placed from the catalog
- Give a developer an agent that drives Pascal's MCP tools for an integration
Frequently asked questions
What is the pascal-3d agent skill?
It is an agent skill that lets an AI agent connect to Pascal, an open-source 3D building editor, and use its MCP tools to create, inspect, edit, validate and save editable 3D building scenes. It is published under the MIT licence.
Do I need an account or API key to use it?
Not for local use. The local Pascal CLI path needs no account or key. The hosted endpoint can use an optional PASCAL_API_KEY, and you only need that for projects in a hosted Pascal account.
What do I need to run it?
You need an MCP-capable host such as Claude Code or another MCP client, plus either the local Pascal CLI with Node.js 22.23.4+ (22.x), 24.22.1+ (24.x) or 26.12.1+, or access to the hosted Pascal MCP endpoint.
How do I install the skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps you can upload it under Settings → Capabilities → Skills.
Does the skill run scripts and use the network?
Yes. The skill is declared as running scripts and using the network. It keeps API keys out of files and output, and it will not publish, invite people, spend credits or upload unrelated files without your authorisation.
Is it safe to use for private projects?
Local projects stay on your machine. Hosted projects are stored on Pascal's servers, so check which account owns the key first. Autonomous agent accounts are separate from your own Pascal account.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use pascal-3d if you want an agent to build and check rooms and building layouts in Pascal, especially if you want to keep projects local or work in a Pascal integration. Skip it for simple 2D floor plans or image-only work, and for private projects you plan to put on the hosted service without first checking which account owns the key.
Download the skill