comunidadbóvedaClaude Anatomy
skill, subagente, hook, MCP, plugin, rutina… o nada

Elegiste un subagente. Era una línea en un archivo de texto.

Abres Claude Code y hay skills, subagentes, comandos, plugins, servidores MCP, hooks, canales, rutinas y artefactos. Nueve palabras, ninguna explicada, y una decisión que tomas en el minuto uno. El costo no se ve el primer día: se ve al mes, cuando la sesión arranca pesada, el modelo elige mal seguido y nadie se acuerda de por qué esa carpeta está ahí. Claude Anatomy es una skill que te hace las preguntas y te devuelve una sola pieza.

Guía comunidad · 12 de agosto de 2026

No enseña a escribir cada pieza. Enseña a elegir cuál.

Aquí está cómo instalarla en las tres superficies con los comandos exactos, cómo dispararla, y cómo verificar que quedó puesta en cada una — incluida la trampa que hace perder una tarde: las rutinas y las sesiones en la nube no leen la carpeta de skills de tu máquina. Y luego lo que te llevas aunque no instales nada: el Paso 0, que es la pregunta de si hace falta construir algo; los cuatro modos de una skill ahora que el comando de barra es un campo del frontmatter; los anti-patrones que salen de elegir la pieza por lo que suena importante; y qué te cobra contexto y en qué momento.

skill propia · MITv0.3.0tres superficiesdos comandos en Claude Codeun .zip para la appcuatro pasos, diez salidasel Paso 0 es no construir nadael nombre no puede decir «claude»~411 tokens siempre encendida~5.1k al dispararseno afiliado a Anthropic

01 · el problema

Nueve palabras sin explicar, y la cuenta llega al mes

Abres Claude Code y te encuentras nueve palabras: skills, subagentes, comandos, plugins, servidores MCP, hooks, canales, rutinas y artefactos. Ninguna viene explicada, todas suenan a lo mismo, y la decisión de cuál te toca la tomas en el minuto uno, antes del primer archivo.

Lo más común es armar un subagente para algo que era un archivo de texto, o un servidor MCP para algo que resolvía un script de veinte líneas. Nadie te avisa en el momento, porque las dos cosas funcionan: el día que las estrenas hacen exactamente lo que les pediste.

El costo no se ve el primer día. Se ve al mes, cuando la sesión arranca pesada, cuando el modelo empieza a elegir mal seguido entre piezas que se llaman parecido, y cuando abres una carpeta del proyecto y ya nadie se acuerda de por qué está ahí ni si se puede borrar.

Lo que se termina construyendo, y lo que el caso pedía

Cuatro casos que se repiten. En los cuatro la pieza elegida funciona; el problema es que había otra más chica que hacía lo mismo y se deshace en un minuto.

lo que se construye

La pieza grande

  • Un subagente propio, con su archivo en la carpeta de agentes, porque la tarea lee cuarenta archivos y no querías ese ruido en la conversación.
  • Un servidor MCP que envuelve la API entera, con cuarenta herramientas expuestas por si alguna vez sirve alguna.
  • Un plugin con su manifiesto y sus carpetas vacías, para una sola skill que usas tú y nadie más.
  • Una skill nueva para que Claude se acuerde de usar pnpm en lugar de npm.

lo que pedía el caso

La pieza que alcanzaba

  • Una línea en el frontmatter de la skill que ya tenías: correr aparte dejó de ser un archivo y pasó a ser un campo.
  • Las operaciones que alguien pidió de verdad. El servidor completo no te cubre más: te hace elegir peor.
  • La carpeta suelta, sin manifiesto. El plugin recién suma cuando algo tiene que viajar a otra máquina.
  • Una línea en el CLAUDE.md. Ahí no había ninguna pieza que construir.

Las once veces que la pieza no era la del caso, cada una con lo que va en su lugar, están más abajo en esta misma página. Aquí importa solo el patrón: la pieza que suena importante casi nunca es la que el caso pedía.

el sesgo por defecto

La pieza más chica que resuelve el problema es casi siempre la correcta

Esta guía tiene un sesgo y conviene ponerlo por delante en vez de dejarlo escondido entre las recomendaciones: cuando dos formas resuelven lo mismo, gana la más chica.

El argumento no es de gusto. La pieza más chica también es la más fácil de tirar cuando te equivocaste, y te vas a equivocar. Una línea en un archivo se borra en segundos, y una carpeta suelta en el proyecto casi igual de rápido. Un plugin que ya repartiste a tres personas, o un servidor MCP con una credencial guardada de su lado, no.

Elegir de más no se paga el día que construyes. Se paga el día que quieres deshacerlo.

Qué es Claude Anatomy, en una frase

Claude Anatomy es una skill que se instala en Claude Code, en la app de Claude o en las dos, y que no escribe código. Interroga tu caso y te devuelve una sola pieza: qué construir, el motivo en una frase y el esqueleto de archivos ya nombrado con tu caso adentro.

Las piezas que puede recomendarte son diez: una skill —y en cuál de sus cuatro modos—, un subagente, un hook, un servidor MCP, un plugin, una rutina, un artefacto, una app con el Agent SDK, una línea en el CLAUDE.md, o nada.

Y empieza donde casi ninguna guía empieza: preguntando si hace falta construir algo. Buena parte de los casos se cierran ahí mismo, y cuando eso pasa todavía te dice cuál de las salidas te toca: una regla que solo aplica a ciertos archivos, algo publicado que se instala en lugar de escribirse, un estilo de salida, o un script sin modelo adentro. Cuando la respuesta es que no construyas nada, lo dice en lugar de inventarte una pieza.

No enseña a escribir cada pieza. Enseña a elegir cuál.

El repositorio de la skill, si quieres leerla antes de instalarla: github.com/Hainrixz/claude-anatomy. Es markdown puro y licencia MIT.

antes de seguir

Si las nueve palabras todavía no te dicen nada

Esta página no explica qué es una skill, qué hace un servidor MCP ni en qué se diferencia un hook de un subagente. Da por hecho que ya conoces las palabras y se va directo a la parte difícil, que es elegir entre ellas.

Si al leer la lista de arriba sentiste que la mitad te sonaba a idioma ajeno, en la bóveda hay una guía que es exactamente lo que falta: el glosario, con cada pieza explicada desde cero, con analogías y sin dar nada por sabido. Léela primero y vuelve aquí. No es un requisito formal, pero esta página rinde el doble después de esa.

El glosario de las piezas, explicado desde cero: Anatomía de Claude. Vuelve cuando las nueve palabras te suenen familiares.

02 · el método

Cuatro pasos, y el primero intenta convencerte de no construir

El método son cuatro pasos y unas diez salidas posibles. No hace falta que te lo aprendas: la skill te lo va preguntando. Pero conviene leerlo una vez, porque el orden no es decorativo — cada paso descarta una familia entera de respuestas antes de dejarte pasar al siguiente.

Y hay un atajo. Tres preguntas se llevan la mayoría de los casos sin que tengas que recorrer nada.

el atajo

Las tres preguntas que más rinden

  • ¿Quién aprieta el botón? Tú, escribiendo algo. El modelo, cuando el tema aparece solo. Un evento de Claude Code, como guardar un archivo. El reloj. Un sistema de afuera. O nadie, porque es una regla que Claude tiene que saber siempre.
  • ¿Toca algo de afuera que pida su propia credencial? Una base de datos, una API, la cuenta de un servicio.
  • Cuando termina, ¿qué queda y quién lo mira? Texto en tu terminal. Una pantalla que alguien abre en el navegador. Archivos cambiados en el repositorio. Una respuesta que consume otro programa.

La tercera es la que más se olvida, y es la que decide lo más grande de todo: si esto vive adentro de una sesión o no. Cuando la contestas al final, lo normal es tener que rehacer la elección desde cero.

El árbol completo, paso por paso

Se lee de arriba abajo, y dentro de cada paso la primera pregunta que da que sí lo cierra: las de abajo ya no se leen. Por eso el orden pesa tanto como las preguntas.

0

¿Hace falta construir algo?

  1. 0.1¿Lo que falta es que Claude se acuerde de una regla tuya?

    Usa pnpm y no npm. Corre las pruebas antes de subir nada.

    No construyas ninguna pieza: es una línea en el CLAUDE.md. Y si la regla aplica solo a ciertos archivos, va como regla por ruta, para que entre nada más cuando Claude toca esos archivos.

  2. 0.2¿Ya lo hizo otro?

    GitHub, Slack, Postgres, Notion y Sentry ya tienen servidor MCP publicado, y hay plugins hechos para buena parte del resto.

    No construyas nada. Instálalo.

  3. 0.3¿Lo que te molesta es cómo te contesta, y no lo que sabe?

    Quieres otro tono, más explicación, que siempre arranque con un diagrama.

    Eso no es una skill: es un estilo de salida. El detalle que confunde a todos es que se lee una sola vez al arrancar, así que el cambio recién se nota cuando limpias la conversación y empiezas otra.

  4. 0.4¿Lo resuelve un script, sin modelo adentro?

    Si siempre se hace igual y no hay nada que decidir en el camino, no hace falta un modelo pensando.

    Escríbelo, y Claude lo corre cuando haga falta. Si las cuatro dieron que no, ahora sí sigues al Paso 1.

Buena parte de los casos que llegan aquí terminan en este paso, y no es una broma. Si alguna de las cuatro dio que sí, ya está resuelto y no hay carpeta que crear.

1

¿Adentro de una sesión, o afuera?

  1. 1.1¿Lo que se entrega es una pantalla que alguien mira o comparte, y no texto en la terminal?

    Un tablero, un informe con gráficos, un diff anotado.

    Artefacto: una página que Claude publica desde la sesión y que se actualiza en el mismo link cada vez. El límite, antes de que te ilusiones: es UNA página sin backend. No guarda formularios y no tiene rutas. Si necesitas eso, es una app y la hospedas tú.

  2. 1.2¿Lo va a usar gente que nunca abre Claude Code, desde tu web o tu producto?

    Tus clientes, tu equipo de soporte, cualquiera que solo ve la pantalla de tu producto.

    App con el Agent SDK. Carga tu carpeta .claude igual que Claude Code, así que lo que ya escribiste sirve adentro: por eso conviene probar la idea como skill antes de armar la app.

  3. 1.3¿Tiene que correr con tu computadora apagada?

    Cada noche, cada lunes a primera hora, el día 1 de cada mes.

    Rutina en la nube. Corre sobre un clon limpio y no lee la carpeta de skills de tu máquina — esa es exactamente la trampa de la sección 05. Si las tres dieron que no, sigues al Paso 2.

