claude-code-arcane 2.6.0 → 2.7.0

package/docs/SKILLS-CATALOG.md

@@ -1,8 +1,8 @@
 # Skills Catalog — Claude Code Arcane
 
-Los 431 skills disponibles para proyectos consumidores, organizados por division.
+Los 437 skills disponibles para proyectos consumidores, organizados por division.
 
-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.
+La tabla cubre 395: 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
 
@@ -104,6 +104,21 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 
 ---
 
+## Blender (5 skills)
+
+Instalables con el perfil `blender`. El MCP de Blender es **recomendado, no se instala desde este
+repo**: la comparacion entre el de la comunidad y el oficial esta en `/blender-context`.
+
+| Skill | Descripcion | Uso |
+|-------|-------------|-----|
+| `/blender-context` | Foundation: version, MCP recomendado, headless, unidades y ejes, estructura de assets | `[--verify]` |
+| `/blender-modeling` | Presupuesto de tris, topologia, stack de modifiers, booleans, LODs, bmesh | `[slug] [--budget <tris>] [--lod]` |
+| `/blender-materials` | Principled BSDF, UVs y lightmap UV1, bake, color space, normal maps OpenGL vs DirectX | `[slug] [--bake] [--target unity\|ue5\|web]` |
+| `/blender-animation` | Armature y naming, weights, bake de constraints, NLA como clips, root motion, retarget Mixamo | `[slug] [--retarget <fbx>] [--bake]` |
+| `/blender-export` | Formato y settings, export headless, y validacion automatica del glTF resultante | `[slug] [--target unity\|ue5\|web] [--budget-tris <n>]` |
+
+---
+
 ## Unreal (30 skills)
 
 Instalables con el perfil `unreal-dev`. Procedencia y licencias en `ATTRIBUTION.md`.
@@ -561,7 +576,7 @@ Instalables con el perfil `unreal-dev`. Procedencia y licencias en `ATTRIBUTION.
 
 ---
 
-## Freelance (8 skills)
+## Freelance (9 skills)
 
 Perfil `+freelance`. Reutiliza ademas 6 skills ya catalogados: `/master-profile`, `/portfolio-site`, `/cold-outreach`, `/job-outcome` (Job Hunt), `/contract-and-proposal-writer` (Business) y `/estimate` (Agile). Comparte el career workspace con `+job-hunt`: una propuesta es una aplicacion con `tipo: freelance`.
 
@@ -575,6 +590,7 @@ Quien consiga una API key propia la activa poniendo una variable de entorno: `ke
 |-------|-------------|-----|
 | `/freelance-hunt` | Orquestador: extiende el career workspace con contratos y ledger de Connects, define piso de tarifa y capacidad, y rutea | `[setup\|status\|next]` |
 | `/freelance-profile` | Perfil de la plataforma: titulo de nicho, primeros 250 caracteres del overview, portfolio items, specialized profiles y tarifa derivada del piso | `[audit\|title\|overview\|portfolio\|rate]` |
