Crear una skill de Claude para Blender, paso a paso

Qué es una skill y por qué ayuda con Blender

Una skill es una carpeta con un archivo SKILL.md. Ese archivo empieza con unas líneas de metadatos, el frontmatter, y continúa con instrucciones escritas en Markdown. Puede acompañarse de otros archivos: documentación de referencia, plantillas o scripts que el agente ejecuta cuando los necesita.

La ventaja frente a repetir el mismo prompt es la carga por etapas. Según la documentación de Anthropic, el agente tiene siempre a la vista el nombre y la descripción de cada skill, pero solo lee el cuerpo de SKILL.md cuando tu petición encaja con esa descripción. Los archivos adicionales se leen únicamente si las instrucciones los mencionan, y de un script ejecutado solo entra en el contexto su salida.

En Blender esto resulta útil porque los fallos suelen ser de criterio, no de sintaxis: una cámara horizontal en un vídeo vertical, objetos con nombres como Cube.003 o un render final lanzado cuando querías una prueba. Una skill deja esas decisiones por escrito para que no dependan de que te acuerdes de mencionarlas.

Dónde se guarda la skill en Claude Code

Claude Code busca skills en dos ubicaciones principales. Las personales viven en ~/.claude/skills/ y están disponibles en todos tus proyectos. Las de proyecto viven en .claude/skills/ dentro del repositorio y se comparten con quien trabaje en él si las incluyes en el control de versiones.

Cada skill ocupa su propia carpeta, y el archivo principal se llama exactamente SKILL.md. El nombre de la carpeta, o el campo name si lo defines, es también el comando que puedes escribir para invocarla a mano. Para este tutorial crearemos una skill de proyecto llamada render-vertical-prueba, que prepara una prueba vertical de baja resolución sin tocar la configuración final.

1. Abre la carpeta de tu proyecto de Blender en la terminal.
2. Crea la ruta .claude/skills/render-vertical-prueba/.
3. Dentro, crea un archivo vacío llamado SKILL.md.
4. Si vas a incluir un script de comprobación, añade una subcarpeta scripts/.

Escribe una description que active la skill

El frontmatter va entre dos líneas con tres guiones y debe empezar en la primera línea del archivo. La especificación de Agent Skills pide dos campos: name y description. El name admite como máximo 64 caracteres, solo minúsculas, números y guiones, y no puede contener las palabras reservadas anthropic ni claude. La description no puede estar vacía y tiene un máximo de 1.024 caracteres. En Claude Code ambos campos son técnicamente opcionales, pero conviene rellenarlos siempre.

La description es lo que el agente compara con tu petición para decidir si carga la skill. Por eso debe decir qué hace y cuándo usarla. Empieza por el caso de uso principal y añade las palabras que tú escribirías de verdad: render de prueba, vertical, 9:16, Shorts o Reels. Una descripción genérica como «ayuda con Blender» compite con cualquier otra tarea y no indica el momento adecuado.

Comprueba también lo contrario: que la skill no se active donde no debe. Si la descripción menciona cualquier render, puede cargarse cuando estés preparando la entrega final. Delimítala con frases como «solo para pruebas» o «no para el render final».

Qué poner dentro: criterios, pasos y nombres

El cuerpo de SKILL.md funciona como una hoja de procedimiento. Incluye las convenciones de tu escena, los pasos en orden, lo que no debe hacerse y cómo comprobar el resultado. Escribe valores concretos: resolución, porcentaje, carpeta de salida, prefijos de nombres. Las instrucciones vagas producen resultados que tendrás que revisar igualmente.

Este ejemplo es genérico; adáptalo a tus nombres y carpetas. Las rutas que empiezan por // son relativas al archivo .blend guardado.

---
name: render-vertical-prueba
description: Prepara un render de prueba vertical 1080x1920 al 50 % en una escena de Blender y comprueba encuadre y nombres antes de renderizar. Úsala cuando el usuario pida una prueba vertical, un borrador 9:16 o revisar una escena para Shorts o Reels. No la uses para el render final.
---

# Render vertical de prueba

## Convenciones de la escena
- Objetos con prefijo de tipo: GEO_ para mallas, CAM_ para cámaras, LUZ_ para luces.
- La cámara activa se llama CAM_Vertical.
- Las pruebas se guardan en //pruebas/, nunca en //final/.

## Pasos
1. Indica la versión de Blender antes de escribir código.
2. Ajusta resolution_x = 1080, resolution_y = 1920 y resolution_percentage = 50.
3. Comprueba que la cámara activa es CAM_Vertical.
4. Renderiza solo el primer y el último fotograma del rango.
5. Ejecuta scripts/comprobar_escena.py e informa de su salida.

## Prohibido
- Borrar objetos, materiales o colecciones.
- Cambiar frame_start, frame_end o fps.
- Guardar el .blend sin pedir confirmación.

## Verificación
- La salida mide 540 x 960 píxeles.
- No hay objetos con nombres por defecto como Cube.001.
- Resume qué propiedades cambiaste y cuáles comprobaste.

Un script de la carpeta scripts/ no se carga como texto en el contexto: el agente lo ejecuta y recibe su salida. Úsalo para comprobaciones repetibles, como listar objetos sin prefijo, y revisa su código antes de añadirlo.

Prueba la skill antes de confiar en ella

Abre Claude Code en la carpeta del proyecto y escribe /skills para ver las skills disponibles en la sesión. Después haz una petición con tus propias palabras, por ejemplo «quiero una prueba vertical de esta escena», y observa si el agente carga la skill. Si no lo hace, reescribe la description con los términos que acabas de usar.

También puedes invocarla directamente con /render-vertical-prueba. Esta vía sirve para comprobar las instrucciones aunque la activación automática todavía no funcione bien. Según la documentación, Claude Code detecta los cambios en una skill existente durante la sesión, sin reiniciar.

1. Trabaja sobre una copia del .blend.
2. Pide una prueba vertical sin nombrar la skill y anota si se activa.
3. Pide un render final y confirma que la skill no se carga.
4. Revisa en Blender la resolución, la cámara y la carpeta de salida.
5. Corrige una sola instrucción por iteración y vuelve a probar.

Mantén la skill corta y ligada a tu trabajo real

La documentación de Claude Code recomienda que SKILL.md no supere las 500 líneas. Si crece, mueve la referencia detallada a otro archivo y enlázalo desde el principal. Crea una skill por tarea: una para pruebas verticales, otra para nombrar objetos. Así cada descripción es precisa y cada procedimiento se puede comprobar.

Revisa la skill cuando cambies de versión de Blender o de convención de nombres, y no instales skills de fuentes que no conozcas sin leer todos sus archivos: pueden ejecutar código en tu equipo. Si prefieres partir de un conjunto ya preparado, en Pieza a pieza ofrecemos un kit con las skills que usamos en el canal.