Este paso lo ordena la tercera pregunta del atajo. Si nadie iba a estar mirando cuando termine, la respuesta casi nunca está entre las piezas clásicas.

2

Qué pieza

  1. 2.1¿Tiene que pasar SIEMPRE, sin que el modelo decida?

    Formatear después de cada edición. Frenar un comando peligroso antes de que se ejecute.

    Hook. Una instrucción escrita es un pedido que se puede ignorar; el hook es la única forma de garantizarlo.

  2. 2.2¿Necesita entrar a un sistema de afuera con su propia credencial?

    Una base de datos, la API de un proveedor, la cuenta de un servicio que ya pagas.

    Servidor MCP. Y si además hay criterio que aplicar sobre lo que trae, arriba va una skill: son dos piezas, y el MCP se construye primero porque la otra no sirve sin él.

  3. 2.3¿Es un trabajador reusable al que vas a llamar por su nombre desde varios lugares?

    El que revisa seguridad, el que escribe las pruebas, el que resume una carpeta entera.

    Subagente propio. Y aquí está el dato que decide muchos casos: un subagente no te puede preguntar nada a mitad de camino. Si el trabajo necesita confirmar algo contigo, no es esto.

  4. 2.4Si ninguna de las tres dio que sí, lo que queda es una skill.

    Falta el modo, que es quién la dispara y dónde corre. Eso está más abajo, en la sección 08.

Casi todas las piezas pueden hacer casi lo mismo. Lo que de verdad las separa no es qué pueden, sino qué te cobran y en qué momento — y eso es la sección 10.

3

¿Se empaqueta?

  1. 3.1¿Te salieron dos o más piezas que se instalan juntas o no sirven? ¿O lo mismo tiene que andar en otro repositorio, o en la máquina de otra persona?

    Un servidor MCP con la skill que lo usa arriba. Algo que le vas a pasar a tu equipo.

    Plugin. Y si además vas a repartir varios, arriba va un catálogo, que es un archivo declarado en un repositorio de git.

  2. 3.2Si no, déjalo suelto en la carpeta .claude del proyecto.

    Un plugin de una sola pieza que usas solo tú es un manifiesto de más: te agrega un paso de instalación y no te devuelve nada.

Este paso se contesta siempre al final, cuando ya sabes qué pieza es. Empaquetar antes de saber qué estás empaquetando es de donde salen los plugins de una sola skill.

El Paso 0 es el que casi nadie corre por su cuenta, porque cuando llegas hasta aquí ya decidiste que quieres construir algo. Este prompt le pide a la skill que lo recorra completo antes de recomendarte nada, y que sea dura contigo.

Antes de construir nada

El paso que casi nadie corre. Le pides que intente convencerte de NO construir antes de recomendarte una pieza.

Antes de recomendarme ninguna pieza, córreme el Paso 0 completo sobre este caso y sé duro conmigo.

Quiero que revises, en este orden, si lo que necesito se resuelve sin construir nada:

1. ¿Es solo que Claude se acuerde de una regla mía? Si sí, dime la línea exacta que va en el CLAUDE.md, y si la regla aplica solo a ciertos archivos dime cómo dejarla como regla por ruta.
2. ¿Ya existe algo publicado que haga esto? Si sí, dime qué instalar en vez de construirlo.
3. ¿Lo que me molesta es CÓMO me contesta y no lo que sabe? Si sí, eso es un estilo de salida, no una skill.
4. ¿Lo resuelve un script sin modelo adentro? Si siempre se hace igual y no hay nada que decidir, dime que es un script y escríbelo.

Solo si las cuatro dan que no, sigue al resto del árbol.

MI CASO:
[Descríbelo aquí en dos o tres frases.]

si te faltan las palabras

Aquí se elige la pieza; qué es cada una está en otra página

El árbol da por hecho que las nueve palabras ya te suenan, porque su trabajo es decirte cuál te toca, no qué son. Si al leer una salida te quedaste con la duda de qué es exactamente un hook, un servidor MCP o un estilo de salida, esa mitad ya está escrita y explicada desde cero.

El glosario, pieza por pieza: Anatomía de Claude. Son dos páginas que se leen bien juntas: esa dice qué es cada cosa, esta dice cuál te toca.

Con esto ya puedes correr el árbol a mano sobre tu propio caso. Lo que sigue es instalar la skill que te hace las preguntas, y en Claude Code son dos comandos.

03 · instalación

Dos comandos, y el nombre depende de por dónde entraste

empieza por aquí

Cuál de las tres secciones te toca

Vienen tres secciones de instalación seguidas y no necesitas las tres: necesitas la tuya. Busca abajo cómo trabajas y salta directo.

  • Trabajas en la terminal, en VS Code o en JetBrains con Claude Code → esta misma sección, y con eso terminas.
  • Usas Claude en el navegador, en la app de escritorio o en el celular → salta a la sección 04. Aquí no hay nada para ti: allá no se escriben comandos, se sube un archivo.
  • Usas Cowork, o quieres que una rutina la use cuando tu computadora está apagada → haz la 04 primero y después lee la 05, que es corta y trae la única advertencia que de verdad importa.
  • Usas las dos cosas, terminal y app → hazlas las dos. No se heredan entre sí: instalarla en un lado no la pone en el otro.

La sección 07 sirve para las tres y conviene no saltársela: es la que te dice cómo confirmar que quedó puesta, que es distinto de haberla instalado.

Esta es la ruta principal y la más corta. Dos líneas dentro de Claude Code y la skill queda puesta: no hay instalador que bajar, ni archivo de configuración que editar, ni una llave que pegar en ningún lado.

Se escriben dentro de Claude Code, no en la terminal del sistema, y van en este orden. El segundo no encuentra nada si no corriste el primero.

Los dos comandos, en este orden

1 · Agregar el catálogo donde vive la skill

/plugin marketplace add Hainrixz/claude-anatomy

2 · Instalar el plugin desde ese catálogo

/plugin install claude-anatomy@claude-anatomy

El nombre repetido del segundo no es un error de dedo. A la izquierda del arroba va el plugin y a la derecha el catálogo del que sale, y en este caso los dos se llaman igual.

qué pasa al correr el segundo

No instala de una: primero te pregunta el alcance

  • El segundo comando abre una vista de detalle del plugin, con lo que trae adentro.
  • Ahí eliges el alcance —este proyecto o tu usuario— y confirmas. Hasta que confirmas no se instaló nada.
  • Si el resumen que aparece después dice que hay que recargar para activarlo, corres el comando de abajo. Si no lo dice, ya quedó.

Solo si el resumen te lo pide

/reload-plugins

Si prefieres no agregar un catálogo

La misma skill viaja como un .zip de 40 KB en el release. Descargas el archivo, lo dejas en la carpeta de tu proyecto y corres estas dos líneas, esta vez sí en la terminal del sistema.

El archivo se llama anatomia-cc-v0.3.0.zip y está en el último release en GitHub.

1 · Crear la carpeta de skills del proyecto

mkdir -p .claude/skills

2 · Descomprimir el .zip dentro de esa carpeta

unzip anatomia-cc-*.zip -d .claude/skills/

El .zip trae la carpeta anatomia-cc en la raíz, así que al descomprimir queda en el lugar exacto y no hay nada que mover después. Esa misma forma es la que después exige el panel de la app, y por eso el mismo archivo sirve en los dos lados.

Proyecto o usuario

Es la única decisión real de esta sección, y la pregunta que te va a hacer la vista de detalle. Las dos rutas funcionan igual de bien: lo que cambia es a cuántos lugares alcanza y qué tan fácil es dar marcha atrás.

el default

Ruta de proyecto

  • Deja la skill viviendo dentro de ese repositorio y en ningún otro.
  • Si te arrepientes, borras la carpeta y no queda rastro.
  • Si trabajas en equipo y la dejas commiteada, le llega a quien clone el repo.

la otra

Ruta de usuario

  • Queda disponible en todos tus proyectos, abras el que abras.
  • Deshacerlo no es igual de directo: hay que acordarse de dónde quedó y sacarla de ahí a mano.
  • Tiene sentido si de verdad la quieres a mano siempre. Si es para probarla, no.

Por eso el default recomendado es proyecto: es la ruta que se deshace sin pensarla. Moverla después no cuesta nada.

Con qué nombre te queda

Este es el detalle que casi nadie publica y que se confirmó instalándola de verdad: el nombre con el que la puedes llamar cambia según la vía que usaste.

el nombre según la vía

suelta en .claude/skills/anatomia-cc/   →   /anatomia-cc
instalada como plugin                  →   /claude-anatomy:anatomia-cc

En los dos casos se dispara sola por su descripción: escribes tu duda en español y se activa sin que menciones nada. El nombre solo importa si la quieres llamar tú a mano, o si la buscaste y creíste que no había quedado instalada.

Y sí, la skill se llama anatomia-cc mientras que el repositorio y el plugin se llaman claude-anatomy. No es un descuido: hay una regla que prohíbe la palabra «claude» dentro del nombre de una skill, y está contada en la sección siguiente porque es ahí donde te muerde.

la trampa del nombre

La carpeta tiene que llamarse igual que la skill

En Claude Code el nombre con el que la invocas sale de la CARPETA, no del campo name del frontmatter: ese campo es solo la etiqueta que se ve en los listados. Así que si renombras la carpeta, la skill sigue cargando, pero cambia de nombre y la vas a buscar donde ya no está. Donde sí es obligatorio que los dos coincidan es al subir el .zip a la app, que es la sección siguiente: ahí la subida falla si no son iguales. Por eso conviene que digan lo mismo desde el principio.

Si prefieres no escribir comandos

También puedes pedírselo en español y que Claude Code haga el trabajo: clona el repositorio, copia la carpeta completa donde va, borra lo temporal y te confirma que el nombre coincide.

Instalarla sin tocar la terminal

Si prefieres no escribir comandos: se lo pides a Claude Code en español y él clona, copia la carpeta y te confirma que quedó.