+| `/fiverr-gig` | Lado de la oferta en Fiverr: titulo I will y tags, los tres packages separados por alcance, gallery, FAQ y precio sobre el piso neto | `[audit\|title\|packages\|gallery\|faq\|price]` |
 | `/freelance-scan` | Scorea ofertas (fit tecnico + viabilidad economica + probabilidad de que la oferta exista) con dedup entre corridas. `search` sobre fuentes publicas sin API key (GetOnBrd, Himalayas), `web` llega a los marketplaces via WebSearch + triage de ruido SEO, `market` para tarifas, `keys` para las fuentes con credencial propia | `[search\|web\|market\|keys\|sources\|post pegado]` |
 | `/client-screen` | Riesgo del cliente antes de gastar Connects: payment verificado, hire rate, brecha presupuesto/alcance, red flags. Registra el descarte tambien | `[job-url\|nota\|post]` |
 | `/freelance-proposal` | Propuesta que sobrevive la vista de lista (2 primeras lineas) + bid sobre el piso neto: fijo vs hora, buffer de riesgo, comision | `[nota\|job-url]` |

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 **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.
+Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It provides a curated library of **437 skills**, **109 agents**, **17 hooks**, and **30 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`, `meshy` |
+| **Gamedev** | `unity-dev`, `unity-design`, `unreal-dev`, `visual-novel`, `audio`, `meshy`, `blender` |
 | **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 431 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 437 skills, which is why selective deploy matters.
 
 ### Why replace instead of merge on install?
 

package/hooks/validate-commit.sh

@@ -19,6 +19,42 @@ main() {
     echo "BLOCK: empty commit message not allowed." >&2
     exit 2
   fi
+
+  validate_3d_exports
+}
+
+# Gate de exports 3D. No-op salvo que el perfil blender este instalado y haya
+# .glb/.gltf staged: bloquea solo fallas inequivocas (contenedor roto, sin UVs,
+# escala de conversion sin aplicar, texturas fuera del .glb). El presupuesto de
+# tris es por proyecto, asi que aca no se pasa y queda como aviso, no como block.
+validate_3d_exports() {
+  local VALIDATOR=".claude/skills/blender-export/scripts/validate_gltf.py"
+  [[ -f "$VALIDATOR" ]] || return 0
+
+  local STAGED
+  STAGED=$(git diff --cached --name-only --diff-filter=ACM 2>/dev/null | grep -iE '\.(glb|gltf)$') || true
+  [[ -z "$STAGED" ]] && return 0
+
+  local PY
+  PY=$(command -v python3 2>/dev/null || command -v python 2>/dev/null) || return 0
+  [[ -z "$PY" ]] && return 0
+
+  local FAILED="" OUT
+  while IFS= read -r FILE; do
+    [[ -n "$FILE" && -f "$FILE" ]] || continue
+    if ! OUT=$("$PY" "$VALIDATOR" "$FILE" 2>&1); then
+      FAILED+="$OUT"$'
+'
+    fi
+  done <<< "$STAGED"
+
+  if [[ -n "$FAILED" ]]; then
+    echo "BLOCK: hay exports 3D staged que no pasan la validacion." >&2
+    echo "$FAILED" >&2
+    echo "Corregir en Blender y volver a exportar (ver /blender-export), o sacar el archivo del stage." >&2
+    exit 2
+  fi
 }
+
 main
 exit 0

package/package.json

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

package/profiles/blender.yaml

@@ -0,0 +1,49 @@
+name: blender
+description: "Blender para assets de juego — modelado con presupuesto de tris y topologia, materiales/texturas con bake y color space, rigging y animacion bakeada, y export validado a Unity/UE5/web con validador de glTF stdlib"
+category: gamedev
+
+skills:
+  # Foundation — el resto de los blender-* depende de este
+  - blender-context
+  # Los tres ejes de produccion
+  - blender-modeling
+  - blender-materials
+  - blender-animation
+  # Salida: cierra el pipeline hacia el engine
+  - blender-export
+  # Reusada de la libreria compartida
+  - asset-audit
+
+rules:
+  universal:
+    - blender-pipeline
+  gamedev:
+    []
+
+agents:
+  # Blender se instala junto a unity-*, unreal-dev o meshy, que ya traen
+  # agents/game/. Declararlo aca copiaria los 30 agentes de gamedev a quien
+  # instale +blender suelto para trabajar assets sin engine.
+  []
+
+permissions:
+  allow:
+    # Blender headless es el camino por default del perfil
+    - "Bash(blender --version)"
+    - "Bash(blender --background*)"
+    - "Bash(blender -b *)"
+    # Validador de export — stdlib, no instala nada
+    - "Bash(python *validate_gltf.py*)"
+    - "Bash(python3 *validate_gltf.py*)"
+    # Compresion de glb para web, on-demand via npx
+    - "Bash(npx --yes @gltf-transform/cli*)"
+    - "Bash(npx @gltf-transform/cli*)"
+    # Verificacion de LFS antes de commitear binarios
+    - "Bash(git check-attr*)"
+    - "Bash(git lfs version)"
+    - "Glob(assets/3d/**)"
+    - "Grep(assets/3d/**)"
+  deny:
+    # Los backups de Blender no entran al repo
+    - "Write(**/*.blend1)"
+    - "Write(**/*.blend2)"

package/profiles/freelance.yaml

@@ -6,6 +6,7 @@ skills:
   # Nucleo del perfil
   - freelance-hunt
   - freelance-profile
+  - fiverr-gig
   - freelance-scan
   - client-screen
   - freelance-proposal

package/rules/blender-pipeline.md

@@ -0,0 +1,95 @@
+# Blender Pipeline
+
+Reglas para trabajar assets en Blender con destino a un engine o a la web. Aplican a cualquier
+operacion que toque un `.blend` o exporte desde uno.
+
+## El MCP es opcional, el headless no
+
+Hay dos formas de operar Blender desde Claude, y no son equivalentes:
+
+| | MCP | Headless (`--background`) |
+|---|---|---|
+| Necesita Blender abierto | Si, con el addon conectado | No |
+| Reproducible en CI | No | Si |
+| Ve el estado de la escena | Si | Solo lo que el script consulta |
+| Deja rastro en el repo | No | Si — el script queda versionado |
+
+**Default: headless.** Un `.py` versionado que corre con `blender --background --python` es
+auditable, repetible y no depende de que alguien tenga la ventana abierta. El MCP sirve para
+explorar una escena que ya existe y para iterar visualmente, no para el paso automatizable.
+
+Los dos MCP recomendados estan en `/blender-context`. **Ninguno de los dos se instala desde este
+repo**: son addons de la instalacion de Blender del usuario.
+
+## Ejecuta Python sin sandbox
+
+Tanto el MCP de la comunidad como el oficial corren el Python que genera el LLM **sin ninguna
+barrera**. Consecuencias que no son negociables:
+
+1. **Nunca correrlo con cambios sin commitear** en el repo del proyecto. Si algo se rompe, la
+   unica marcha atras es git.
+2. Guardar el `.blend` antes de la primera operacion de la sesion.
+3. No apuntarlo a una maquina con material sensible ni a credenciales.
+4. Un script que borra (`bpy.data.*.remove`, `object.delete`) se muestra al usuario **antes** de
+   correrlo, siempre, incluso si lo pidio.
+
+## Ejes, escala y unidades
+
+Verificar una vez por proyecto, anotarlo, no volver a pensarlo.
+
+| Destino | Convencion | Al exportar desde Blender |
+|---|---|---|
+| Blender | Z-up, right-handed, 1 unidad = 1 m | — |
+| glTF / GLB | Y-up, metros | El exporter convierte solo (`+Y up`) |
+| Unity | Y-up, left-handed, 1 unidad = 1 m | glTF sale derecho; en FBX revisar el eje |
+| UE5 | Z-up, left-handed, 1 unidad = 1 cm | Factor 100 |
+
+Reglas duras:
+
+- **Aplicar escala antes de exportar** (`Object → Apply → Scale`). Un objeto que sale con `scale`
+  distinto de 1 arrastra el problema al engine y rompe la fisica y el skinning.
+- Origen al piso para props y personajes; al centro para objetos que rotan sobre si mismos.
+- Un nodo con escala `100` o `0.01` en el archivo exportado es una conversion de unidades sin
+  aplicar, no una decision de diseno. Se corrige, no se documenta.
+
+## Topologia
+
+- **Quads en todo lo que deforma.** Tris solo en geometria estatica. N-gons en nada que deforme.
+- Edge loops en articulaciones, poles de 5 aristas o menos.
+- Presupuesto de triangulos declarado **antes** de modelar, no medido despues.
+- Un LOD generado con Decimate es un borrador. Para heroes va retopo a mano.
+
+## Materiales y texturas
+
+- **Principled BSDF y nada mas** en lo que se exporta. Los nodos procedurales no sobreviven a
+  glTF ni a FBX: si el look depende de ellos, hay que bakearlo a textura.
+- Color space: Base Color en sRGB; Normal, Roughness, Metallic y AO en **Non-Color**. Es el bug
+  mas comun y el mas silencioso.
+- Normal maps: Blender, glTF y Unity usan OpenGL (+Y). **UE5 usa DirectX (-Y)**: hay que invertir
+  el canal verde o marcarlo en el import.
+- Resoluciones potencia de dos. Texel density consistente entre assets del mismo set.
+- Cantidad de materiales = draw calls. Atlas antes de sumar materiales.
+
+## Animacion
+
+- **Los constraints no se exportan, los keyframes si.** Todo rig con IK, drivers o constraints se
+  bakea (`nla.bake` con visual keying) antes de exportar.
+- Frame rate del `.blend` igual al del engine. Un mismatch se ve como animacion lenta o acelerada,
+  no como error.
+- Huesos con sufijo `.L` / `.R` para que la simetria funcione.
+- Root motion: hueso raiz en el origen. Decidir in-place vs root motion **antes** de animar.
+
+## Git
+
+- `*.blend *.fbx *.glb *.gltf` por **Git LFS**. Verificar `git lfs version` antes de agregar las
+  entradas: peor que no tenerlas es tenerlas sin LFS instalado.
+- `*.blend1` y `*.blend2` (backups de Blender) van al `.gitignore`, nunca al repo.
+- Las texturas fuente (`.psd`, `.kra`, `.exr` de bake) por LFS; los `.png` finales tambien.
+
+## Integracion con el resto del stack
+
+`asset-spec` define que asset hace falta → Meshy o modelado a mano lo produce → **Blender lo
+limpia y lo exporta** → `asset-audit` valida el resultado en el proyecto.
+
+Blender es el paso del medio, no el principio ni el final. Si el asset vino de `meshy-derive`, el
+`.blend` que bajo es el punto de entrada; no se regenera desde Meshy para arreglar topologia.

package/skills/arcane-add/SKILL.md

@@ -2,7 +2,7 @@
 name: arcane-add
 description: "Add individual skills or entire profiles to the current Arcane installation without reinstalling."
 category: "arcane"
-argument-hint: "<skill-name|+profile>"
+argument-hint: "[skill-name|+profile]"
 user-invocable: true
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 ---
@@ -12,14 +12,31 @@ Add individual skills or entire profiles to the current Arcane installation with
 
 ## Arguments
 
-`/arcane-add <skill-name|profile-name> [skill2] [skill3] ...`
+`/arcane-add [skill-name|+profile] [skill2] [skill3] ...`
 
 Examples:
+- `/arcane-add` — no args: show what can be added and ask
 - `/arcane-add docker-setup` — add a single skill
 - `/arcane-add security-audit owasp-top10-check` — add multiple skills
 - `/arcane-add +security` — add all skills from the +security profile
 - `/arcane-add +database` — add all skills from the +database profile
 
+## Sin argumentos
+
+Mismo criterio que el picker de `arcane install`: mostrar solo lo que **no** esta instalado y dejar
+elegir. No listar los 400 skills.
+
+1. Read `.claude/arcane-manifest.json` (`profiles`, `installed_skills`)
+2. List `profiles/*.yaml` from the source, skip `core.yaml` and the ones already in `profiles`
+3. Print the remaining profiles grouped by their `category` field, in the order of
+   `CATEGORY_ORDER` (Backend, Frontend & Design, Mobile, Gamedev, Platform & Quality,
+   Project Management, Business, Personal, Utilities), each with its description
+4. Say how many individual skills are available on top of that (`/arcane-list` shows them)
+5. Ask which profiles or skills to add, then continue with the steps below
+
+The CLI does the same thing interactively: `arcane add` with no args opens the wizard
+(`src/wizard.ts` → `runAddWizard`).
+
 ## Steps
 
 1. Read `.claude/arcane-manifest.json` to find the `source` path
@@ -44,4 +61,14 @@ Added 3 skills:
   [skip] ci-cd-setup (already installed)
 
 Updated arcane-manifest.json
+COMPLETE
 ```
+
+Un skill que ya esta instalado se saltea, no se sobreescribe. Si el usuario quiere reemplazar una
+copia modificada localmente, preguntar antes de escribir encima.
+
+## Next step
+
+- `/arcane-status` — confirmar que el manifest quedo bien
+- `/arcane-list` — ver que mas hay disponible
+- `/arcane-remove` — deshacer si se agrego de mas

package/skills/blender-animation/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: blender-animation
+description: "Rigging y animacion en Blender para engines: armature y naming de huesos, weights, constraints e IK que hay que bakear, FCurves, acciones y NLA como clips, root motion, retargeting de Mixamo, shape keys. Usar para: animar en blender, rig, armature, retarget mixamo, root motion, shape keys."
+category: "gamedev"
+argument-hint: "[asset-slug] [--retarget <fbx>] [--bake]"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit
+---
+# blender-animation — Rig y animacion
+
+Rig y animacion con destino a un engine. La regla que ordena todo el skill: **el engine recibe
+keyframes, no rig.** Todo lo inteligente del rig existe para producir esos keyframes y despues
+desaparece.
+
+> Requiere `/blender-context`. Con geometria sin cerrar no vale la pena riggear: cada cambio de
+> topologia invalida los weights.
+
+---
+
+## Phase 1: Que se exporta y que no
+
+| En Blender | Al engine | Que hacer |
+|---|---|---|
+| Keyframes en huesos | **Se exportan** | Es el camino |
+| Armature + weights | Se exporta | |
+| Shape keys / morph targets | Se exportan | Verificar el limite del engine |
+| **Constraints** (IK, Copy Rotation, Limit) | **No se exportan** | **Bakear** |
+| Drivers | No se exportan | Bakear |
+| Bone constraints de rig helper | No | Bakear y excluir los huesos helper |
+| Modifiers animados | No | Bakear a shape keys o a keyframes |
+
+Un rig con IK que se exporta sin bakear llega al engine con el personaje en rest pose y **sin
+error visible**. Es el fallo mas comun y el mas confuso de diagnosticar.
+
+---
+
+## Phase 2: Armature
+
+- Un solo armature por personaje, con el objeto en el origen y escala 1.
+- **Naming con sufijo `.L` / `.R`** (`upper_arm.L`). Sin eso, mirror de poses y de weights no
+  funciona, y las herramientas de simetria tampoco.
+- Jerarquia con raiz unica. Si el destino es UE5 y se quiere reusar animacion del mannequin, seguir
+  su nomenclatura desde el principio: renombrar despues es peor.
+- **Bone roll** consistente: ejes de rotacion coherentes entre huesos simetricos, o las curvas de
+  animacion se vuelven ilegibles.
+- Huesos helper y de control marcados de forma reconocible (prefijo, o su propia collection) para
+  poder excluirlos del export.
+
+Diagnostico:
+
+```bash
+blender --background <archivo.blend> --python-expr "
+import bpy
+for o in bpy.data.objects:
+    if o.type == 'ARMATURE':
+        bones = o.data.bones
+        print(f'{o.name}: bones={len(bones)} scale={tuple(o.scale)}')
+        print('  sin sufijo L/R:', [b.name for b in bones if not b.name.endswith(('.L','.R'))][:10])
+for a in bpy.data.actions:
+    print(f'action {a.name}: frames={tuple(a.frame_range)} fcurves={len(a.fcurves)}')
+"
+```
+
+---
+
+## Phase 3: Weights
+
+- Empezar con `Automatic Weights` y corregir a mano; no al reves.
+- **Maximo 4 influencias por vertice.** Es el limite practico de la mayoria de los engines: si hay
+  mas, el engine descarta las sobrantes y la deformacion cambia respecto de Blender.
+- Normalizar todo antes de exportar.
+- Un vertice con weight 0 en todos los huesos se queda en el origen. Se ve como un pico saliendo
+  del personaje.
+
+---
+
+## Phase 4: Acciones, FCurves y NLA
+
+- **Una accion = un clip** en el engine. Nombrarlas como se van a llamar alla (`Idle`, `Run`,
+  `Attack_01`), no `Action.003`.
+- Interpolacion: `Bezier` para movimiento organico, `Linear` para mecanico, `Constant` para
+  stop-motion. La curva es parte de la animacion, no un detalle tecnico.
+- Ciclos con `Cycles` F-Modifier para trabajar, pero **al exportar hay que tener frames reales**:
+  el modifier no viaja.
+- NLA sirve para organizar y para bakear combinaciones. El engine recibe las acciones, no la
+  estructura del NLA.
+- **Frame rate del `.blend` igual al del engine.** Un mismatch se ve como animacion lenta o
+  acelerada y se confunde con un problema de blending.
+- Loops: el ultimo frame no repite el primero. Si repite, el loop tiene un hitch de un frame.
+
+---
+
+## Phase 5: Root motion
+
+Decidir **antes** de animar, porque cambia como se anima:
+
+| | In-place | Root motion |
+|---|---|---|
+| Hueso raiz | Quieto en el origen | Se mueve con el personaje |
+| Quien mueve al personaje | El codigo | La animacion |
+| Cuando | Locomocion con control responsivo | Ataques, finishers, cinematicas |
+
+Mezclar los dos en el mismo set sin decirlo produce deslizamiento de pies que despues se intenta
+arreglar con IK en runtime. Anotar la decision por clip.
+
+---
+
+## Phase 6: Bake antes de exportar
+
+```bash
+blender --background <archivo.blend> --python <script_de_bake.py>
+```
+
+El script tiene que, en este orden:
+
+1. Seleccionar el armature y entrar en Pose Mode.
+2. Bakear con **visual keying** (respeta constraints e IK) sobre el rango real de la accion.
+3. Sacar o deshabilitar los constraints ya horneados.
+4. Dejar solo los huesos de deformacion en el export; los de control quedan afuera.
+5. Guardar en un `.blend` aparte o en una accion nueva — **no sobrescribir el rig de trabajo.**
+
+Ese ultimo punto no es opcional: un bake sobre el rig original destruye la posibilidad de volver a
+animar. **Pedir aprobacion antes de escribir** el script de bake y antes de generar el `.blend` de
+salida, diciendo explicitamente que archivo se crea y cual no se toca.
+
+---
+
+## Phase 7: Retargeting de Mixamo
+
+Cuando la animacion viene de Mixamo:
+
+1. **Escala**: Mixamo exporta en centimetros. Aplicar factor 0.01 o el import queda 100x.
+2. **Pose de referencia**: Mixamo es T-pose. Si el rig destino es A-pose, alinear la rest pose
+   antes de mapear o los hombros salen rotos.
+3. **Mapeo de huesos**: `mixamorig:Hips` → la raiz del rig, y de ahi hacia abajo. Los nombres de
+   Mixamo son estables, asi que el mapeo se escribe una vez y se reusa.
+4. Bakear el resultado (Phase 6) y **borrar los huesos de Mixamo** que no correspondan al rig.
+5. Verificar contacto de pies con el piso, que es lo primero que se rompe.
+
+Si el proyecto usa el toolkit de Mixamo de otra herramienta, respetarlo en lugar de escribir un
+mapeo paralelo.
+
+---
+
+## Phase 8: Resumen
+
+Reportar: huesos totales y cuantos sin sufijo L/R, acciones con nombre y rango, frame rate,
+influencias maximas por vertice, que se bakeo, y decision de root motion por clip.
+
+**Verdict:**
+- **PASS** — keyframes bakeados, naming consistente, frame rate igual al del engine, weights
+  normalizados con 4 influencias o menos.
+- **CONCERNS** — exportable con deuda: huesos sin sufijo, acciones con nombre autogenerado, root
+  motion sin decidir. Listar cada punto.
+- **FAIL** — constraints o IK sin bakear, frame rate distinto al del engine, o weights sin
+  normalizar. Indicar el fix.
+
+## Next Steps
+
+- `/blender-export` para sacar el skeletal mesh y los clips
+- `/adaptive-music` o `/sfx-design` si la animacion necesita audio sincronizado
+- `/asset-audit` para validar el resultado integrado
+- En UE5, `/ue-animation-system` para el lado del engine
+
+---
+
+> → Bake de constraints, frame rate y ejes estan en `.claude/rules/blender-pipeline.md`.

package/skills/blender-context/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: blender-context
+description: "Foundation de Blender: version instalada, MCP recomendado (comunidad vs oficial), modo headless, unidades y ejes, estructura de assets. Los demas blender-* dependen de este. Usar para: setup blender, contexto blender, mcp blender, blender headless."
+category: "gamedev"
+argument-hint: "[--verify]"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit
+---
+# blender-context — Foundation
+
+Deja claro con que Blender se esta trabajando y como se lo va a manejar, **antes** de tocar
+geometria. Todos los demas skills `blender-*` asumen que esto ya corrio.
+
+`--verify` salta la Phase 3 y solo reporta el estado actual.
+
+---
+
+## Phase 1: Detectar Blender
+
+```bash
+blender --version
+```
+
+Si `blender` no esta en el PATH, buscar la instalacion antes de darla por perdida:
+
+| Plataforma | Ruta tipica |
+|---|---|
+| Windows | `C:\Program Files\Blender Foundation\Blender <ver>\blender.exe` |
+| macOS | `/Applications/Blender.app/Contents/MacOS/Blender` |
+| Linux | `/usr/bin/blender`, o el AppImage donde lo dejo el usuario |
+
+Anotar la version mayor: define que features existen y que MCP sirve. Si hay varias instalaciones,
+preguntar cual es la del proyecto — no elegir la mas nueva por default.
+
+**Si no hay Blender**, reportar BLOCKED y parar. Ningun otro `blender-*` puede correr sin binario.
+
+---
+
+## Phase 2: Estructura del proyecto
+
+Buscar `.blend` en el arbol (excluir `*.blend1` y `*.blend2`, que son backups):
+
+- **Si hay**: listar donde estan y confirmar cual es el archivo de trabajo.
+- **Si no hay**: preguntar si se arranca de cero o si los fuentes viven afuera del repo.
+
+La convencion que asume el resto del perfil:
+
+```
+assets/3d/<asset-slug>/
+├── source.blend        # el archivo de trabajo, por LFS
+├── textures/           # fuentes de textura
+└── export/             # lo que consume el engine (glb/fbx), por LFS
+```
+
+Si el proyecto ya usa `meshy-setup`, esta estructura ya existe y el `.blend` de `meshy-derive`
+entra como `source.blend`. **No crear una estructura paralela.**
+
+Verificar `.gitignore` y `.gitattributes`: `*.blend1` ignorado, binarios por LFS. Mostrar el diff
+y pedir aprobacion antes de escribir.
+
+---
+
+## Phase 3: Elegir como operar Blender
+
+### Headless — el default
+
+```bash
+blender --background <archivo.blend> --python <script.py>
+```
+
+Reproducible, versionable, corre en CI, no necesita ventana abierta. **Es el camino por default
+para cualquier paso automatizable.** Los scripts van a `assets/3d/_scripts/` o al lado del skill
+que los usa, nunca inline en el chat.
+
+### MCP — para explorar e iterar
+
+Dos opciones. **Ninguna se instala desde este repo**: el addon vive en la instalacion de Blender
+del usuario, y la decision es suya.
+
+| | Comunidad (`ahujasid/blender-mcp`) | Oficial (Blender Lab) |
+|---|---|---|
+| Estado | Estandar de facto, MIT, mantenido | v1.0.0, **experimental, sin roadmap de release** |
+| Blender | 3.0+ | 5.x (el addon viene con el engine en las versiones nuevas) |
+| Para que sirve | Autoria: crear y modificar objetos, materiales, correr Python | Inspeccion: interfaz en lenguaje natural a la Python API, entender escenas |
+| Extras | Poly Haven (assets, texturas, HDRIs), Sketchfab, Hyper3D | Ninguno, es deliberadamente minimo |
+| Repo | `github.com/ahujasid/blender-mcp` | `projects.blender.org/lab/blender_mcp` |
+
+Recomendacion: **el de la comunidad** si el trabajo es producir assets; el oficial si lo que se
+quiere es entender o debuggear una escena ajena.
+
+> Los dos ejecutan el Python generado por el LLM **sin sandbox**. Antes de la primera operacion:
+> commit limpio en el repo y `.blend` guardado. Las reglas completas estan en
+> `.claude/rules/blender-pipeline.md`.
+
+Si el usuario quiere el MCP, darle el comando y **no correrlo sin aprobacion**:
+
+```bash
+claude mcp add blender -- uvx blender-mcp
+```
+
+Necesita `uv` (`winget install astral-sh.uv`) y el addon: `uvx blender-mcp install-addon`, despues
+habilitarlo en las preferencias de Blender. En el viewport se conecta desde el panel `N` →
+pestana BlenderMCP.
+
+---
+
+## Phase 4: Unidades y ejes
+
+Confirmar con el usuario el destino del asset y anotarlo. La tabla completa esta en la rule; lo
+que hay que fijar ahora es una sola linea: **destino, eje up, y factor de escala**.
+
+Si el destino es Unity o UE5 y el proyecto tiene un `blender-context` previo con otro destino,
+avisar del cambio en lugar de sobrescribirlo en silencio.
+
+---
+
+## Phase 5: Resumen
+
+Reportar:
+- Version de Blender y ruta del binario.
+- Archivos `.blend` encontrados y cual es el de trabajo.
+- Modo de operacion elegido (headless siempre disponible; MCP si esta conectado y cual).
+- Destino, eje up y escala.
+- Que se creo o modifico en el repo (`.gitignore`, `.gitattributes`, estructura de carpetas).
+
+**Verdict:**
+- **READY** — Blender detectado, estructura en su lugar, destino definido. Los demas `blender-*`
+  pueden correr.
+- **PENDING** — todo definido pero el MCP no conecta. Aclarar que el camino headless **si** esta
+  disponible y que solo falta la parte interactiva.
+- **BLOCKED** — no hay binario de Blender, o el destino del asset no se pudo definir. Indicar el
+  fix concreto.
+
+## Next Steps
+
+- `/blender-modeling` para topologia, modifiers y presupuesto de tris
+- `/blender-materials` para shader nodes, UVs y bake
+- `/blender-animation` para rigging, keyframes y retargeting
+- `/blender-export` cuando el asset esta listo para el engine
+- Si el asset viene de Meshy, `/meshy-derive` primero para bajar el `.blend`
+
+---
+
+> → Las reglas de ejes, escala, topologia, color space y Git estan en
+> `.claude/rules/blender-pipeline.md`. Leerlas antes de la primera operacion.