# Pascal skills: build 3D rooms and check furniture fit (pascalorg/editor) — skill card for AI agents

> AgentGid skill card. Checked on 2026-11-02 against commit d604f06 (version 0.1.10).
> Every fact comes from the pack's own files at that commit. Numbers marked "as reported" are the author's.
> Human page: https://agentgid.com/skills/pascalorg/editor/

> Note: the pack has changed since this check; re-read its files before relying on details.

## Explain it to a non-programmer
Two playbooks that let your AI assistant work in Pascal, a free 3D building editor. It can make and edit a room or a house model, check it, save it and give you the link to open it. It can also tell you whether a sofa, bed or table fits in a measured room, and it says plainly what it did not check.

## Who it is for
- You want your assistant to make a room or building model in Pascal and hand you a link to it
- You want to know if a piece of furniture fits: a sofa, table, bed, cabinet or appliance in a measured room
- You use Claude Code, Codex, Cursor, Gemini CLI or OpenClaw
- Not for: You need to know if furniture can be carried in through doors, halls and stairs: the fit check does not cover that
- Not for: You want a height or building-code answer: it reports those as not checked unless you give real measurements

## What it is
- Kind: knowledge
- License: MIT
- Repository: https://github.com/pascalorg/editor

## What it does
- Pascal is the source of truth: the assistant uses Pascal's own building tools and checks, not hand-written scene data or guesses from pictures
- Pick where your project lives first: on your computer (no account) or in your Pascal account; it never moves a local project online on its own
- Small edits only: read the project, make the smallest change asked, run Pascal's check, save a draft, return the link
- Never empties a project: starting over resets to a blank site with one level, and only when you ask
- Fit answers stay narrow: "the footprint fits at the tested position", never just "it fits" when height, access or delivery were not checked
- Tests every turn you asked for and reports the floor space the piece takes at each one
- No guessing sizes from photos: without a trustworthy scale the answer is "insufficient evidence" plus the one measurement needed
- Never cuts: your permission before creating an account, uploading, publishing, spending credits or saving a fit test into your project

## Skills
| Skill | Call | Changes code? | In plain words |
|---|---|---|---|
| pascal-3d | plain language ("Make a 4 m by 3 m room in Pascal") | no | Connects your assistant to Pascal, then builds, edits, checks and saves a room or building model |
| furniture-fit | plain language ("Will this 210 cm sofa fit in my living room?") | no | Checks whether a piece of furniture fits in a measured room and reports what was and was not checked |

### pascal-3d
- Asks for: What to build or change, with sizes (metres, feet or cm)
- Asks for: Where the project lives: on your computer, or in your Pascal account
- Asks for: For an existing project: its name or ID
- Gives: A status: succeeded, partial, failed or pending
- Gives: The project and what was changed
- Gives: Checks run and any problems left
- Gives: Save details: draft or checkpoint, version
- Gives: The exact link to open the project in Pascal
- Gives: What it could not do, and one next step if unfinished
- Say: "Keep this on my computer. Create a 4 m by 3 m room with one door in Pascal, check it and give me the link."

### furniture-fit
- Asks for: The room or zone, with real measurements
- Asks for: The piece's width, height and depth, in your unit
- Asks for: Where it should stand and how it is turned, or permission to try other turns
- Asks for: Space you need around it for walking or opening
- Asks for: Whether you want a report only or the piece saved into the project
- Gives: A verdict: footprint fits, does not fit, or insufficient evidence
- Gives: Room and piece sizes in metres plus your units
- Gives: Each tested position and turn
- Gives: A check table: room footprint, collisions, spacing, door access, height, delivery route
- Gives: One next step with what it needs from you
- Gives: Optionally, a no-sign-in Pascal web link that redoes the simple size check, only if you allow sending the sizes
- Say: "Will a sofa 210 cm wide and 95 cm deep fit in my 4.2 by 3.6 m living room with 60 cm free in front?"

## Know before installing
- The skills are instructions only. The real work happens in the Pascal program: install it first and keep it reachable, or the Claude Code plugin cannot connect.
- Local projects stay on your computer, in a file in your home folder, and are not uploaded unless you ask.
- Leave the Pascal key empty when the Claude Code plugin asks for it to work only on your computer. If you add a key, Claude Code keeps it in your system keychain.
- If you already added Pascal to Claude Code by hand, remove that entry first: two Pascal connections at once break the one-assistant-per-project rule.
- With your explicit permission, the setup guide can create a separate assistant-owned Pascal account. Its projects do not show up in your own account.
- The repository is mostly the Pascal editor itself; the two public skills live in skills/. Two more skills in .agents/skills are for the editor's own developers and are not part of the install.