Instálame esta skill en este proyecto: https://github.com/Hainrixz/claude-anatomy

Hazlo así:

1. Clona el repositorio en una carpeta temporal, fuera de mi proyecto.
2. Copia la carpeta skills/anatomia-cc completa —con sus subcarpetas references/ y assets/, no solo el SKILL.md suelto— dentro de .claude/skills/ de este proyecto, de modo que quede en .claude/skills/anatomia-cc/. Ojo con el nombre: la carpeta de la skill es anatomia-cc aunque el repositorio se llame claude-anatomy.
3. Borra la carpeta temporal cuando termines.
4. Confírmame que la carpeta quedó con el mismo nombre que el campo name del frontmatter. En Claude Code el nombre con el que la invoco sale de la carpeta, así que si no coinciden voy a buscarla mal; y si algún día subo el .zip a la app, ahí sí es obligatorio que sean iguales.
5. Dime con qué nombre me va a quedar disponible y qué tengo que hacer para que aparezca en esta sesión.

Antes de terminar, dime en una línea qué cambiaría si la hubiera instalado para todos mis proyectos en vez de solo en este, y cuál de las dos rutas es más fácil de deshacer.

hasta dónde llega esta página

La decisión de global o proyecto tiene su propia guía

Aquí va la versión corta, la que necesitas para instalar esta skill y seguir. La pregunta general —cuáles de tus skills conviene tener siempre encendidas y cuáles solo dentro de un repo— es un tema aparte y ya tiene dueño en la bóveda.

La regla completa para decidir dónde vive cada skill: Global, por proyecto y cómo decidir.

Cómo sacarla, que es la mitad que casi nunca se escribe

Esta página entera se apoya en que la pieza más chica es la más fácil de tirar cuando te equivocaste. Sería raro no decirte cómo se tira esta. Son tres comandos y ninguno pide confirmación de más, así que conviene leerlos antes de correrlos.

Quitar el plugin, dejando el catálogo registrado

/plugin uninstall claude-anatomy@claude-anatomy

Traer la versión nueva cuando salga una

/plugin marketplace update claude-anatomy

Quitar también el catálogo, si ya no lo usas para nada

/plugin marketplace remove claude-anatomy

el orden importa

Quitar el catálogo se lleva lo que instalaste de él

El tercer comando no borra solo una entrada de una lista: al quitar un catálogo se van con él los plugins que instalaste desde ahí. Si es el único plugin que sacaste de ese catálogo, da igual el orden. Si sacaste varios, quita primero el que no quieres y deja el catálogo en su lugar.

Si la instalaste como carpeta suelta en lugar de como plugin, no hay comando que correr: borras la carpeta anatomia-cc de donde la hayas dejado y desaparece. En el proyecto está dentro de .claude/skills/; si elegiste dejarla disponible en todos, está en la carpeta de skills de tu configuración de usuario. Por eso la ruta de proyecto es el default recomendado: es la que se deshace sin acordarte de nada.

O que lo haga él y te diga qué quedó

Lo incómodo de desinstalar a mano es que nunca sabes si quedó algo suelto en la otra ruta. Este prompt revisa las dos, quita lo que encuentra y te reporta qué tocó y qué no.

Sacarla sin dejar residuo

Para cuando la probaste y no era para ti, o para dejar limpia la máquina. Le pides que la quite entera y que te diga qué quedó, en vez de ir borrando carpetas a mano.

Quiero desinstalar por completo la skill de Claude Anatomy y dejar todo como estaba antes.

Hazlo en este orden y dime qué encuentras en cada paso:

1. Revisa si está instalada como plugin y, si lo está, desinstálala.
2. Revisa si quedó registrado su catálogo de plugins. Si ya no lo usa ningún otro plugin, quítalo también; y si sí lo usa alguno, avísame antes de tocarlo.
3. Busca si además quedó una copia suelta como carpeta, tanto en la carpeta de skills de este proyecto como en la de mi usuario. Si encuentras alguna, dime dónde está y bórrala solo si te confirmo.
4. Al final dime tres cosas: qué quitaste, qué dejaste, y si hace falta que reinicie o recargue algo para que deje de aparecer en esta sesión.

Si en algún paso no encuentras nada, dilo en lugar de asumir que ya estaba limpio.

Con esto ya la tienes en Claude Code. Las dos secciones que siguen son las otras dos superficies, y ninguna de las dos hereda lo que acabas de hacer aquí.

04 · instalación

Aquí no hay terminal: hay un .zip y un interruptor apagado

En la app de Claude no se escriben comandos. Se sube un archivo una sola vez y la skill queda disponible en el chat de las tres pantallas: navegador, escritorio y celular. Es el mismo .zip del release que usarías en la terminal, sin editarle nada.

El trámite completo toma un minuto y son cuatro toques. Lo que hace perder tiempo no es ninguno de los cuatro: es un interruptor apagado que esconde el panel donde van.

Primero el interruptor, después el archivo

el prerrequisito

Sin esto, el panel de skills no existe

Las skills viven detrás de la capacidad de ejecutar código. Si esa capacidad está apagada en tu cuenta, el panel donde se suben no aparece atenuado ni con un aviso que explique por qué: simplemente no está en el menú.

Buena parte del tiempo que se pierde en este paso es de gente buscando un botón que todavía no existe. Préndelo primero y lo demás sale en un minuto.

Los nombres del menú dependen del idioma en el que tengas la app. Si la tienes en inglés, el mismo camino es Settings → Capabilities y el interruptor se llama Code execution and file creation.

dónde se prende, en la app

Configuración  →  Capacidades
     └─ Ejecución de código y creación de archivos   ·   prendido

Los cuatro pasos

Con el interruptor prendido el panel ya está en su lugar, y lo que queda es bajar un archivo y elegirlo.

1

Baja el .zip del último release

Abre la página del último release y baja el archivo que se llama anatomia-cc-v0.3.0.zip. Pesa 40 KB. GitHub agrega también el código fuente comprimido: ese no es el que va, y se distingue porque tiene otro nombre.

2

Entra al panel de skills

En la app, abre Customize → Skills. En el escritorio lo tienes en la barra lateral; en el navegador y en el celular está dentro del menú de tu cuenta. El enlace de arriba te deja ahí directo, que es lo más rápido cuando el menú de tu app está en otro idioma y el nombre no coincide con el de esta guía.

3

Botón +, crear skill, subir una skill

Los tres toques van en ese orden y salen en la misma pantalla. No hay campo donde pegar texto: el panel solo acepta un archivo.

4

Elige el .zip y deja el interruptor prendido

Cuando termina de procesarlo, la skill aparece en la lista con un interruptor propio. Déjalo prendido: una skill subida pero apagada no se dispara nunca, y en la lista se ve casi igual que una que sí está puesta.

no lo descomprimas

El .zip es el formato, no el envoltorio

El panel espera un .zip, no una carpeta. Si lo descomprimes y tratas de subir los archivos sueltos, no vas a tener qué elegir.

Ese archivo ya trae la forma exacta que el panel pide: la carpeta de la skill en la raíz, con todo su contenido adentro. Por eso se sube tal como salió del release, sin abrirlo, sin renombrarlo y sin sacarle nada.

En qué planes funciona

Las skills están en los cinco planes de la app. Lo que cambia entre uno y otro no es la función: es quién tiene que dar permiso antes de que puedas subir algo.

planqué hace falta antes de subir el .zip
FreeSolo el interruptor de ejecución de código, prendido en tu propia cuenta.
ProLo mismo que en Free. Nada aparte.
MaxIgual que Pro: el panel de skills es el mismo y se sube igual.
TeamAdemás del interruptor, el dueño de la organización tiene que habilitar las skills en la configuración de la organización.
EnterpriseIgual que Team: el permiso de la organización va primero, y ese no lo prendes tú desde tu cuenta.

Si estás en Team o en Enterprise y el panel no te deja subir nada aunque tengas la ejecución de código prendida, revisa ese permiso antes de dar por rota la skill.

Por qué el mismo archivo sirve sin editarle nada

Que una skill funcione en la app y en la terminal no es automático. Las skills siguen un estándar abierto, Agent Skills, que admite seis campos de configuración arriba del archivo. Claude Code acepta bastantes más, y ahí está la trampa.

el estándar abierto

Seis campos, y ninguno más

  • name, el nombre de la skill, que tiene que ser igual al de su carpeta.
  • description, la frase por la que el modelo decide si le toca usarla.
  • license, bajo qué términos se puede usar y compartir.
  • compatibility, con qué versiones dice llevarse.
  • metadata, datos sueltos del autor, como el número de versión.
  • allowed-tools, qué herramientas puede tocar mientras corre.

solo en claude code

Los que tumban la subida

  • context, para que corra aparte y no te llene la conversación.
  • disable-model-invocation, para que solo se dispare cuando tú la llamas.
  • argument-hint, el texto de ayuda que aparece al escribir el comando.
  • Y cualquier otro campo que no esté en los seis de la izquierda.

Un campo de más no se ignora en silencio: la subida falla con un error duro y el archivo se queda afuera. Esta skill usa cuatro campos y los cuatro están en el estándar, así que por ese lado entra sin tocarle nada.

Guárdate el dato para cuando subas otras skills. Si una tuya funciona bien en Claude Code y el panel de la app la rechaza, esa lista de campos es lo primero que hay que mirar. Lo segundo está aquí abajo, y es más tramposo.

la regla que casi nadie publica

El nombre de la skill no puede contener «claude»

Los campos no son lo único que revisa la subida. El nombre también, y esta regla no sale en la mayoría de los tutoriales: el campo name de un SKILL.md no puede contener las palabras reservadas «claude» ni «anthropic». Da lo mismo que la skill funcione perfecto en la terminal, porque Claude Code no aplica esa restricción: el panel de la app sí, y rechaza el archivo entero.

Esta skill se llevó ese golpe en vivo. Se llamaba claude-anatomy, se instalaba sin una queja en Claude Code, y al subir el .zip el panel contestó esto:

lo que contesta el panel

Skill name in SKILL.md cannot contain the reserved word 'claude'.

Por eso la skill se llama anatomia-cc mientras el repositorio, el plugin y esta misma guía siguen llamándose claude-anatomy. La restricción es solo del campo name y del nombre de su carpeta: la marca, la dirección del repo y el comando del plugin no la tocan.

