| name | articraft-viewer |
| description | Use when compiling Articraft records, opening the local viewer, inspecting articulated assets visually, or working on viewer API/web code. |
Articraft Viewer
Use this skill when the user asks to compile records, browse generated objects, inspect articulation, start the viewer, or work on viewer/api or viewer/web.
Compile Records
For one record:
uv run articraft compile <record_id>
Start The Viewer
Built viewer flow:
just viewer
Development viewer flow with API and Vite:
just viewer-dev
API only:
uv run uvicorn viewer.api.app:app --reload --host 127.0.0.1 --port 8765
Frontend-only commands:
npm --prefix viewer/web run dev
npm --prefix viewer/web run typecheck
npm --prefix viewer/web run lint
npm --prefix viewer/web run build
Visual QA
When inspecting an asset, verify:
- all primary parts are visible and connected
- articulations move the intended parts
- no major unintended overlap or floating geometry is visible
- link names and controls are semantic
- materials and colors match the object prompt
- history/lineage is preserved for forked records
If the viewer or frontend code changed, run the relevant frontend checks:
npm --prefix viewer/web run typecheck
npm --prefix viewer/web run lint
If API behavior changed, run focused viewer/API tests:
uv run --group dev pytest -q tests/viewer