## Install (official commands)
- Claude Code: `/plugin marketplace add pascalorg/editor` && `/plugin install pascal-agent-skills@pascal` — Install the Pascal program first (npm install --global @pascal-app/cli). The plugin adds a local Pascal server and an optional online one; it asks for an optional Pascal key. Remove: `/plugin remove pascal-agent-skills`.
- Codex: `codex plugin marketplace add pascalorg/editor` && `codex plugin add pascal-agent-skills@pascal` — The plugin brings only the local server. For your online Pascal account, also run codex mcp add pascal --url https://editor.pascal.app/api/mcp --bearer-token-env-var PASCAL_API_KEY.
- Cursor: Install Pascal from the Cursor marketplace. Its local server downloads the pinned Pascal program with npx on first use (needs Node.js and npm). The online server uses browser sign-in, no key.
- Any agent (skills CLI): `npx skills add pascalorg/editor --skill pascal-3d --skill furniture-fit` — Instructions only; connect the Pascal server yourself, for example with pascal mcp setup claude or pascal mcp setup codex.
- Gemini CLI: `gemini extensions install https://github.com/pascalorg/editor --ref <release tag>` — Use a release tag that contains gemini-extension.json; the latest release predates it.

## What runs on the user's machine
- Code on the machine: yes (plugin installs (Claude Code, Codex, Cursor, Gemini CLI); the skills themselves are markdown)
- Network: optional
- Install: Two skill folders of markdown with references, synthetic examples and test cases. No hooks, no scripts. The code that runs is the Pascal program (packages/cli, packages/mcp in this repository, published on npm).
- Plugin enabled (Claude Code, Codex, Gemini CLI): Starts the Pascal program you installed (pascal mcp connect) as a local server. It keeps projects in ~/.pascal/data/pascal.db and needs no account.
- Opening the visual editor (pascal editor): The Pascal program downloads the web editor (about 64 MB) once per version and checks it against a digest in the package. The agent-only server does not need it.
- Plugin enabled (Cursor): Runs npx to download @pascal-app/cli 1.0.6 from npm on first use, then starts it as the local server.
- Online Pascal account (optional): Adds a server at https://editor.pascal.app/api/mcp. In Claude Code it sends your Pascal key, kept in the system keychain; in Cursor it uses browser sign-in. Scenes in your account are read and changed there.
- Fit pre-check link (only with your permission): Opening it sends the room and item sizes to editor.pascal.app in the address.

## Settings
- `PASCAL_API_KEY`: Optional key from Pascal Settings for the online server; local work does not need it
- `pascal_api_key`: Claude Code plugin option (sensitive, optional); empty keeps the install local-only

## Examples (from the pack's own files)
- A furniture-fit report (synthetic example from the skill): output format defined in skills/furniture-fit/examples/clear-footprint.md