Si vas a escribir una skill que algún día quieras subir a la app, elige el nombre pensando en esto desde el primer día. Cambiarlo después obliga a renombrar la carpeta, rehacer el .zip y publicar una versión nueva, y a corregir cada lugar donde estaba escrito el nombre viejo.

el otro requisito del nombre

La carpeta dentro del .zip tiene que llamarse igual que la skill

Es la segunda causa de rechazo y se ve idéntica a la primera. Dentro del .zip tiene que haber una carpeta —no los archivos sueltos— y esa carpeta tiene que decir exactamente lo mismo que el campo name. En este caso las dos dicen anatomia-cc. Si descomprimes el archivo para curiosear y lo vuelves a comprimir, macOS suele meter los archivos en la raíz o agregar una carpeta de más: ahí es donde se rompe. Sube el .zip tal como lo bajaste.

Qué cambia respecto a Claude Code

En la terminal la skill te da la recomendación y el esqueleto de archivos, y sigues de largo construyendo ahí mismo. En la app te da exactamente lo mismo, pero como texto: te sirve para decidir y para entender, y después vas a Claude Code a construirlo.

Aun así vale la pena tenerla en los dos lados, porque la duda casi nunca aparece frente a la terminal. Aparece antes: pensando el problema desde el celular, o explicándoselo a alguien que te pregunta si eso es una skill o un subagente.

Cómo saber que quedó activa, si aquí no hay comandos

Aquí no existe un prompt para instalarla, y conviene decirlo en lugar de inventar uno: en la terminal le pides a Claude Code que clone y copie archivos porque tiene manos para hacerlo, y en la app no las tiene. La subida es un archivo que eliges tú en una pantalla, y no hay forma de pedírsela por escrito.

Lo que sí se resuelve con un prompt es lo de después. Como en la app tampoco hay comandos con diagonal, no puedes escribir su nombre para ver si está: la única señal fiable es darle un caso y mirar la forma de la respuesta.

Comprobar que quedó activa, en la app o en Cowork

Ahí no hay comandos con diagonal, así que no puedes escribir su nombre para ver si está. Este prompt lo averigua sin depender de eso: le das un caso de prueba y miras la forma de la respuesta.

Tengo un caso y quiero que me digas qué construir para resolverlo.

Necesito revisar cuarenta archivos de mi repositorio buscando problemas de seguridad, y que solo me traigas los hallazgos, sin el ruido de los archivos que están bien.

Contéstame con este formato exacto:

1. La pieza recomendada, UNA sola, con el motivo en una frase y el número de la pregunta del árbol que la decidió.
2. Si es una skill, en cuál de sus cuatro modos va.
3. El árbol de archivos de esa pieza, ya nombrado con mi caso.
4. Qué de esto NO hace falta construir.

Si contesta con una pieza, el número de la pregunta que la decidió y un árbol de archivos, la skill cargó. Si contesta con una explicación general sobre las opciones que existen, no cargó — y lo más probable es que el interruptor esté apagado.

cómo se saca

Apagarla y quitarla son dos cosas distintas

En el mismo panel donde la subiste, cada skill tiene su interruptor. Apagarlo la deja instalada pero fuera de juego: no se dispara y no te cuesta contexto, y la puedes volver a prender cuando quieras sin subir nada otra vez. Es lo que conviene para probar si algo mejora o empeora con ella puesta.

Quitarla del todo es la otra opción del mismo renglón, y esa sí borra el archivo de tu cuenta: para volver a tenerla hay que subir el .zip de nuevo. Como se administra a nivel de cuenta, lo que quites aquí desaparece también de Cowork, que es la sección siguiente.

si llegaste desde una red social

El .zip no baja dentro de Instagram ni de TikTok

Si estás leyendo esto en el navegador que abre la app de Instagram, Facebook o TikTok, el enlace del release va a abrir la página pero el archivo no se guarda en ninguna parte. Toca los tres puntos, elige abrir en Safari o en Chrome, y desde ahí sí baja.

si quieres el flujo desde cero

Aquí va solo lo que esta skill necesita

Esta sección da por hecho que ya sabes qué es una skill y solo quieres poner esta. El paso a paso general de la subida, con las skills que ya vienen puestas y qué revisar cuando algo no carga, tiene su propia guía en la bóveda.

El flujo de subida explicado desde cero: la guía de skills de Claude.

Con el archivo arriba y su interruptor prendido, la skill ya está en el chat de las tres pantallas. Lo que sigue es la parte que casi nadie revisa, y donde está la trampa que hace perder una tarde.

05 · instalación

Cowork ya la tiene. La rutina va a decir que no existe.

Esta es la más corta de las tres secciones de instalación, y por una razón sencilla: aquí no hay nada que instalar. Cowork usa las skills habilitadas en tu cuenta de claude.ai, así que si subiste el .zip en el paso anterior, ya la tienes en los dos lados.

Es el mismo interruptor de siempre: lo que enciendes en el panel de tu cuenta es lo que ve Cowork. Por eso la sección es corta. Lo que viene después no es cómo instalarla, es la advertencia.

la buena noticia

No hay un paso aparte

  • Subirla una vez en el panel de tu cuenta la deja disponible en el chat y en Cowork. No se sube dos veces ni hay un segundo panel escondido.
  • Las skills se sincronizan al arrancar la sesión. Si la habilitaste con una sesión de Cowork ya abierta, lo más probable es que tengas que empezar otra para que aparezca.
  • Se administran desde Customize, en la barra lateral de la app de escritorio, o desde el panel de skills de claude.ai. Es la misma lista vista desde dos puertas.

la trampa

Esto es lo que hace perder una tarde

Cowork, las sesiones en la nube y las rutinas no leen la carpeta de skills de tu máquina. Si la instalaste solo ahí, una rutina que la invoque va a responder que la skill no existe.

No es un error de escritura ni un problema de permisos: cada corrida arranca como una sesión remota nueva, y esa sesión nunca vio tu disco. Puedes tener la carpeta perfecta en tu computadora y seguir viendo el mismo mensaje toda la tarde.

Las dos salidas

  • Habilítala en tu cuenta de claude.ai. Es la salida que sirve siempre, y es exactamente lo que hiciste en la sección anterior.
  • O, si se trata de una sesión en la nube sobre un repositorio, déjala commiteada en el .claude/skills/ de ese repo: ahí viaja con el código y la sesión sí la encuentra.

La excepción son las tareas programadas del escritorio: corren en tu máquina y leen lo mismo que cualquier sesión local. Si tu automatización es de esas, con la instalación de Claude Code alcanza.

Ahí no existen los comandos con diagonal

Ni en el chat ni en Cowork hay comandos con diagonal para skills. La skill se aplica sola cuando la tarea encaja con su descripción, y no tienes forma de llamarla por su nombre.

Eso cambia cómo la usas, no si funciona. En lugar de invocarla, describes tu caso —qué ibas a construir y para qué— y ella entra cuando reconoce el problema. En Claude Code también se dispara sola casi siempre; la diferencia es que allá, además, la puedes forzar.

También cambia cómo compruebas que está puesta, y por el mismo motivo: sin comandos con diagonal no puedes escribir su nombre para ver si responde. El prompt de comprobación de la sección anterior sirve igual aquí, porque no depende de llamarla por su nombre sino de mirar la forma de lo que contesta. Y para quitarla es el mismo panel de la cuenta: lo que apagues o borres allá desaparece de Cowork sin que tengas que entrar aquí a nada.

Las tres superficies, una al lado de la otra

El resumen de las secciones 03, 04 y 05 en una sola vista. Si te llevas una sola cosa, que sea la última columna: fuera de Claude Code lo que recibes es la decisión escrita, no el archivo.

superficiedónde vive la skillcómo la disparasqué te devuelve
Claude CodeEn el .claude/skills/ del proyecto, en tu carpeta de usuario, o instalada como plugin.Sola, por su descripción. Y si la quieres forzar: /anatomia-cc cuando está suelta, o /claude-anatomy:anatomia-cc cuando entró como plugin.La recomendación con el motivo en una frase y el esqueleto de archivos ya nombrado, en la misma sesión donde vas a construir.
La app de ClaudeEn el panel de skills de tu cuenta, subida como .zip.Sola, cuando la tarea encaja con su descripción. Ahí no hay comandos con diagonal.Lo mismo, pero como texto para leer y decidir. El archivo lo escribes después en Claude Code.
Cowork y la nubeEn la misma cuenta que la app. Para una sesión sobre un repositorio, también sirve commiteada en el .claude/skills/ de ese repo.Sola también, y las rutinas la aplican igual mientras esté habilitada en tu cuenta. No hay nada que escribir.Texto, igual que en el chat: la decisión sale ahí y la construcción se hace en Claude Code.

Que fuera de Claude Code no construya nada no la deja sin uso. La duda de qué pieza te toca suele aparecer antes de abrir la terminal, y esa es justo la que resuelve.

el recorrido largo

Cowork pantalla por pantalla está en otra guía

Esta sección va al grano porque el paso a paso completo ya tiene dueño en la bóveda. Si nunca abriste el panel de skills dentro de Cowork y prefieres verlo pantalla por pantalla —dónde está el botón, qué se ve al habilitar una, y también la ruta de plugins— ahí está entero y con capturas.

Aquí queda solo lo que es específico de esta skill: que no hay un paso aparte, que la trampa de la nube existe, y cuáles son las dos salidas.

El paso a paso dentro de Cowork: Modo TDAH · Claude directo al grano.

Con esto la tienes en las tres superficies. Lo que sigue es qué la despierta y qué te contesta cuando lo hace.

06 · el uso

No hay comando que aprender: escribes la duda

Esta es la parte donde otras herramientas te piden memorizar algo. Aquí no. La skill se activa sola por su descripción: escribes la pregunta que ibas a escribir igual, con las palabras que ya usabas, y ella entra a la conversación cuando reconoce el tema.

Eso cambia el momento en que la usas, que es lo que de verdad importa. No es algo que abres cuando te acuerdas de que lo instalaste: aparece justo cuando dudas, que es el minuto exacto en que la decisión se toma mal.

Las frases que la despiertan

