القائمة
Convert gathering-enemy image(s) into low-poly textured GLB models via the Tripo3D P-Series pipeline, then wire them into the monster card.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Provide game-design consultation, analysis, and creative direction for dean-stack. Use when designing or balancing mechanics, progression, engagement, retention, social systems, learning curves, child-friendly experiences, ethical incentives, or fresh gameplay concepts within the repository's iPad, static-hosting, Storybook-first, Zod-first, and IDB-first constraints.
Codebase intelligence for JavaScript and TypeScript. Free static layer finds unused code (files, exports, types, dependencies), code duplication, circular dependencies, complexity hotspots, architecture boundary violations, and feature flag patterns. Runtime coverage merges production execution data into the same health report for hot-path review, cold-path deletion confidence, and stale-flag evidence - a single local capture is free, while continuous/cloud runtime monitoring is paid. 90 framework plugins, zero configuration, sub-second static analysis. Use when asked to analyze code health, find unused code, detect duplicates, check circular dependencies, audit complexity, check architecture boundaries, detect feature flags, clean up the codebase, auto-fix issues, merge runtime coverage, or run fallow.
Use when asked to propagate a dean-stack monorepo change through the five-phase pass: P1 apps/web, P2 generator template, P3 regenerated test-project plus gate, P4 docs/owning skill, and P5 cross-skill audit. Also use when the user asks for the old /five-phase-pass command or passes `--baseline` to run only the cumulative skill audit.
Jake Archibald's `idb` v8 wrapper for IndexedDB in dean-stack — owns the IDB primitives (`openDB`, typed IDBPDatabase schemas, transactions, indexes, cursors), schema-versioned `upgrade` migrations, the root `idbHydrationPromise` consumed by `use()` at the app shell, and the `BroadcastChannel` re-hydration broadcast that keeps tabs/iframes in sync. Triggers on: atomWithIDB storage, BroadcastChannel sync, idb, IDBPDatabase, idb hydration, idb migration, idb migration test, IndexedDB, object store, openDB, upgrade callback.
The shared conventions every Playwright spec in dean-stack obeys — the load-bearing ASK-FIRST rule (Pillar 4), role-first selector strategy, fixture patterns (fresh IDB, seeded IDB, offline, throttled), reduced-motion forced on, and the `playwright.config.ts` shape. Triggers on: playwright fixture, playwright selector, role selector, getByRole, test-id, fresh idb fixture, reduced motion playwright, ask first test.
Playwright tests pointed at Storybook story URLs in dean-stack — mount a story ID through `iframe.html` for clean in-iframe rendering, exercise the play function, and assert on visible state, ARIA, or real IDB contents. Triggers on: story test, playwright story, storybook url test, story-level test, mount story.
| name | source-command-tripo-enemy-model |
| description | Convert gathering-enemy image(s) into low-poly textured GLB models via the Tripo3D P-Series pipeline, then wire them into the monster card. |
Use this skill when the user asks to run the migrated source command tripo-enemy-model.
Turn apps/web/public/enemies/<id>.webp into a low-poly textured GLB at
apps/web/public/enemy-models/<id>.glb using Tripo3D's P-Series image-to-model
flow, then have the monster card render it in place of the 2D portrait.
Arguments: one or more enemy ids (e.g. hadal-glow-polyp-echo). With none,
list the unconverted enemies from packages/schemas/src/data/gathering-enemies.ts
and ask which to do. Do one enemy, screenshot it in-game, and stop for review
before batch-converting the rest — generation costs credits.
TRIPO3D_API_KEY is in the gitignored .env.local (see AGENTS.md "API keys & local secrets"). Bun auto-loads it.curl -s -H "Authorization: Bearer $TRIPO3D_API_KEY" https://openapi.tripo3d.ai/v3/account/balance → data.balance must be > 0. Generation fails with code 2010 when balance is 0 — if so, tell the user to add credits at https://platform.tripo3d.ai and stop; everything else is already wired.bun run tripo:enemy-model <enemy-id> [--face-limit 4000] [--texture-quality detailed]
scripts/tripo-enemy-model.ts runs the whole pipeline (each step validated against the live v3 API, base https://openapi.tripo3d.ai/v3, Authorization: Bearer <key>):
POST /files (multipart file) → {data:{file_token}}. Localhost images aren't publicly reachable, so the image must be uploaded for a file_token (don't pass a localhost URL).POST /generation/image-to-model with {input: "<file_token>", model: "P1-20260311", face_limit, texture: true, pbr: true} → {data:{task_id}}. P1-20260311 is the low-poly model; face_limit 50–20000 (default 4000 — clean low-poly for a small card portrait).POST /models/texture with {input: "<task_id_from_step_2>", model: "v3.0-20250812", texture_quality, pbr: true} → a new task_id. The script does this as a separate step (the guide's "add texturing to the workflow"); if Tripo rejects texturing a P-series source it falls back to the image-to-model texture, so you always get a textured GLB.GET /tasks/{task_id} → {data:{status, progress, output:{model_url|pbr_model}}}; status goes queued/running/success/failed. Each step takes ~1–2 min.output.pbr_model ?? output.model_url → apps/web/public/enemy-models/<id>.glb.The monster card already swaps the 2D image for a 3D viewer when the enemy id is registered. After generating a model for a NEW enemy, add it to the registry:
// apps/web/app/components/alchemist-guild-board/gathering-enemy-models.ts
const ENEMY_MODEL_PATHS: Record<string, string> = {
"hadal-glow-polyp-echo": "enemy-models/hadal-glow-polyp-echo.glb",
// add the new <id>: "enemy-models/<id>.glb",
};
The viewer is GlbMonsterViewer (Three.js, WebGPU-preferred with WebGL2 fallback,
moody bioluminescent lighting) in apps/web/app/canvas/use-glb-monster-viewer.ts.
Components/AlchemistGuildBoard/GlbMonsterViewer renders the GLB in isolation.gathering.monster.id = "monster:<id>" and confirm the card shows the lit 3D model.bun run check:runtime (loads the running app, fails on a "Something broke" boundary or runtime ZodError) and bun run check:fast.