claude-code-arcane 2.5.0 → 2.6.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [2.6.1](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.6.0...v2.6.1) (2026-08-18)
+
+
+### Bug Fixes
+
+* **update-check:** compare like with like, and check the CLI version too ([fe734ce](https://github.com/SebastianLuser/claude-code-arcane/commit/fe734ce9bff14ec37e22d75fc38e64ba7b17f098))
+
+# [2.6.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.5.0...v2.6.0) (2026-08-18)
+
+
+### Features
+
+* **profiles:** add meshy profile for 3D asset production ([c550bf2](https://github.com/SebastianLuser/claude-code-arcane/commit/c550bf24aff143ce0284457b4c70c9b356935069))
+
 # [2.5.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.4.0...v2.5.0) (2026-08-13)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # Claude Code Arcane
 
-> **427 skills, 109 agents, 17 hooks and 28 rules for Claude Code — selective deploy by profile.**
+> **431 skills, 109 agents, 17 hooks and 29 rules for Claude Code — selective deploy by profile.**
 
 A configuration harness installable via `npx`. Pick a **profile** that matches your stack and only the relevant tools get installed into your project's `.claude/` directory.
 
@@ -193,6 +193,7 @@ All profiles combine freely with `+` — there is no required "base". Grouped by
 |---------|-------|--------|--------|
 | `unity-dev` | Unity programmer — C#, architecture, performance, builds | 25 | game |
 | `unity-design` | Game designer — GDDs, balance, art bible, playtesting | 17 | game |
+| `meshy` | 3D asset production with Meshy AI — credit-gated generation, single master + cheap derivatives, printability | 5 | — |
 | `unreal-dev` | Unreal Engine 5 programmer — C++, Blueprints, GAS, replication, rendering, packaging | 49 | game |
 | `visual-novel` | Visual novel developer — Ren'Py, narrative, branching | 17 | visualnovel, game |
 | `audio` | Game audio — direction, composition, sound design, middleware, VO, QA | 13 | audio |
@@ -430,11 +431,11 @@ claude-code-arcane/
 │   ├── manifest.ts            # Read/write arcane-manifest.json
 │   ├── types.ts               # TypeScript interfaces
 │   └── utils.ts               # Cross-platform helpers
-├── skills/                    # 427 skills (flat, one dir per skill)
+├── skills/                    # 431 skills (flat, one dir per skill)
 ├── profiles/                  # 38 profiles (YAML)
 ├── agents/                    # 17 dirs, 109 agents (Markdown)
 ├── hooks/                     # 17 lifecycle hooks (Bash)
-├── rules/                     # 28 rules (Markdown)
+├── rules/                     # 29 rules (Markdown)
 ├── templates/                 # Gamedev templates
 ├── docs/                      # Documentation
 └── skills-selftest/           # QA framework

package/agents/game/art-director.md

@@ -5,7 +5,7 @@ tools: Read, Glob, Grep, Write, Edit, WebSearch
 model: sonnet
 maxTurns: 20
 memory: project
-skills: [art-bible, asset-spec, asset-audit]
+skills: [art-bible, asset-spec, asset-audit, meshy-setup, meshy-generate, meshy-derive, meshy-print]
 ---
 
 Sos el **Art Director**. Owner de la identidad visual — que el juego se vea coherente y memorable.

package/dist/cli.js

@@ -2722,6 +2722,25 @@ var CHECK_INTERVAL_MS = 4 * 60 * 60 * 1e3;
 var GITHUB_OWNER2 = "SebastianLuser";
 var GITHUB_REPO2 = "Claude-Code-Arcane";
 var GITHUB_BRANCH2 = "main";
+var PACKAGE_NAME2 = "claude-code-arcane";
+var SHA_PATTERN = /^[0-9a-f]{7,40}$/i;
+function compareSemver(a, b) {
+  const release = (v) => v.trim().replace(/^v/, "").split(/[-+]/)[0];
+  const parts = (v) => release(v).split(".").map((n) => Number.parseInt(n, 10) || 0);
+  const [aMajor = 0, aMinor = 0, aPatch = 0] = parts(a);
+  const [bMajor = 0, bMinor = 0, bPatch = 0] = parts(b);
+  if (aMajor !== bMajor) return aMajor - bMajor;
+  if (aMinor !== bMinor) return aMinor - bMinor;
+  if (aPatch !== bPatch) return aPatch - bPatch;
+  const aPre = /-/.test(a.trim());
+  const bPre = /-/.test(b.trim());
+  if (aPre !== bPre) return aPre ? -1 : 1;
+  return 0;
+}
+function isContentUpdateAvailable(localVersion, remoteSha) {
+  if (!SHA_PATTERN.test(localVersion)) return false;
+  return !remoteSha.startsWith(localVersion) && !localVersion.startsWith(remoteSha);
+}
 async function checkForUpdates(opts = {}) {
   try {
     const cached = readCachedCheck();
@@ -2729,40 +2748,62 @@ async function checkForUpdates(opts = {}) {
       const age = Date.now() - new Date(cached.checked_at).getTime();
       if (age < CHECK_INTERVAL_MS) {
         if (cached.update_available && !opts.quiet) {
-          printUpdateNotice(cached.local_version, cached.remote_sha);
+          printUpdateNotice(cached);
         }
         return cached.update_available;
       }
     }
     const manifest = readManifest(process.cwd());
     const localVersion = manifest?.source_version ?? manifest?.arcane_version ?? "unknown";
-    const remoteSha = await getLatestCommitSha();
-    if (!remoteSha) return false;
-    const shortSha = remoteSha.substring(0, 12);
-    const updateAvailable = localVersion !== shortSha && !remoteSha.startsWith(localVersion);
+    const cliVersion = getPackageVersion();
+    const [remoteSha, latestCli] = await Promise.all([
+      getLatestCommitSha(),
+      getLatestNpmVersion()
+    ]);
+    const shortSha = remoteSha ? remoteSha.substring(0, 12) : cached?.remote_sha ?? "";
+    const contentUpdate = shortSha !== "" && isContentUpdateAvailable(localVersion, shortSha);
+    const cliUpdate = latestCli !== null && compareSemver(latestCli, cliVersion) > 0;
+    if (!remoteSha && latestCli === null) return false;
     const result = {
       checked_at: (/* @__PURE__ */ new Date()).toISOString(),
       local_version: localVersion,
       remote_sha: shortSha,
-      update_available: updateAvailable
+      update_available: contentUpdate || cliUpdate,
+      content_update_available: contentUpdate,
+      cli_version: cliVersion,
+      latest_cli_version: latestCli ?? void 0,
+      cli_update_available: cliUpdate
     };
     writeCachedCheck(result);
-    if (updateAvailable && !opts.quiet) {
-      printUpdateNotice(localVersion, shortSha);
+    if (result.update_available && !opts.quiet) {
+      printUpdateNotice(result);
     }
-    return updateAvailable;
+    return result.update_available;
   } catch {
     return false;
   }
 }
-function printUpdateNotice(localVersion, remoteSha) {
-  console.log(
-    chalk11.yellow(`
-  Arcane update available: ${localVersion} \u2192 ${remoteSha}`)
-  );
-  console.log(
-    chalk11.dim("  Run: arcane update (--dry-run to preview)\n")
-  );
+function printUpdateNotice(result) {
+  if (result.cli_update_available) {
+    console.log(
+      chalk11.yellow(
+        `
+  Arcane CLI update: ${result.cli_version} \u2192 ${result.latest_cli_version}`
+      )
+    );
+    const how = isGloballyInstalled() ? `  Run: npm install -g ${PACKAGE_NAME2}@latest` : `  You are on an older CLI. Latest: ${PACKAGE_NAME2}@${result.latest_cli_version}`;
+    console.log(chalk11.dim(how));
+  }
+  if (result.content_update_available ?? true) {
+    console.log(
+      chalk11.yellow(
+        `
+  Arcane content update: ${result.local_version} \u2192 ${result.remote_sha}`
+      )
+    );
+    console.log(chalk11.dim("  Run: arcane update (--dry-run to preview)"));
+  }
+  console.log("");
 }
 async function getLatestCommitSha() {
   try {
@@ -2783,6 +2824,22 @@ async function getLatestCommitSha() {
     return null;
   }
 }
+async function getLatestNpmVersion() {
+  try {
+    const response = await fetch(
+      `https://registry.npmjs.org/${PACKAGE_NAME2}/latest`,
+      {
+        headers: { "User-Agent": "arcane-cli", Accept: "application/json" },
+        signal: AbortSignal.timeout(5e3)
+      }
+    );
+    if (!response.ok) return null;
+    const data = await response.json();
+    return typeof data.version === "string" ? data.version : null;
+  } catch {
+    return null;
+  }
+}
 function readCachedCheck() {
   try {
     if (!fs15.existsSync(CHECK_FILE)) return null;

package/docs/SKILLS-CATALOG.md

@@ -1,8 +1,8 @@
 # Skills Catalog — Claude Code Arcane
 
-Los 427 skills disponibles para proyectos consumidores, organizados por division.
+Los 431 skills disponibles para proyectos consumidores, organizados por division.
 
-La tabla cubre 385: hay 42 skills instalables que todavia no estan catalogados aca. Un test de CI (`src/__tests__/doc-counts.test.ts`) verifica que estos numeros coincidan con el filesystem y que el header de cada seccion coincida con sus filas.
+La tabla cubre 389: hay 42 skills instalables que todavia no estan catalogados aca. Un test de CI (`src/__tests__/doc-counts.test.ts`) verifica que estos numeros coincidan con el filesystem y que el header de cada seccion coincida con sus filas.
 
 ## Como ejecutar un skill
 
@@ -72,7 +72,7 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 
 ---
 
-## Gamedev (21 skills)
+## Gamedev (25 skills)
 
 | Skill | Descripcion | Uso |
 |-------|-------------|-----|
@@ -85,6 +85,10 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 | `/doc-gdd` | Genera Game Design Document completo | `[game-name]` |
 | `/doc-pas` | Documentacion PAS (Problem-Analysis-Solution) | `[problem o decision title]` |
 | `/install-mcp` | Conecta Claude con el MCP del engine: Unity (package UPM) o Unreal (plugins del engine) | `[unity\|unreal] [--secondary] [path]` |
+| `/meshy-derive` | Deriva targets (FBX, GLB web, blend, STL) desde el master GLB | `<slug> [game\|web\|edit\|print\|all]` |
+| `/meshy-generate` | Genera asset 3D con Meshy: preview -> refine, con gate de creditos | `<slug> [--from-image <path>] [--spec <path>]` |
+| `/meshy-print` | Prepara asset para impresion 3D: analyze -> repair -> resize -> STL/3MF | `<slug> [--height-mm <n>] [--multicolor]` |
+| `/meshy-setup` | Conecta Claude Code con Meshy AI: API key, MCP oficial, estructura de assets | `[--verify]` |
 | `/map-systems` | Descompone concepto en sistemas, mapea dependencias | `[next \| system-name] [--review]` |
 | `/playtest-report` | Genera o analiza reporte de playtest | `[new\|analyze path] [--review]` |
 | `/scaffold-unity` | Scaffoldea proyecto Unity estilo Project_T | `[project-name]` |

package/docs/USER-GUIDE.md

@@ -2,7 +2,7 @@
 
 ## What is Arcane?
 
-Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It provides a curated library of **427 skills**, **109 agents**, **17 hooks**, and **28 rules** that you selectively deploy into any project. Instead of shipping everything to every project (wasting tokens and degrading performance), you pick a **profile** that matches your stack and only the relevant tools get installed.
+Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It provides a curated library of **431 skills**, **109 agents**, **17 hooks**, and **29 rules** that you selectively deploy into any project. Instead of shipping everything to every project (wasting tokens and degrading performance), you pick a **profile** that matches your stack and only the relevant tools get installed.
 
 ## Table of Contents
 
@@ -206,7 +206,7 @@ All profiles are equal — pick any combination that fits your work. They are gr
 | **Backend** | `backend-ts`, `backend-go`, `backend-dotnet`, `backend-nestjs`, `backend-nextjs` |
 | **Frontend & Design** | `frontend`, `design` |
 | **Mobile** | `mobile`, `flutter`, `android-native`, `ios-native` |
-| **Gamedev** | `unity-dev`, `unity-design`, `unreal-dev`, `visual-novel`, `audio` |
+| **Gamedev** | `unity-dev`, `unity-design`, `unreal-dev`, `visual-novel`, `audio`, `meshy` |
 | **Platform & Quality** | `infra`, `database`, `security`, `testing`, `ai` |
 | **Project Management** | `agile`, `jira`, `clickup`, `integrations` |
 | **Business** | `business`, `clevel`, `finance`, `marketing`, `ecommerce`, `regulatory` |
@@ -515,7 +515,7 @@ Yes, and it's recommended. This way everyone on the team gets the same Claude Co
 
 ### How many tokens does a profile consume?
 
-Each skill adds ~30-100 tokens to the system prompt. A typical stack profile (20-30 skills) adds ~1-2k tokens. The core profile adds ~500 tokens. Compare that to loading all 427 skills, which is why selective deploy matters.
+Each skill adds ~30-100 tokens to the system prompt. A typical stack profile (20-30 skills) adds ~1-2k tokens. The core profile adds ~500 tokens. Compare that to loading all 431 skills, which is why selective deploy matters.
 
 ### Why replace instead of merge on install?
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-arcane",
-  "version": "2.5.0",
+  "version": "2.6.1",
   "description": "Skills, agents, hooks and rules for Claude Code — installable via npx claude-code-arcane",
   "type": "module",
   "bin": {

package/profiles/meshy.yaml

@@ -0,0 +1,42 @@
+name: meshy
+description: "Produccion de assets 3D con Meshy AI — generacion con gate de creditos, master unico + derivados baratos (FBX game, GLB web, blend, STL print) y printability"
+category: gamedev
+
+skills:
+  # Setup: cablea el MCP oficial de Meshy, no lo vendoriza
+  - meshy-setup
+  # Pipeline
+  - meshy-generate
+  - meshy-derive
+  - meshy-print
+  # Reusada de la libreria compartida
+  - asset-audit
+
+rules:
+  universal:
+    - meshy-assets
+  gamedev:
+    []
+
+agents:
+  # Meshy siempre se instala junto a unity-* o unreal-dev, que ya traen
+  # agents/game/. Declararlo aca solo copiaria los 30 agentes de gamedev
+  # a quien instale +meshy suelto para impresion 3D.
+  []
+
+permissions:
+  allow:
+    # Derivados locales — cero creditos
+    - "Bash(npx --yes @gltf-transform/cli*)"
+    - "Bash(npx @gltf-transform/cli*)"
+    - "Bash(npx gltf-transform*)"
+    # Verificacion de LFS antes de commitear binarios
+    - "Bash(git check-attr*)"
+    - "Bash(git lfs version)"
+    - "Glob(assets/3d/**)"
+    - "Grep(assets/3d/**)"
+  deny:
+    # El master es inmutable: entra solo via mcp__meshy__download_model,
+    # ninguna herramienta de edicion lo toca despues
+    - "Write(assets/3d/*/master.glb)"
+    - "Edit(assets/3d/*/master.glb)"

package/rules/meshy-assets.md

@@ -0,0 +1,111 @@
+# Meshy Assets
+
+Reglas para produccion de assets 3D con Meshy. Aplican a cualquier operacion que toque `assets/3d/`.
+
+## Creditos — cada llamada cuesta plata real
+
+| Operacion | Creditos |
+|---|---|
+| `meshy_analyze_printability` | **0** |
+| `meshy_check_balance`, `meshy_get_task_status`, `meshy_list_tasks`, `meshy_download_model` | **0** |
+| `meshy_convert`, `meshy_resize` | 1 |
+| `meshy_animate` | 3 |
+| `meshy_text_to_image` | 3-9 |
+| `meshy_image_to_image` | 3-12 |
+| `meshy_remesh`, `meshy_rig`, `meshy_uv_unwrap` | 5 |
+| `meshy_retexture`, `meshy_repair_printability` | 10 |
+| `meshy_text_to_3d`, `meshy_image_to_3d`, `meshy_multi_image_to_3d` | 20-30 |
+| Print white model | 20 |
+| `meshy_creative_lab` | 36 |
+| Print multicolor | 40 |
+
+### Reglas duras
+
+1. **Nunca generar sin confirmacion explicita.** Preguntar siempre, incluso si el pedido parece obvio. Informar el costo estimado **antes** de la llamada.
+2. **Preview primero.** `meshy_text_to_3d_refine` solo con el preview aprobado por el usuario.
+3. **Nunca en batch.** Un asset por vez, con confirmacion por asset.
+4. **Chequear el ledger antes de generar.** Grepear `assets/3d/*/meshy.json` buscando un prompt equivalente. Si existe, avisar y **no** generar.
+5. **Las operaciones de 0 creditos no necesitan confirmacion.** `analyze_printability`, `check_balance`, `get_task_status`, `list_tasks`, `download_model` corren libres.
+
+Ante cualquier duda sobre si una operacion gasta, correr `meshy_check_balance` antes y despues y reportar el delta real.
+
+## Master unico, derivados baratos
+
+El GLB refined es la fuente de verdad y es **inmutable**. Ningun target se genera desde el prompt: todos salen del master.
+
+| Target | Como | Creditos |
+|---|---|---|
+| Unity y UE5 | `meshy_convert` -> `fbx` (un solo archivo sirve para los dos) | 1 |
+| Blender | `meshy_convert` -> `blend` | 1 |
+| Impresion | `meshy_convert` -> `stl` (`3mf` si es multicolor) | 1 |
+| Web / three.js | `npx gltf-transform optimize --simplify` | **0** |
+
+- Nunca usar `remesh` (5) cuando `convert` (1) alcanza. `remesh` es para cambiar topologia de verdad, no para cambiar de formato.
+- Nunca usar `remesh` para LODs de web: `gltf-transform` hace decimation, meshopt y KTX2 en local y gratis.
+
+## Estructura en disco
+
+```
+assets/3d/<slug>/
+  meshy.json           # ledger, ver abajo
+  master.glb           # refined, inmutable
+  thumb.png
+  targets/
+    web.glb            # <=15k tris, texturas 1024, KTX2 + draco
+    game.fbx           # Unity + UE5
+    edit.blend
+    print.stl
+```
+
+Slugs en kebab-case, sin fechas ni task_ids en el path.
+
+## Ledger: `meshy.json`
+
+Obligatorio por asset. Sin esto cada sesion nueva arranca ciega y se paga dos veces el mismo modelo.
+
+```json
+{
+  "slug": "rune-pedestal",
+  "prompt": "...",
+  "ai_model": "meshy-5",
+  "tasks": [
+    { "id": "...", "op": "text_to_3d_preview", "credits": 5, "at": "2026-08-18T14:02:00Z" },
+    { "id": "...", "op": "text_to_3d_refine", "credits": 25, "at": "2026-08-18T14:11:00Z" }
+  ],
+  "credits_total": 30,
+  "derived": ["targets/web.glb", "targets/game.fbx"]
+}
+```
+
+Actualizar `meshy.json` **en el mismo turno** en que se genera. No dejarlo para despues.
+
+## Ejes y escala
+
+Verificar una vez, anotar en el ledger, no volver a pensarlo.
+
+| Destino | Convencion |
+|---|---|
+| GLB | Y-up, metros |
+| Unity | Y-up, 1 unidad = 1 m |
+| UE5 | Z-up, 1 unidad = 1 cm (rotacion + factor 100) |
+| Blender | Z-up, metros |
+
+## Impresion 3D
+
+Correr `meshy_analyze_printability` (gratis) **siempre** antes de `meshy_repair_printability` (10). `meshy_resize` a milimetros reales antes de exportar STL. Las operaciones de print (20 white / 40 multicolor) son las mas caras del catalogo: doble confirmacion.
+
+## Rigging
+
+`meshy_rig` es solo humanoides. El esqueleto que devuelve **no** es el mannequin de UE5: el retargeting es manual. En UE5 los static meshes van a Nanite y no necesitan decimation; los skeletal meshes si necesitan LODs propios.
+
+## Git y secretos
+
+- `*.glb *.fbx *.blend *.stl *.3mf` por **Git LFS**.
+- `meshy.json` y `thumb.png` van como archivos normales — son chicos y son lo que hace grepeable el catalogo.
+- `MESHY_API_KEY` (formato `msy_...`) va en `.env`, **nunca** en el repo ni en un SKILL.md.
+
+## Integracion con el resto del stack
+
+`asset-spec` define que asset hace falta -> Meshy lo genera -> `asset-audit` valida el resultado. Meshy no reemplaza a ninguno de los dos.
+
+Si existe un art bible en el proyecto, el prompt de generacion se deriva de ahi, no se inventa.

package/skills/meshy-derive/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: meshy-derive
+description: "Deriva targets (FBX para Unity/UE5, GLB web optimizado, blend, STL) desde el master GLB de un asset. Usa convert (1 credito) o gltf-transform (gratis), nunca regenera. Usar para: exportar asset, target unity, target web, optimizar glb, lod web."
+category: "gamedev"
+argument-hint: "<slug> [game|web|edit|print|all]"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit
+---
+# meshy-derive — Master a targets
+
+Todos los targets salen del `master.glb`. **Nunca se regenera desde el prompt** — eso son 20-30 creditos para algo que cuesta 1 o 0.
+
+## Input
+
+- `<slug>` (requerido). Sin argumento → mostrar el uso y parar.
+- Target (opcional, default `all`): `game` | `web` | `edit` | `print` | `all`.
+
+---
+
+## Phase 1: Validar el master
+
+- `assets/3d/<slug>/master.glb` tiene que existir. Si no, parar: "Corre `/meshy-generate <slug>` primero."
+- Leer `assets/3d/<slug>/meshy.json`. Si el target pedido ya esta en `derived[]` y el archivo existe en disco, **no rehacerlo**: reportarlo y parar.
+
+El master es inmutable. Ninguna fase de esta skill lo escribe.
+
+---
+
+## Phase 2: Elegir la herramienta
+
+| Target | Salida | Como | Creditos |
+|---|---|---|---|
+| `game` | `targets/game.fbx` | `mcp__meshy__convert` -> `fbx` | 1 |
+| `edit` | `targets/edit.blend` | `mcp__meshy__convert` -> `blend` | 1 |
+| `print` | `targets/print.stl` (`.3mf` si multicolor) | `mcp__meshy__convert` | 1 |
+| `web` | `targets/web.glb` | `npx gltf-transform` | **0** |
+
+Un solo `game.fbx` sirve para Unity y UE5. No generar uno por engine.
+
+**Nunca usar `remesh` (5) donde `convert` (1) alcanza.** `remesh` cambia topologia; no es un conversor de formato. Y nunca usar `remesh` para LODs de web: `gltf-transform` hace decimation, meshopt y KTX2 en local y gratis.
+
+---
+
+## Phase 3A: Web — gratis, local
+
+```bash
+npx --yes @gltf-transform/cli optimize \
+  assets/3d/<slug>/master.glb \
+  assets/3d/<slug>/targets/web.glb \
+  --simplify --texture-compress ktx2 --compress draco
+```
+
+Presupuesto: ≤15k tris, texturas 1024. Verificar el resultado:
+
+```bash
+npx --yes @gltf-transform/cli inspect assets/3d/<slug>/targets/web.glb
+```
+
+Reportar tris y tamaño finales. Si queda por encima del presupuesto, bajar con `--simplify-ratio` antes de dar por bueno — no aceptar el default en silencio.
+
+Cero creditos: esta fase no necesita confirmacion de gasto.
+
+## Phase 3B: convert — 1 credito por target
+
+Cada `convert` gasta. Mostrar al usuario **la lista completa de targets y el total** en un solo mensaje y pedir una confirmacion para todo el lote:
+
+> `game` + `edit` = 2 creditos. Balance actual: N.
+
+Con `all`, hacer web primero (gratis) y despues los `convert` — asi el usuario ve un resultado antes de aprobar gasto.
+
+Pollear con `mcp__meshy__get_task_status`, bajar con `mcp__meshy__download_model`.
+
+---
+
+## Phase 4: Ejes y escala
+
+Verificar una vez por asset y **anotarlo en el ledger** para no volver a pensarlo:
+
+| Destino | Convencion |
+|---|---|
+| GLB | Y-up, metros |
+| Unity | Y-up, 1 unidad = 1 m |
+| UE5 | Z-up, 1 unidad = 1 cm — rotacion + factor 100 al importar |
+| Blender | Z-up, metros |
+
+El FBX se importa igual en los dos engines; lo que cambia es la config de import, no el archivo.
+
+**Rigging**: si el asset esta rigueado, el esqueleto de Meshy no es el mannequin de UE5 — el retargeting es manual. En UE5, los static meshes van a Nanite y no necesitan LODs; los skeletal meshes si.
+
+---
+
+## Phase 5: Actualizar el ledger
+
+Agregar cada target a `derived[]` en `meshy.json`, sumar los creditos de los `convert` a `tasks[]` y a `credits_total`. **En el mismo turno.** Mostrar el diff del ledger y **pedir aprobacion antes de escribir**.
+
+Verificar LFS sobre los archivos nuevos (`git check-attr filter`).
+
+---
+
+## Phase 6: Resumen
+
+Reportar: targets generados, creditos gastados reales (delta de `check_balance`), tris/tamaño del web target, y que quedo sin hacer.
+
+**Verdict:**
+- **COMPLETE** — todos los targets pedidos en disco y en el ledger.
+- **PARTIAL** — alguno fallo o el usuario no aprobo el gasto. Decir cual y por que.
+- **SKIPPED** — ya existian, no se gasto nada.
+
+## Next Steps
+
+- `/asset-audit` para validar naming, budgets y formatos contra los standards
+- `/meshy-print <slug>` si ademas va a impresion (tiene su propio flujo de printability)
+
+---
+
+> Presupuestos, estructura de `targets/`, formato del ledger y la tabla de creditos completa: `.claude/rules/meshy-assets.md`.

package/skills/meshy-generate/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: meshy-generate
+description: "Genera un asset 3D con Meshy: preview -> aprobacion -> refine, con gate de creditos, dedupe contra el ledger y escritura de meshy.json. Usar para: generar modelo 3D, text to 3d, image to 3d, crear asset con meshy."
+category: "gamedev"
+argument-hint: "<slug> [--from-image <path>] [--spec <path>]"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit
+---
+# meshy-generate — Generar un asset 3D
+
+Un asset por corrida. **Nunca en batch.** Cada llamada de generacion cuesta 20-30 creditos reales.
+
+## Input
+
+- `<slug>` (requerido): kebab-case, sin fechas ni task_ids. Es el nombre de la carpeta. Sin argumento → mostrar el uso y parar.
+- `--from-image <path>` (opcional): usa `image_to_3d` en vez de `text_to_3d`. Con varias imagenes, `multi_image_to_3d`.
+- `--spec <path>` (opcional): spec de `asset-spec` de donde sale el prompt.
+
+---
+
+## Phase 1: Dedupe — antes de gastar
+
+```bash
+grep -rl "<termino>" assets/3d/*/meshy.json 2>/dev/null
+```
+
+Buscar por slug y por palabras clave del prompt. **Si hay un asset equivalente, parar**: mostrarlo al usuario, con su `credits_total`, y preguntar si quiere reusarlo, derivar un target nuevo con `/meshy-derive`, o generar igual.
+
+Si `assets/3d/<slug>/` ya existe, no pisarlo. Parar y preguntar.
+
+---
+
+## Phase 2: Prompt
+
+- **Con `--spec`**: el prompt sale del spec, textual.
+- **Sin spec**: si existe art bible (`design/art/art-bible.md` o equivalente), derivar el prompt de ahi — estilo, paleta, nivel de detalle. Si no existe, redactarlo con el usuario.
+- Nunca inventar un estilo que contradiga el art bible.
+
+Mostrar el prompt final y pedir aprobacion. El prompt aprobado va al ledger textual: es lo que hace que el dedupe de la proxima sesion funcione.
+
+---
+
+## Phase 3: Gate de creditos
+
+Antes de la primera llamada que gasta:
+
+```
+mcp__meshy__check_balance
+```
+
+Presentar al usuario, en un solo mensaje:
+
+| | |
+|---|---|
+| Operacion | `text_to_3d` preview |
+| Costo estimado | 20-30 creditos (preview + refine) |
+| Balance actual | (de `check_balance`) |
+
+**Esperar confirmacion explicita.** No generar con un "dale" ambiguo sobre otra cosa — la confirmacion tiene que ser sobre el costo mostrado.
+
+---
+
+## Phase 4: Preview
+
+Llamar `mcp__meshy__text_to_3d` (o `image_to_3d` / `multi_image_to_3d`) en modo preview. Pollear con `mcp__meshy__get_task_status` — es gratis, no hay razon para adivinar.
+
+Bajar el preview con `mcp__meshy__download_model` y **mostrarselo al usuario**. Anotar el `task_id` y los creditos del preview en el ledger ya en este punto: si el refine se cancela, el gasto del preview igual ocurrio y tiene que quedar registrado.
+
+---
+
+## Phase 5: Refine — solo con el preview aprobado
+
+Si el preview no convence: **no refinar**. Opciones, en orden de costo:
+1. Ajustar el prompt y volver a preview.
+2. `retexture` (10) si la geometria sirve y el problema es la textura.
+3. Descartar.
+
+Con el preview aprobado, llamar `mcp__meshy__text_to_3d_refine`. El GLB resultante es el **master** y es inmutable — nada lo edita despues.
+
+---
+
+## Phase 6: Escribir en disco
+
+```
+assets/3d/<slug>/
+  meshy.json
+  master.glb
+  thumb.png
+```
+
+Mostrar el contenido de `meshy.json` y **pedir aprobacion antes de escribir**. Se escribe **en este mismo turno**, con el prompt textual, `ai_model`, un entry por task con sus creditos, y `credits_total`. El formato exacto esta en la rule.
+
+Verificar que `master.glb` este cubierto por Git LFS (`git check-attr filter assets/3d/<slug>/master.glb`). Si no lo esta, avisar — commitear un GLB sin LFS ensucia el repo de forma dificil de revertir.
+
+---
+
+## Phase 7: Resumen
+
+Reportar:
+- Slug, prompt usado y de donde salio (spec / art bible / redactado).
+- Task ids y **creditos gastados reales** (correr `check_balance` de nuevo y reportar el delta contra Phase 3).
+- Archivos escritos.
+- Estado de LFS.
+
+**Verdict:**
+- **COMPLETE** — master en disco, ledger escrito, LFS ok.
+- **PARTIAL** — se gasto en preview pero no hubo refine. El ledger tiene que reflejarlo igual. Decir cuanto se gasto.
+- **ABORTED** — no se gasto nada. Decir por que.
+
+## Next Steps
+
+- `/meshy-derive <slug>` para los targets (FBX, web, blend) — el master no se toca
+- `/meshy-print <slug>` si va a impresion
+- `/asset-audit` para validar contra los standards del proyecto
+
+---
+
+> Tabla de creditos completa, reglas de gasto, formato del ledger y convenciones de ejes/escala: `.claude/rules/meshy-assets.md`. Leerla antes de la Phase 3.

package/skills/meshy-print/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: meshy-print
+description: "Prepara un asset para impresion 3D con Meshy: analyze printability (gratis) -> repair -> resize a mm reales -> STL/3MF. Usar para: imprimir 3d, printability, stl, resize mm, reparar malla para impresion."
+category: "gamedev"
+argument-hint: "<slug> [--height-mm <n>] [--multicolor]"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit
+---
+# meshy-print — Preparar para impresion 3D
+
+El flujo esta ordenado por costo a proposito: lo gratis primero, y lo caro solo si el diagnostico lo justifica.
+
+## Input
+
+- `<slug>` (requerido). Sin argumento → mostrar el uso y parar.
+- `--height-mm <n>` (opcional): altura real de la pieza. Sin esto no se puede escalar bien.
+- `--multicolor` (opcional): salida `3mf` en vez de `stl`.
+
+Requiere `assets/3d/<slug>/master.glb`. Si no existe, parar: "Corre `/meshy-generate <slug>` primero."
+
+---
+
+## Phase 1: Analyze — gratis, siempre
+
+```
+mcp__meshy__analyze_printability
+```
+
+Cuesta **0 creditos**. Correrlo siempre, sin pedir confirmacion, antes que cualquier otra cosa.
+
+Reportar el diagnostico al usuario en concreto: non-manifold, normals invertidas, paredes finas, geometria flotante, self-intersections. Este reporte es el que decide si vale la pena gastar en repair.
+
+**Si el analisis sale limpio, saltar la Phase 2 entera.** Diez creditos de `repair` sobre una malla sana son diez creditos tirados.
+
+---
+
+## Phase 2: Repair — 10 creditos, solo si hace falta
+
+Presentar el gate antes de llamar:
+
+| | |
+|---|---|
+| Operacion | `repair_printability` |
+| Costo | 10 creditos |
+| Problemas que resuelve | (los que listo la Phase 1) |
+| Balance actual | (de `check_balance`) |
+
+Con confirmacion explicita, llamar `mcp__meshy__repair_printability` y pollear con `get_task_status`.
+
+Despues del repair, **volver a correr `analyze_printability`** (gratis) para confirmar que quedo resuelto. No asumir que el repair funciono.
+
+Si hay problemas que el repair no arregla, decirlo: algunos requieren edicion manual en Blender y no tiene sentido gastar dos veces.
+
+---
+
+## Phase 3: Escala real — 1 credito
+
+Los modelos de Meshy vienen en unidades arbitrarias. Sin escalar, el slicer imprime cualquier cosa.
+
+- **Con `--height-mm`**: `mcp__meshy__resize` a esa altura.
+- **Sin `--height-mm`**: preguntar la altura antes de seguir. No adivinar.
+
+Anotar la altura final en el ledger — es lo que evita reimprimir a la escala equivocada.
+
+Chequear la altura contra el volumen de la impresora del usuario si lo sabemos; si no, avisar que lo verifique en el slicer.
+
+---
+
+## Phase 4: Exportar — 1 credito
+
+`mcp__meshy__convert` a `stl` (o `3mf` con `--multicolor`, que preserva color por cara). Salida: `assets/3d/<slug>/targets/print.stl` (o `.3mf`).
+
+`mcp__meshy__send_to_slicer` esta disponible si el usuario lo pide explicitamente.
+
+---
+
+## Phase 5: Print via Meshy — solo si lo piden
+
+Meshy puede imprimir y enviar la pieza fisica. Es lo mas caro del catalogo:
+
+| | Creditos |
+|---|---|
+| White model | 20 |
+| Multicolor (`process_multicolor`) | 40 |
+
+**Doble confirmacion**: mostrar el costo, esperar confirmacion, repetir el costo y el destino, esperar de nuevo. No entrar a esta fase por iniciativa propia — solo si el usuario la pidio.
+
+---
+
+## Phase 6: Ledger y resumen
+
+Agregar cada task a `meshy.json` con sus creditos, sumar a `credits_total`, agregar el STL/3MF a `derived[]`, anotar la altura en mm. Mostrar el diff y **pedir aprobacion antes de escribir**.
+
+Reportar: veredicto del analisis inicial, si hubo repair y si el re-analisis quedo limpio, altura final, archivo generado, y **creditos gastados reales** (delta de `check_balance`).
+
+**Verdict:**
+- **PRINT-READY** — analisis limpio, escala aplicada, archivo en disco.
+- **NEEDS-MANUAL** — quedan defectos que el repair no resuelve. Listarlos y decir que hace falta en Blender.
+- **BLOCKED** — falta el master, o falta la altura y el usuario no la dio.
+
+## Next Steps
+
+- Verificar la pieza en el slicer antes de imprimir: soportes, orientacion, volumen
+- `/meshy-derive <slug> game` si el mismo asset ademas va al juego — el master es el mismo, los targets son independientes
+
+---
+
+> Tabla de creditos completa y reglas de gasto: `.claude/rules/meshy-assets.md`. La regla de "gratis antes que pago" de este flujo esta ahi tambien.

package/skills/meshy-setup/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: meshy-setup
+description: "Conecta Claude Code con Meshy AI: API key, registro del MCP oficial de Meshy, verificacion de balance y estructura de assets. Usar para: setup meshy, conectar meshy, mcp meshy, meshy api key."
+category: "gamedev"
+argument-hint: "[--verify]"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit
+---
+# meshy-setup — Conectar Meshy AI
+
+Deja el proyecto listo para generar assets 3D con Meshy. **Este repo no trae el MCP server** — es un paquete npm de Meshy que se registra en el cliente. Esta skill lo cablea, verifica y reporta; no vendoriza nada.
+
+`--verify` salta la configuracion y corre solo la Phase 4.
+
+---
+
+## Phase 1: API key
+
+La key vive en el entorno, nunca en el repo.
+
+```bash
+echo "${MESHY_API_KEY:0:4}"   # esperado: msy_
+```
+
+- **Si esta**: confirmar el prefijo `msy_` y seguir. No imprimir la key completa nunca.
+- **Si falta**: pedirsela al usuario y guardarla en `.env` del proyecto. Verificar que `.env` este en `.gitignore` **antes** de escribir — si no esta, agregarlo primero.
+
+Se saca de meshy.ai → Settings → API Keys. Requiere plan pago para la API.
+
+> Si el usuario pega la key en el chat, escribirla a `.env` y avisarle que rote esa key si el transcript se comparte.
+
+---
+
+## Phase 2: Registrar el MCP
+
+Chequear si ya esta registrado antes de tocar nada — es idempotente, nunca duplicar:
+
+```bash
+claude mcp list | grep -i meshy
+```
+
+Si no aparece, mostrar el comando y **pedir aprobacion antes de correrlo**:
+
+```bash
+claude mcp add-json meshy '{"command":"npx","args":["-y","@meshy-ai/meshy-mcp-server"],"env":{"MESHY_API_KEY":"msy_YOUR_API_KEY"}}'
+```
+
+- Paquete: `@meshy-ai/meshy-mcp-server` (npm, oficial de Meshy).
+- Requiere Node. Si falta `node --version`, avisar y no abortar el resto.
+- Sustituir `msy_YOUR_API_KEY` por la key real. Si el usuario prefiere no dejarla en la config del cliente, registrar el server sin `env` y exportar `MESHY_API_KEY` desde el shell.
+
+El server expone 24 tools `mcp__meshy__*`: generacion (`text_to_3d`, `image_to_3d`, `multi_image_to_3d`, `creative_lab`), post-proceso (`remesh`, `retexture`, `rig`, `animate`), conversion (`convert`, `resize`, `uv_unwrap`), imagen (`text_to_image`, `image_to_image`), tasks (`get_task_status`, `list_tasks`, `cancel_task`, `download_model`, `list_models`), impresion (`analyze_printability`, `repair_printability`, `process_multicolor`, `send_to_slicer`) y `check_balance`.
+
+---
+
+## Phase 3: Estructura del proyecto
+
+Crear si no existen — todo idempotente:
+
+1. `assets/3d/` con un `.gitkeep`.
+2. Entradas de **Git LFS** en `.gitattributes`. Verificar `git lfs version` primero; si LFS no esta instalado, avisar y **no** escribir las entradas (peor que no tenerlas es tenerlas sin LFS):
+   ```
+   *.glb  filter=lfs diff=lfs merge=lfs -text
+   *.fbx  filter=lfs diff=lfs merge=lfs -text
+   *.blend filter=lfs diff=lfs merge=lfs -text
+   *.stl  filter=lfs diff=lfs merge=lfs -text
+   *.3mf  filter=lfs diff=lfs merge=lfs -text
+   ```
+   `meshy.json` y `thumb.png` quedan fuera de LFS a proposito: son chicos y son lo que hace grepeable el catalogo.
+3. `.env` en `.gitignore`.
+
+Mostrar el diff de `.gitattributes` y `.gitignore` y pedir aprobacion antes de escribir.
+
+Para derivados web gratis hace falta `gltf-transform`. No instalarlo: se usa via `npx` on-demand.
+
+---
+
+## Phase 4: Verificar
+
+```bash
+claude mcp list
+```
+
+Con el server conectado, confirmar credenciales y balance con la tool gratis:
+
+```
+mcp__meshy__check_balance
+```
+
+Reportar el balance en creditos. **Si el server no esta conectado, avisar explicitamente** y aclarar que ninguna operacion de generacion esta disponible — no asumir exito.
+
+---
+
+## Phase 5: Resumen
+
+Reportar:
+- Origen de la API key (`.env` nueva vs ya presente en el entorno). Nunca el valor.
+- Si el MCP se registro ahora o ya estaba.
+- Que se creo o modifico: `assets/3d/`, `.gitattributes`, `.gitignore`.
+- Balance de creditos actual.
+
+**Verdict:**
+- **READY** — MCP conectado en `claude mcp list` y `check_balance` respondio.
+- **PENDING** — config escrita pero el server no conecta todavia (tipico: Node ausente, o hay que reiniciar Claude Code para que levante el server). Aclarar que generar **aun no** esta disponible.
+- **BLOCKED** — falta la API key, el plan no tiene acceso a la API, o `.gitignore` no se pudo asegurar. Indicar el fix concreto.
+
+## Next Steps
+
+- `/meshy-generate` para el primer asset (leer el gate de creditos antes)
+- `/meshy-derive` para sacar targets de un master existente
+- `/meshy-print` si el destino es impresion 3D
+- Si ya hay art bible, `/asset-spec` primero: los prompts se derivan de ahi, no se inventan
+
+---
+
+> Las reglas de gasto, estructura de `assets/3d/`, ledger `meshy.json` y tabla de derivados estan en `.claude/rules/meshy-assets.md`. Leerlas antes de cualquier operacion que gaste creditos.