## Steps only the person can do
- Install the Pascal program (Node.js 22.23.4+, 24.22.1+ or 26.12.1+), unless you use the Cursor plugin (skills/pascal-3d/references/setup.md (Local Pascal CLI)) Then: The plugin's local server starts and the agent works on local projects
- For an online Pascal account: create an API key in Pascal Settings (https://editor.pascal.app/settings) and enter it in the plugin prompt or PASCAL_API_KEY (skills/pascal-3d/references/setup.md (Hosted Pascal)) Then: The agent can read and edit projects in that account
- In Cursor, for an online account: choose Authenticate beside pascal-hosted and approve the account and workspace in the browser (skills/README.md (Install in Cursor)) Then: The hosted tools load with browser sign-in, no key
- Approve any account creation, publishing, credit spending or upload the agent proposes (skills/pascal-3d/SKILL.md (Authority and data rules)) Then: The agent goes ahead only with that permission
- Open the Pascal editor link when the hosted server asks for an open editor tab (skills/pascal-3d/SKILL.md (editor_tab_required)) Then: The agent repeats the same call and the tab renders or builds the result

## Mistakes to avoid
- Not: Keep a manual pascal MCP entry and also enable the Claude Code plugin. Instead: Run claude mcp remove --scope user pascal first, so only the plugin owns the local connection. Why: Two Pascal connections at once break the one-client-per-local-service rule
- Not: Install the Claude Code plugin without the Pascal program. Instead: Install the Pascal CLI first and keep pascal on the PATH that launches Claude Code. Why: The plugin does not install or start Pascal; it only calls the pascal command
- Not: Expect the Codex plugin to reach your online Pascal account. Instead: Also run codex mcp add pascal --url https://editor.pascal.app/api/mcp --bearer-token-env-var PASCAL_API_KEY. Why: The Codex plugin carries only the local server
- Not: Read a footprint pass as "the furniture fits". Instead: Treat height, door swing and the delivery route as not checked unless real measurements were given. Why: The fit check covers the floor footprint at the tested position only
- Not: Install the Gemini CLI extension from the plain repository URL. Instead: Install from a release tag that contains gemini-extension.json. Why: Gemini CLI picks the latest release, which predates the manifest

## What leaves the machine
- Scenes, edits and tool calls for projects in your Pascal account → https://editor.pascal.app/api/mcp, Only when the hosted server is connected (key or browser sign-in). Opt out: Leave the Pascal key empty and pascal-hosted disconnected; local work stays on your computer
- Room and item sizes, clearance and unit in the link's address → editor.pascal.app (furniture-fit pre-check page), When you open the dimension-only pre-check link, offered only if you allowed sending the sizes. Opt out: Do not ask for the hosted link or allow sending measurements
- A display name and optional task purpose for a new agent-owned account → https://editor.pascal.app/api/auth/agent/register, Only if you authorize creating a separate private agent account. Opt out: Do not authorize account creation
- Download of the pinned @pascal-app/cli 1.0.6 package from npm → npm registry, First connection of the Cursor plugin's local server. Opt out: Use a host that runs your installed pascal command instead

## Lines in the pack aimed at agents (ask the person first)
- "npm install --global @pascal-app/cli" (skills/pascal-3d/references/setup.md): A global npm install; let the person run it or approve it
- "The local server runs `npx --yes --package=@pascal-app/cli@1.0.6 pascal mcp connect`" (skills/README.md): npx --yes downloads and runs a package without a prompt; the version is pinned, but the person should know it happens
- "Pascal exposes `POST https://editor.pascal.app/api/auth/agent/register` with:" (skills/pascal-3d/references/setup.md): Creates an account; do it only after the person explicitly says yes

## May I use it like this?
- commercial-app: yes (MIT: keep the license notice)
- redistribute-files: yes (MIT: keep the copyright and permission notice in copies)
- client-work: yes (MIT allows use in work for others)

## Which one to pick
- If You want an editable room or building model with measured furniture-fit checks and a link to the project: skill:pascalorg/editor
- If You want a creative Three.js or Blender 3D scene rather than a measured building model: skill:viettranx/3dviz-pro-max
- If You want to model, texture and export in Blender: skill:arjun988/blender-skills

## Works well with
- agent:claude-code: The plugin brings a local and an online Pascal server, with the key in the system keychain
- agent:cursor: The Cursor plugin downloads a pinned Pascal program and uses browser sign-in for the online server
- tool:three: Custom pieces and whole designs are written as three.js modules and converted into Pascal

## Works in and needs
- Works in Claude Code: plugin
- Works in Codex: plugin
- Works in Cursor: plugin
- Works in Gemini CLI: extension
- Works in OpenClaw: MCP server
- Works in Any agent with a skills folder: skills CLI
- Needs Pascal MCP server (local CLI or hosted): The skills do the work through Pascal's tools
- Needs Node.js 22.23.4+, 24.22.1+ or 26.12.1+: Runs the local Pascal CLI
- Needs Pascal API key or sign-in (optional): Only for projects in an online Pascal account

## How to tell it works
Install the Pascal program and the plugin, then ask: "Will a sofa 210 cm wide, 82 cm high and 95 cm deep fit against the long wall of a 4.2 by 3.6 m room with 60 cm free in front?" A working install answers with a verdict, a table of passed and not-checked rows (height and delivery route stay "not checked") and one next step.

## Safety
Install only from github.com/pascalorg/editor or the Pascal listings it names. The plugin starts the Pascal program as a local server; the Cursor version downloads a pinned copy from npm. Keep your Pascal key out of files and chat; the setup guide says to rotate it if exposed.