Todas estas son cosas que alguien escribe de todos modos cuando está trabado. Ninguna es un comando y ninguna hay que copiarla textual.

  • «esto lo hago como skill o como agente»
  • «necesito un MCP o alcanza con una skill»
  • «esto va como comando o como skill»
  • «quiero que esto salga como una pantalla que le pueda mandar a alguien»
  • «quiero meter esto adentro de mi app»
  • «quiero que corra solo todas las noches»
  • «por dónde empiezo»

También dispara en inglés. Una frase como «should I build this as a skill or an agent» la despierta igual, sin que tengas que cambiar de idioma a propósito.

cómo funciona el disparo

No son palabras mágicas

La lista de arriba muestra la forma, no una fórmula. Lo que la skill reconoce es el tema —estás dudando entre dos maneras de construir lo mismo—, así que sirve cualquier redacción tuya, en cualquier orden y con las palabras que uses normalmente.

Y no hace falta que la duda esté bien planteada. Si lo único que tienes es que algo se siente demasiado grande para lo que querías hacer, con escribir eso alcanza.

El disparo más común es literalmente ese: la duda tal cual, con dos líneas de contexto debajo para que no tenga que adivinar de qué hablas.

La duda de siempre, tal cual

El disparo natural. No hay comando que aprender: escribes la pregunta que ya tenías y la skill se activa sola.

Esto lo hago como skill o como agente?

Lo que quiero es que cada vez que abra un proyecto de un cliente, Claude ya sepa cómo cobramos, qué plantilla de propuesta usamos y con qué tono le escribimos a esa persona en particular.

Si prefieres saltarte el ida y vuelta, contesta de entrada las tres preguntas que más rinden: quién aprieta el botón, si toca algo de afuera que pida su propia credencial, y qué queda cuando termina y quién lo mira. La tercera es la que casi todos olvidan, y es la que decide si esto vive adentro de una sesión o fuera de ella.

El caso completo, para que acierte a la primera

La versión larga. Contestas de entrada las tres preguntas que más rinden y la skill no tiene que sacarte la información a cuentagotas.

Quiero decidir qué construir en Claude Code para este caso. Te contesto de entrada lo que sé, y si te falta algo pregúntame antes de recomendar.

QUÉ QUIERO QUE PASE
[Describe aquí, en dos o tres frases y sin usar ninguna palabra técnica, qué quieres que ocurra. Habla del resultado, no de la herramienta.]

QUIÉN APRIETA EL BOTÓN
[Elige uno: yo, escribiendo algo / el modelo, cuando el tema aparece solo / un evento de Claude Code, como guardar un archivo / el reloj, a una hora fija / un sistema de afuera / nadie, es una regla que Claude debe saber siempre.]

¿TOCA ALGO DE AFUERA QUE PIDA SU PROPIA CREDENCIAL?
[Una base de datos, una API, la cuenta de un servicio. Si no toca nada de afuera, dilo.]

CUANDO TERMINA, ¿QUÉ QUEDA Y QUIÉN LO MIRA?
[Elige uno: texto en mi terminal / una pantalla que alguien abre en el navegador / archivos cambiados en el repo / una respuesta que consume otro programa.]

Dame UNA sola pieza recomendada, el motivo en una frase, y el árbol de archivos ya nombrado con mi caso. Si el caso se reparte en dos piezas, dime cuál se construye primero y por qué.

Qué te devuelve

La respuesta tiene una forma fija. No es un ensayo sobre las opciones ni una tabla comparativa para que elijas tú: son cuatro cosas, siempre en este orden.

1

La pieza, una sola

Nombra una pieza y solo una, con el motivo en una frase y el número de la pregunta del árbol que la decidió. Si la respuesta es una skill, también te dice en cuál de los cuatro modos va.

2

El árbol de archivos, ya con tus nombres

No un ejemplo genérico que después tengas que traducir a tu caso: las carpetas y los archivos nombrados con lo que acabas de describir, listos para completar.

3

El orden, cuando son dos piezas

Si el caso se reparte, dice cuál se construye primero y por qué la otra no sirve sin ella. Ese orden no es una preferencia de estilo: al revés no funciona.

4

Lo que no hace falta construir

Si viniste a pedir un plugin y te vas con una línea en el CLAUDE.md, eso se dice con todas las letras en lugar de recomendarte algo para que no te vayas con las manos vacías.

Un ejemplo, de la pregunta a la carpeta

Pides revisar cuarenta archivos buscando problemas de seguridad y que te traiga solo los hallazgos. La respuesta que casi todos esperan es un subagente. La que sale del árbol es una skill que corre en un subagente, y la diferencia entre las dos es una línea de configuración en lugar de un archivo aparte que después hay que mantener.

así se ve la respuesta

tú    › quiero revisar cuarenta archivos buscando
        problemas de seguridad y que me traiga
        solo los hallazgos

skill › Paso 2, pregunta 2.4 → es una SKILL,
        con context: fork.

        Corre en un subagente, así que los cuarenta
        archivos no entran a tu conversación.

        No hace falta escribir un subagente aparte:
        aislar el contexto dejó de ser un archivo y
        pasó a ser una línea del frontmatter.

        revision-de-seguridad/
          SKILL.md
          references/

Fíjate en el número de la pregunta. Está ahí para que puedas ir al árbol, ver por dónde pasó tu caso y discutir el paso exacto si no estás de acuerdo, en lugar de aceptar la recomendación porque sí.

Y así se ve cuando no le das todo de entrada

El ejemplo de arriba es el caso corto, porque la pregunta ya venía con lo que hacía falta para contestarla. La mayoría de las veces no es así: escribes lo que quieres que pase y todavía faltan las tres cosas que deciden. Ahí es donde la skill interroga en lugar de adivinar.

Este es el recorrido completo de un caso que llega crudo. Fíjate que no pregunta por gusto: cada una de las tres respuestas mueve el resultado a otro lado del árbol.

un caso que llega sin contexto

tú    › quiero que cuando entre un ticket de soporte,
        Claude lo lea y me avise si es urgente

skill › Antes de recomendarte nada, tres preguntas.
        ¿Quién aprieta el botón? ¿Tú, cuando te
        acuerdas de revisar, o tiene que pasar solo?

tú    › solo, cuando entra el ticket

skill › ¿De dónde salen los tickets? ¿Hay que entrar
        a algún sistema con su propia credencial?

tú    › sí, están en Zendesk

skill › Cuando termina, ¿qué queda y quién lo mira?

tú    › un mensaje en Slack para mí

skill › Paso 2, pregunta 2.2 → son DOS piezas, y el
        orden no es opcional.

        1. Servidor MCP, primero. Guarda la
           credencial de Zendesk de su lado y expone
           las operaciones que pediste: leer los
           tickets nuevos y mandar el aviso.

        2. Skill, encima. El criterio de qué es
           urgente, que es lo que sabes tú y la
           API no.

        Al revés no funciona: la skill sola no entra
        a Zendesk por más que se lo escribas.

        tickets-urgentes/
          SKILL.md
          references/criterio-de-urgencia.md

Son tres preguntas, no doce, y son siempre las mismas: quién dispara, si hay una credencial de por medio, y qué queda al final. Si contestas las tres de entrada —que es lo que hace el segundo prompt de arriba— se salta el ida y vuelta y va directo al veredicto.

El detalle que más cambia el resultado es el segundo. Sin Zendesk de por medio, ese mismo caso habría terminado en una sola pieza. La credencial es lo que lo parte en dos, y por eso vale la pena contestar esa pregunta con cuidado.

Cuando el caso se parte en dos

El error más caro de esta guía no es elegir la pieza equivocada: es meter dos trabajos distintos adentro de una sola. Entrar a un sistema de afuera que pide su propia credencial es un trabajo; aplicar criterio sobre lo que ese sistema trae es otro. Cuando tu caso tiene los dos, son dos piezas, y cuál va primero no es opcional.

Cuando el caso se parte en dos

El caso que más se hace mal: algo que necesita entrar a un sistema de afuera y además aplicar criterio. Son dos piezas, y el orden importa.

Creo que este caso no es una sola pieza. Quiero que me lo separes.

Si de verdad son dos, dime:

1. Cuál es la pieza de abajo, la que toca el sistema de afuera y guarda la credencial.
2. Cuál es la pieza de arriba, la que aplica el criterio sobre lo que trae la de abajo.
3. Cuál construyo primero y por qué la otra no sirve sin ella.
4. Qué operaciones concretas expone la de abajo. No quiero que envuelvas la API entera por si acaso: solo lo que pedí.

Y si me equivoqué y en realidad es una sola pieza, dímelo sin rodeos.

MI CASO:
[Descríbelo aquí, incluyendo a qué sistema de afuera hay que entrar y qué decisión hay que tomar con lo que traiga.]

Eso es todo lo que hay que saber para usarla. Lo que sigue es cómo confirmar que de verdad quedó puesta en la superficie donde la instalaste, en lugar de darlo por hecho y descubrirlo el día que la necesitas.

07 · el chequeo

Instalado no quiere decir encendido

Cuando una skill no queda bien puesta no hay error, no hay aviso en rojo y no hay nada que se vea distinto. Le preguntas algo a Claude, te contesta bien, y la skill nunca entra. Por eso conviene gastar treinta segundos en confirmarlo ahora, en la superficie donde vas a trabajar, y no descubrirlo a mitad de un caso real.

Cada superficie se revisa distinto. Estas son las tres, y después la prueba que funciona en cualquiera de ellas.

1

En Claude Code: escribe anat en el menú de barra

Abre el menú de comandos con la barra diagonal y escribe anat. Si la skill está, aparece en la lista mientras vas escribiendo.

El nombre cambia según cómo la instalaste: suelta en la carpeta de skills sale corto, y como plugin sale con el prefijo del plugin delante. Los dos son válidos; lo que importa es que aparezca alguno.

Si no aparece y acabas de instalarla como plugin, lo que suele faltar es recargar. Corre /reload-plugins y vuelve a mirar.

Y si prefieres no depender de recordar el nombre, pregúntaselo a Claude directamente: pídele que te diga si tiene disponible la skill de anatomía. Esa comprobación sirve igual y no exige acordarse de nada.

2

En la app de Claude: dos cosas distintas que se confunden

Entra al panel de skills de tu cuenta y confirma dos cosas que casi todo el mundo trata como una sola.

La primera: que la skill aparezca en la lista. Eso quiere decir que el archivo subió y pasó la validación.

