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

woc-image-to-glb

GitHub

将参考图像转换为World of ClaudeCraft项目的GLB资产。涵盖从图像输入、模型生成、导出优化到测试验证的完整流水线，用于创建或更新游戏内3D道具和建筑资产。

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

Trigger Scenarios

需要基于参考图创建新的3D资产重建或重新导出已有的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.