Agent Skills
› mattzh72/articraft
› articraft-viewer
articraft-viewer
GitHub用于编译 Articraft 记录、启动本地查看器、检查关节资产可视化，以及开发或调试查看器的 API 和前端代码。支持视觉 QA 验证模型连通性、材质及历史记录。
Trigger Scenarios
编译 Articraft 记录
启动本地查看器
检查关节资产的可视化效果
开发或调试查看器 API 或 Web 前端代码
Install
npx skills add mattzh72/articraft --skill articraft-viewer -g -y
SKILL.md
Frontmatter
{
"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
Version History
- 59eb5e0 Current 2026-07-05 19:35