La segunda: que su interruptor esté prendido. Una skill puede estar subida y apagada, y apagada se comporta exactamente igual que si no existiera.

Si no encuentras el panel por ningún lado, lo que falta es el prerrequisito de la sección 04: mientras la ejecución de código y creación de archivos esté desactivada, ese panel no está.

3

En Cowork y en la nube: mira el interruptor y luego pruébalo

No hay una instalación aparte que revisar. Las sesiones cargan las skills que tienes habilitadas en tu cuenta y las sincronizan al arrancar, así que el chequeo es el mismo interruptor del punto anterior, mirado en vez de asumido.

La prueba real es lanzar una tarea que debería dispararla y ver si la aplica. Si la corrida resuelve el caso sin nombrar ninguna pieza y sin proponer un esqueleto de archivos, no la cargó.

En una rutina, la señal de que te alcanzó la trampa de la sección 05 es literal: la corrida dice que la skill no existe. Eso pasa cuando la dejaste solo en la carpeta de tu máquina, porque cada corrida arranca como una sesión remota nueva y esa carpeta no viaja con ella.

en claude code · los dos nombres posibles

/anatomia-cc                  suelta en .claude/skills/
/claude-anatomy:anatomia-cc   instalada como plugin

En los dos casos la skill también se dispara sola por su descripción. Escribir el nombre es la forma de comprobar que está, no la forma de usarla.

La prueba que sirve en las tres

Pídele a Claude que te resuma qué haría con un caso de prueba concreto, algo tuyo y de una línea: que quieres que cierto trabajo corra solo todas las noches, por ejemplo. No hace falta leer la respuesta entera. La forma ya te dice si la skill cargó.

cargó

Así contesta cuando la skill entró

  • Nombra una sola pieza y se compromete con ella, en vez de darte tres opciones para que elijas tú.
  • Da el motivo en una frase, no en un párrafo de contexto.
  • Cierra con un esqueleto de archivos ya nombrado, listo para completar.
  • A veces la respuesta es que no construyas nada. Eso también cuenta como que cargó.

no cargó

Así contesta cuando no entró

  • Explica en general qué es cada pieza y en qué se diferencian entre ellas.
  • Te devuelve la decisión: dice que depende y te pide que elijas.
  • No aparece ningún nombre de archivo ni ninguna carpeta.
  • La respuesta igual es correcta y útil, y por eso es fácil no darse cuenta.

la trampa del nombre

Si no aparece, revisa esto en este orden

Falta recargar. Si acabas de instalarla como plugin y el resumen pedía recargar, hasta que no corras ese comando no está activa en la sesión abierta.

El alcance quedó en otro lado. La instalaste con alcance de proyecto y abriste Claude Code en otra carpeta, o al revés. Es la causa más común y la más fácil de descartar.

La sesión es anterior a la instalación. Empieza una nueva y vuelve a mirar.

Cambió el nombre de la carpeta. En Claude Code el nombre con el que la llamas sale de la carpeta, no del frontmatter, así que renombrarla no la rompe: la mueve. Sigue estando, con otro nombre.

Queda un chequeo más, que no es de instalación sino de precio: dentro de Claude Code hay un comando que te muestra en qué se está yendo la ventana de contexto ahora mismo, desglosado por pieza. Es donde se mide lo que la sección 10 explica, y ahí está el comando con lo que hay que mirar.

Si aparece en la lista, el interruptor está prendido y la respuesta de prueba trae pieza y esqueleto, ya quedó. De aquí en adelante esta guía deja de hablar de instalación y pasa a lo que la skill decide por ti.

08 · lo que cambió

El comando de barra ya no es una pieza. Es un campo del archivo.

Durante mucho tiempo esto eran tres piezas distintas: la skill que el modelo usaba solo, el comando de barra que escribías tú, y el subagente que corría aparte para no llenarte el contexto. Hoy es una sola pieza con tres perillas.

Los comandos se fusionaron con las skills. Un archivo en .claude/commands/deploy.md y una skill en .claude/skills/deploy/SKILL.md producen los dos el mismo /deploy, y funcionan igual.

dos caminos, el mismo /deploy

.claude/commands/deploy.md          →  /deploy
.claude/skills/deploy/SKILL.md      →  /deploy
.claude/skills/deploy/references/   →  archivos de apoyo, solo por este lado

antes de que preguntes

No hay que migrar nada

Los comandos que ya tienes escritos siguen funcionando igual que ayer. Nadie los va a apagar y no hay una fecha límite colgando encima.

Lo que cambia es qué conviene para lo próximo que escribas: la skill, porque puede llevar archivos de apoyo al lado y un comando suelto no. Y porque el aislamiento de contexto —lo único que antes obligaba a escribir un subagente aparte— ahora es un campo más del frontmatter.

Lo que no cambió, y conviene no confundir

El subagente sigue siendo una pieza aparte, con su archivo y su carpeta. Eso no se fusionó con nada.

Lo que cambió es que una skill ahora puede correr adentro de un subagente con context: fork, sin que tengas que escribirle uno propio. Escribir el subagente aparte se justifica cuando además es reusable: cuando varias skills o varias tareas distintas lo van a llamar. Para una sola, es una carpeta de más.

Esta página asume que ya sabes qué es cada pieza. Si alguna suena vacía, el glosario está en Anatomía de Claude, que las explica desde cero.

Las dos preguntas que fijan el modo

No son cuatro opciones sueltas de un menú. Son dos preguntas independientes, y el modo sale de cruzarlas.

pregunta 1

¿Quién la dispara?

  • Tú, escribiendo su nombre en el menú de barra.
  • El modelo, cuando el tema aparece y la descripción calza. O las dos, que es como queda si no tocas nada.

pregunta 2

¿Dónde corre?

  • En tu conversación, sumando a tu contexto todo lo que lea por el camino.
  • Aparte, en su propia ventana, que hace el trabajo y vuelve solo con el resultado. Rinde cuando la tarea genera mucho ruido intermedio: leer cuarenta archivos y traer tres hallazgos.
la disparas túla dispara el modelolas dos
corre en tu conversacióndisable-model-invocation: trueuser-invocable: falseel default: no escribes nada
corre apartedisable-model-invocation: true + context: forkuser-invocable: false + context: forkcontext: fork, y nada más

La fila dice dónde corre y la columna quién la dispara. Cualquier casilla es válida, y la de arriba a la derecha —el default— es la que quieres la mayoría de las veces.

el error más común

context: fork no la saca del menú de barra

context: fork decide dónde corre, no quién la dispara. Mandarla a correr aparte no la esconde: la sigues viendo en el menú de barra y el modelo la sigue pudiendo levantar por su cuenta.

Para sacarla del menú hace falta user-invocable: false, que es el otro eje. Son dos decisiones distintas y se toman por separado.

Los cuatro casos, dichos simple

Dicho como se lo explicarías a alguien en voz alta:

  • El default. No escribes nada en el frontmatter: la puedes invocar tú y el modelo también la levanta cuando el tema aparece.
  • disable-model-invocation: true — solo tú. Es lo que antes era un comando, y va para cosas con consecuencias: desplegar, commitear, mandar un mensaje. No quieres que el modelo decida por su cuenta que hoy es buen día para desplegar. Regalo extra: no ocupa contexto hasta que la invocas.
  • user-invocable: false — solo el modelo. Va para conocimiento de fondo. Cómo funciona el sistema viejo de facturación es algo que Claude debería saber cuando el tema sale, pero nadie quiere escribir /sistema-viejo.
  • context: fork — corre en un subagente. Solo sirve si la skill trae una tarea que ejecutar. Si es conocimiento y nada más, el subagente recibe las pautas, no tiene nada que hacer con ellas y vuelve con las manos vacías.

El precio de usar los campos extra

Todo lo de arriba tiene letra chica, y conviene saberla antes y no después. Los tres campos de esta sección —context, disable-model-invocation y user-invocable— son extensiones de Claude Code: no están en el estándar abierto que siguen las skills. Mientras la skill viva en la terminal, no pasa nada. El día que intentes subirla a la app, cualquiera de ellos hace fallar la subida con un error duro: no lo ignora, rechaza el archivo.

la decisión, en tres líneas

Seis campos si viaja, todos si se queda

  • Si la skill tiene que viajar —a la app de Claude, a otra máquina, a otro agente—, quédate en los seis del estándar.
  • Si es tuya y vive solo en Claude Code, usa todo lo que quieras: los campos extra son la parte cómoda.
  • version no es uno de los seis. Va adentro de metadata, el campo donde caben tus propios datos.

Cuáles son los seis del estándar está enumerado en la sección 04, justo donde hace falta saberlo: al momento de subir el archivo. Aquí lo que importa es la decisión, no la lista.

Ya sé que es una skill, falta el modo

Cuando la pieza ya está decidida y lo que queda es la parte que más desactualiza al material viejo: quién la dispara y dónde corre.

Ya sabemos que esto va a ser una skill. Lo que me falta es el modo.

Decídelo con las dos preguntas que lo fijan —quién la dispara y dónde corre— y dime cuál de los cuatro modos me toca, con el frontmatter exacto que va en el SKILL.md.

Contéstame también estas tres, que son las que me hacen dudar:

- ¿Debería quedar fuera del menú de barra, o quiero poder invocarla yo?
- ¿Tiene sentido que corra aparte, en su propia ventana, o eso me va a devolver las manos vacías?
- ¿Esta skill va a viajar fuera de Claude Code —a la app, a otra máquina, a otro agente—? Si sí, dime qué campos del frontmatter tengo que sacrificar y por qué.

LO QUE HACE LA SKILL:
[Descríbelo aquí. Di si trae una tarea que ejecutar o si es conocimiento de fondo — eso cambia la respuesta.]

El modo no se decide al final: cambia el archivo desde la primera línea. Si la pieza ya está elegida y lo único que falta es esto, el prompt de arriba lo resuelve en un turno.

09 · los errores

Once veces que la pieza no era la del caso

Casi todos salen del mismo lugar: elegir la pieza por lo que suena importante en vez de por quién la dispara y qué carga. Un subagente suena más serio que una línea en un archivo de texto. Un plugin suena más terminado que una carpeta suelta. Un servidor con cuarenta herramientas suena a que dejaste todo cubierto.

