Agent Skills › levy-street/world-of-claudecraft › woc-image-to-glb

woc-image-to-glb

GitHub

将参考图像转换为World of ClaudeCraft项目的GLB资产。通过img2threejs生成模型，并执行确定性的导出、优化、指纹校验及测试流程，用于创建或重建游戏内的3D资产。

.agents/skills/woc-image-to-glb/SKILL.md levy-street/world-of-claudecraft

Trigger Scenarios

从概念图或参考图像创建3D资产替换或重新构建现有的世界资产重新导出或更新资产的指纹和版本

Install

npx skills add levy-street/world-of-claudecraft --skill woc-image-to-glb -g -y

More Options

Non-standard path

npx skills add https://github.com/levy-street/world-of-claudecraft/tree/main/.agents/skills/woc-image-to-glb -g -y

Use without installing

npx skills use levy-street/world-of-claudecraft@woc-image-to-glb

指定 Agent (Claude Code)

npx skills add levy-street/world-of-claudecraft --skill woc-image-to-glb -a claude-code -g -y

安装 repo 全部 skill

npx skills add levy-street/world-of-claudecraft --all -g -y

预览 repo 内 skill

npx skills add levy-street/world-of-claudecraft --list

SKILL.md

Frontmatter

{
    "name": "woc-image-to-glb",
    "description": "Turn a reference image into a shipping World of ClaudeCraft GLB through the img2threejs intake gates and the repo's deterministic export, optimize, fingerprint, and test pipeline. Use when asked to create, replace, rebuild, re-export, or re-pin a world asset (prop, furniture, building, landmark, stall, service object) from a concept or reference image."
}

World of ClaudeCraft image-to-GLB

This is the Codex-side pointer for the shared asset pipeline. The canonical operating procedure is the Claude skill at .claude/skills/image-to-glb/SKILL.md; the deep runbook is docs/image-to-glb-asset-workflow.md. Follow those two documents exactly; do not improvise an alternative pipeline.

Quick orientation:

Read scripts/assets/CLAUDE.md, then .claude/skills/image-to-glb/SKILL.md in full.
The img2threejs skill (installed at ~/.codex/skills/img2threejs) drives reference admission, detail inventory, sculpt specs, and staged visual review. It is an authoring aid, never a build dependency.
The committed chain is: reference (with provenance and a CREDITS.md row) -> budgets -> sculpt spec -> purpose-built factory (scripts/assets/<asset>/model.js, vertex colors, material buckets, sockets) -> deterministic exporter -> build_assets.mjs optimizer -> public/models/props/ -> media manifest -> parsed-GLB contract test -> render adapter module -> matched desktop/mobile in-game evidence -> npm run gate.
Respect the source-fingerprint contract: any change to a fingerprinted input (including package-lock.json) means re-exporting the affected asset families and re-pinning the sha256 and fingerprint literals in tests, docs, and capture evidence JSONs.