Ninguno de los once falla de forma ruidosa. No hay un error en rojo: hay una pieza que mantienes sin motivo, un contexto que pagas en todas las sesiones, o una regla que se cumple casi siempre. Por eso conviene reconocerlos por la forma y no por el síntoma.

La tabla va completa a propósito, para que puedas recorrerla contra lo que ya tienes construido. Tres de los once se desarrollan más abajo, porque son los que salen más caros y los que más se repiten.

Si alguna palabra de la tabla te suena a idioma ajeno, el glosario de las piezas está en Anatomía de Claude: qué es cada una, explicada desde cero. Esta página asume que ya las conoces por nombre.

el anti-patrónqué va en su lugar
Un comando de barra para algo nuevoUna skill que solo disparas tú hace exactamente lo mismo, y además admite archivos de referencia y scripts colgando, cosa que un archivo suelto no tiene. Por qué dejaron de ser dos piezas está en la sección 08.
Un subagente aparte solo para aislar contextoEl aislamiento hoy es un campo dentro de la skill que ya tenías: la corre en su propia ventana sin que exista un segundo archivo que mantener. El subagente propio se gana el lugar cuando es un trabajador reusable, con herramientas recortadas, al que llaman por su nombre desde varios lados.
Un servidor MCP con cuarenta herramientas por si acasoExpón las operaciones que alguien pidió, no las que la API tiene disponibles. El motivo por el que esto está mal cambió y vale la aclaración, que va más abajo.
Una skill que pide una clave de APISon dos piezas: el servidor MCP guarda la credencial de su lado y expone la operación, y la skill se queda con el criterio sin mencionar ninguna clave. El detalle va más abajo.
Un plugin con una sola skill adentro que usas solo túDéjala suelta en la carpeta de skills del proyecto. El manifiesto todavía no suma nada. El plugin se gana el lugar cuando hay dos o más piezas que se instalan juntas, o cuando lo mismo tiene que funcionar en otra máquina.
Un hook que tiene que decidir con criterioEl hook no pasa por el modelo, y eso es justo lo que lo hace útil. La regla fija va en el hook, el criterio va en una skill. Un script que intenta adivinar va a fallar en silencio en los casos raros, que son los que importan.
Una regla importante escrita en el CLAUDE.mdSe cumple casi siempre, y ahí está el problema. Si tiene que valer todas las veces, es un hook. El detalle va más abajo.
Un CLAUDE.md de ochocientas líneasEntra entero en cada sesión, hable de lo que hable la conversación de hoy. Deja ahí lo que aplica siempre y que sea corto: lo que aplica a veces va en skills, que entran cuando el tema aparece, y lo que aplica a ciertos archivos va en reglas por ruta, que entran solo cuando Claude toca esos archivos.
Un SKILL.md de tres mil palabras con seis casos adentroCon seis casos adentro pagas los seis aunque el de hoy sea uno. El cuerpo lleva el procedimiento y la tabla de cuál es cuál, cada caso se va a su propio archivo de referencia, y el cuerpo dice cuándo leer cada uno. El mecanismo está en la sección 10.
Ponerla a correr en su propia ventana cuando la skill solo sabe cosasEse modo es para skills con instrucciones ejecutables. Para conocimiento va el modo por defecto, o el que la deja fuera del menú si tampoco quieres verla ahí. La sección 08 explica por qué el subagente vuelve sin nada.
Pedir un artefacto esperando una aplicaciónEs el único de la lista donde la pieza quedó corta en vez de grande. Para mostrar, comparar o anotar, el artefacto sirve; el día que hay que guardar lo que alguien escribe, es una aplicación y esa la hospedas tú. Los límites exactos están en el Paso 1 de la sección 02.

Ninguna fila dice que lo que ya construiste esté roto. Dicen que hay una pieza más chica que hace lo mismo y que cuesta menos mantener.

Los tres que salen más caros

el que publica una credencial

La skill que pide una clave de API

El archivo dice que para consultar los tickets uses tal clave, y ahí queda la clave escrita. Son dos problemas de golpe, y el segundo es el que sorprende.

El primero es el obvio: la credencial queda en un archivo de texto que después se sube al repositorio, se comparte con alguien y se copia a otra máquina. El segundo es que además no funciona. El modelo no sale a hacer un pedido a un servidor porque un archivo de texto se lo pida. Leer una instrucción no es tener la capacidad de ejecutarla.

Son dos piezas y cada una guarda algo distinto. El servidor MCP guarda la credencial de su lado y expone la operación concreta, por ejemplo listar los tickets abiertos. La skill se queda con el criterio, que es lo que tú sabes y la API no: en qué orden se atienden, qué se escala y qué puede esperar. Y no menciona ninguna clave.

el motivo cambió

El MCP con cuarenta herramientas

Envolver la API entera porque alguna vez puede servir. Sigue estando mal, pero por un motivo distinto al que se repetía hace un año, y esa diferencia importa porque cambia el remedio.

El costo ya no es de tokens: es de puntería. Entre cuarenta nombres parecidos el modelo elige peor que entre seis, y ese error no aparece en ninguna medición de contexto. Aparece como una herramienta mal elegida en el momento equivocado.

Expón las operaciones que alguien pidió de verdad, no las que la API tiene disponibles. Por qué el motivo viejo dejó de aplicar está en la sección 10, que es la que se ocupa de lo que cuesta cada pieza.

casi siempre no alcanza

La regla importante escrita en el CLAUDE.md

La línea está en mayúsculas y dice que nunca hagas commit sin correr las pruebas. Y se cumple casi siempre.

Casi siempre es exactamente el problema cuando lo que está en juego es publicar algo. La vez que no se cumple no te avisa: te enteras después, por otro lado.

Una instrucción escrita es un pedido, y depende del criterio del modelo en ese turno. Si tiene que valer todas las veces, es un hook, que es la única pieza que no pasa por ese criterio. La regla dura al hook, y el CLAUDE.md para lo que puede admitir un matiz.

Pásale la tabla a lo que ya tienes en disco

La tabla se lee en cinco minutos y no cambia nada por sí sola. Lo que sirve es correrla contra el proyecto que ya tiene meses encima. Este prompt le pide a la skill que abra la carpeta de configuración y el CLAUDE.md, pase cada pieza que encuentre por el árbol y te diga cuáles habrían salido distintas hoy.

Auditar lo que ya construiste

Para el proyecto que ya tiene meses encima. Le pasas el árbol a lo que ya está en disco y sale qué pieza está de más.

Revisa lo que ya tengo construido en este proyecto y dime qué está en la forma equivocada.

Mira la carpeta .claude/ de este repo y también mi CLAUDE.md. Para cada pieza que encuentres —skills, subagentes, comandos, hooks, servidores MCP, plugins— dime:

1. Qué es y qué hace, en una frase.
2. Qué pieza habría salido si el caso pasara hoy por el árbol de decisión.
3. Si no coinciden, cuál es el anti-patrón exacto y qué habría que hacer en su lugar.
4. Qué me está costando en contexto: qué entra en el turno cero de cada sesión y qué entra solo cuando se dispara.

Pon primero lo que más me está cobrando sin que lo use. Y si hay algo que se puede borrar sin reemplazo, dímelo — que sobre una pieza es más común que faltar una.

Pide el resultado ordenado por lo que más te cobra sin que lo uses. Que sobre una pieza es más común que falte una, y borrar sin reemplazo es una respuesta válida.

lo que tienen en común

En diez de los once, la pieza era más grande que el problema

  • Ese es el sesgo por defecto, y conviene tenerlo presente antes de abrir cualquier carpeta nueva.
  • La única de las once que va al revés es la última: pedir un artefacto cuando el caso era una aplicación. Ahí la pieza quedó corta, y eso se nota el mismo día en vez de al mes.
  • Que el error tenga dos direcciones no cambia hacia dónde conviene equivocarse. Quedarse corto se ve rápido y se corrige; pasarse se paga en silencio durante meses.

Ninguno de los once se arregla leyendo más. Se arreglan abriendo la carpeta y preguntando, pieza por pieza, quién la dispara y qué carga.

10 · el precio

Casi todas las piezas hacen casi lo mismo. Te cobran distinto.

Cuando dudas entre una skill y un subagente, o entre una regla en el CLAUDE.md y un hook, la pregunta que casi siempre te haces es cuál puede hacer el trabajo. Y la respuesta suele ser que las dos pueden. Por eso la comparación no se resuelve por capacidad: se resuelve por precio.

El precio de una pieza son dos cosas: cuánto te cobra antes de que escribas la primera palabra, y cuánto te cobra después. Una sesión que arranca con medio contexto ocupado no se rompe, se pone tonta más temprano. Y eso no se nota el día que la instalas: se nota al mes, cuando ya nadie se acuerda de por qué esa carpeta está ahí.

Qué te cobra cada pieza, y en qué momento

El turno cero es todo lo que ya está adentro antes de tu primer mensaje. La columna de la derecha es lo que llega después, y solo si hace falta.

la piezaen el turno cerodespués
CLAUDE.mdEntra entero, en cada sesión, lo uses o no.Nada más: ya estaba todo adentro desde el principio.
Regla por rutaNada.Entra cuando Claude toca los archivos que esa regla cubre, y solo entonces.
SkillUna línea: su descripción.El cuerpo entra cuando se dispara, y de ahí en adelante se queda.
Skill de invocación manualNada, ni siquiera la línea de descripción.Todo, el día que la escribes tú por su nombre.
Servidor MCPLos nombres de sus herramientas.El esquema de una herramienta llega cuando esa herramienta se va a usar.
SubagenteNada en tu ventana.Corre en la suya, lee lo que necesite y te devuelve solo el resumen.
HookNada.Solo lo que devuelva marcado como contexto adicional, salvo en tres eventos donde su salida sí entra. El resto se va al log.

La cuarta fila es la skill que lleva el campo disable-model-invocation en su frontmatter: se queda fuera de la lista de descripciones y no existe para el modelo hasta que la llamas. Es la forma más barata que hay de tener una skill instalada.

Si alguna de esas palabras te suena de lejos, el glosario está aparte: Anatomía de Claude, pieza por pieza. Aquí se asume que ya sabes qué es cada una.

Las tres cosas que casi nadie sabe

consecuencia 1

Una skill que cargó se queda cargada

No se descarga cuando cambias de tema. Entró una vez y sigue ahí el resto de la sesión, ocupando lugar aunque ya estés en otra cosa.

Por eso un archivo de skill con seis casos adentro te cobra los seis aunque el de hoy sea uno. La salida no es escribir menos: es partir el cuerpo del material de apoyo. Lo que se lee siempre va en el cuerpo; lo que se lee a veces va en archivos aparte, y el cuerpo manda a abrirlos solo cuando el caso aparece.

consecuencia 2

El consejo viejo sobre MCP ya no se dice igual

Durante un tiempo la recomendación fue no instalar muchos servidores MCP porque los esquemas de sus herramientas se comían el contexto en cada turno. Hoy eso ya no describe lo que pasa por defecto: la búsqueda de herramientas viene encendida y difiere los esquemas, así que al arranque entran los nombres y el esquema completo llega recién cuando la herramienta se va a usar.

El costo que sí sigue existiendo es otro, y no es de tokens. Entre cuarenta nombres parecidos el modelo elige peor que entre seis. Un servidor con herramientas puestas por si acaso sigue siendo mala idea: lo que empeora no es el gasto, es la elección.

consecuencia 3

Lo que imprime un hook no lo lee nadie

En la mayoría de los eventos, el texto suelto que un hook manda a la salida no entra al contexto: se va al log de depuración, donde el modelo no mira. Hay tres excepciones y conviene saberlas, porque son justo donde más se escriben hooks: al arrancar la sesión, al enviar tú un mensaje y al expandirlo. En esas tres, lo que imprime el hook sí entra como contexto.

Es de los errores que no dan ninguna señal: un hook con un mensaje adentro, esperando que Claude lo tome en cuenta, no le llega a nadie. Corre, no falla, y funciona igual de bien que no haberlo escrito.

El número real de esta skill

Todo lo de arriba vale para cualquier pieza. Esto vale para esta: es lo que cuesta tener Claude Anatomy instalada, medido en la máquina y no calculado a ojo.

medido, no estimado

Lo que te cuesta tener esta skill puesta

siempre encendida
~411 tokens, que se suman a cada sesión. Es la línea de descripción con la que el modelo decide si esta skill tiene algo que ver con lo que acabas de escribir.
al dispararse
~5.1k tokens, que se pagan cada vez que la skill entra. Ahí carga el cuerpo con el árbol de decisión completo.
qué son
Estimaciones que reporta la herramienta de detalle de plugins de Claude Code. Pueden diferir del uso real.
cómo lo compruebas tú
El comando /context te muestra en qué se está yendo la ventana ahora mismo, desglosado por pieza.

Esos dos números son exactamente la fila de la skill en la tabla de arriba, vista desde un caso concreto. Los cuatrocientos tokens son el precio de tenerla disponible por si acaso: se pagan en cada sesión, incluso en las que no hay ninguna decisión que tomar. Los cinco mil solo los pagas el día que de verdad tienes la duda, y si ese día no llega, no los pagas nunca.

Esa es la cuenta que te toca hacer con cualquier pieza que estés pensando instalar, no solo con esta. Cuánto cuesta que esté ahí, cuánto cuesta usarla, y con qué frecuencia la vas a usar de verdad. Si el uso es raro y el costo fijo es alto, sobra. Si el costo fijo es una línea y el uso es semanal, se queda.

Para verlo en tu máquina, dentro de Claude Code

/context

Los números cambian entre versiones y entre máquinas, así que el que salga en tu pantalla manda sobre el que está escrito aquí.

La regla de la sección es esa: esto se mide, no se estima. Lo que no cambia con las versiones es el orden de las preguntas — quién dispara la pieza, qué carga y en qué momento.

11 · los límites

Te deja el esqueleto nombrado. Escribirlo te toca a ti.

Toda herramienta que sirve tiene un borde. El de esta se ve rápido: no construye nada. Corre el árbol sobre tu caso, te dice qué pieza te toca y por qué, y te deja el esqueleto de archivos con los nombres puestos. Ahí se detiene, a propósito.

Conviene saber dónde se detiene antes de instalarla y no después. Estas son las tres cosas que no hace, lo que trae adentro de la carpeta, y qué está verificado de verdad frente a qué solo está escrito.

Las tres cosas que no hace

límite 1

No escribe la pieza entera

Lo que te devuelve es la recomendación, el motivo en una frase y el árbol de archivos ya nombrado con tu caso adentro. Los archivos quedan nombrados, no escritos.

La separación es deliberada: decidir y construir son dos trabajos, y mezclarlos es justo lo que hace que termines con una pieza grande para un problema chico. Completar el esqueleto es lo que sigue, y para el caso más común hay una guía entera dedicada a eso, enlazada más abajo.

límite 2

No reemplaza la documentación oficial

La documentación de Claude cambia seguido. Esta versión se escribió contra la de agosto de 2026, y contra ella se verificó cada afirmación sobre:

  • El orden en que se carga cada cosa cuando arranca una sesión.
  • Qué te cobra en contexto cada pieza, y en qué momento te lo cobra.
  • Qué campos admite el frontmatter de una skill y cuáles hacen fallar la subida.
  • Qué eventos existen para enganchar un hook.
  • Hasta dónde llega un artefacto antes de necesitar algo hospedado.

Lo que vayas a apoyar en un número, verifícalo contra la documentación de hoy. Una skill es un archivo de texto con fecha: no se entera sola de que algo cambió.

límite 3

No decide si conviene automatizar algo

Esa pregunta es anterior a esta. Aquí se asume que ya decidiste construir y lo que falta es elegir la forma.

El Paso 0 revisa si lo que necesitas se resuelve sin construir nada: una línea en el CLAUDE.md, algo que ya está publicado, un estilo de salida, un script. Lo que no hace es calcular si vale la pena automatizar una tarea que haces dos veces al mes. Ese cálculo lo traes tú, y va antes de abrir la skill.

Qué trae adentro

La carpeta es markdown puro: no hay nada que compilar ni que ejecutar. El SKILL.md carga siempre que la skill se dispara; las referencias solo se leen si el caso las pide, y los assets se copian tal cual cuando toca entregarte el esqueleto.

la carpeta, por dentro

skills/anatomia-cc/
├── SKILL.md                          el árbol y el contrato de salida
├── references/                       se leen solo si hacen falta
│   ├── como-se-carga-el-contexto.md  qué entra en el turno cero, y qué no
│   ├── modos-de-skill.md             los cuatro modos y el frontmatter entero
│   ├── mcp-o-skill.md                la señal de la credencial
│   ├── afuera-de-la-sesion.md        artefacto, app con el SDK, rutina
│   └── anti-patrones.md              los once, con antes y después
├── assets/                           se copian, no se leen
│   ├── arbol-de-decision.md          el árbol entero en una página
│   └── esqueleto-*.md                ocho esqueletos, uno por pieza
└── evals/
    ├── evals.json                    20 pruebas de disparo
    └── decisiones.json               12 pruebas de decisión

Los ocho esqueletos son uno por pieza: skill, subagente, hook, servidor MCP, plugin, rutina, artefacto y app con el Agent SDK. Es lo que te llega pegado cuando el árbol cierra en una de ellas.

cómo se verificó

Una compuerta que corrió, y dos sets de pruebas que no

la compuerta
El validador del artefacto corrió sobre esta versión y dio pass, con cero errores y cero avisos. Revisa el frontmatter, los límites de la descripción, que todos los enlaces internos resuelvan y que no viaje ninguna credencial ni ninguna ruta de la máquina del autor.
pruebas de disparo
Veinte casos que miden si la skill se activa cuando corresponde y se queda quieta cuando no. Escritas, no ejecutadas.
pruebas de decisión
Doce casos que miden si la pieza recomendada es la correcta. Escritas, no ejecutadas.
la diferencia
Una compuerta que corrió está verificada; una prueba que nadie ejecutó, no. Los dos archivos están en evals/ a la vista, por si quieres correrlos tú.

de dónde salió

De una caja de preguntas, no de una idea

El producto salió de una caja de preguntas en Instagram que contestaron 712 personas, y de mirar cuáles de esas dudas se repetían hasta volverse un patrón. No se publica el texto de ningún comentario ni el usuario de nadie: lo que viaja al producto es la pregunta repetida, no la persona que la escribió.

qué sigue

Si la pieza que salió es una skill

Es la salida más común del árbol, y no por casualidad: el Paso 2 deja la skill al final, como lo que queda cuando ninguna de las otras tres preguntas dio que sí. Si ahí terminaste, lo que sigue es escribirla, y esa es otra guía.

El paso siguiente, escrito completo: la guía de skills de Claude. Ahí está el archivo por dentro: la descripción que decide si se activa, qué va en el cuerpo y qué se deja para las referencias.

El repositorio, si quieres leer la skill entera, copiarla o abrir un issue: github.com/Hainrixz/claude-anatomy. Licencia MIT.

Proyecto de la comunidad, no afiliado a Anthropic. Si algo de lo que leíste aquí ya no coincide con lo que ves en pantalla, gana la documentación de hoy.

Guía de la comunidad

Esta guía es parte de la bóveda abierta de tododeia.

Las fuentes · de dónde salió cada dato

Los números de contexto de la sección 10 no son estimaciones de esta página: salen de correr la herramienta de detalle de plugins sobre la skill ya instalada, el 12 de agosto de 2026. Las rutas de menú de las secciones 04 y 05 están verificadas contra el centro de ayuda de Claude ese mismo día, y los comandos de la sección 03 contra la documentación de Claude Code. El mensaje de error de la palabra reservada no está copiado de ninguna documentación: es lo que contestó el panel al intentar subir esta misma skill cuando todavía se llamaba con la palabra prohibida adentro. Si algo del panel cambia, la documentación oficial manda sobre esta página.

Sigue por aquí

La regla que se lleva casi todos los casos

En diez de los once anti-patrones, la pieza elegida era más grande que el problema. Ese es el sesgo por defecto y conviene tenerlo presente: ante la duda, la pieza más chica que resuelve el caso es casi siempre la correcta, y siempre es la más fácil de tirar cuando te equivocaste. Esta skill no escribe la pieza entera ni decide si conviene automatizar algo — esa pregunta es anterior. Entrega la recomendación y el esqueleto, y ahí te toca a ti. Proyecto de la comunidad, no afiliado a Anthropic.