Skills en Claude Code: instala uno existente y crea el tuyo
Neaptide · 20 de septiembre de 2026 · 8 min de lectura · Actualizado: 3 de octubre de 2026
Instala Skills de Claude Code desde carpetas o plugins, escribe SKILL.md y comprueba el resultado con una revisión de formulario.
En este artículo
Si le pides a menudo a Claude Code que revise formularios, redacte la descripción de unos cambios o investigue errores de compilación, cada una de esas tareas acaba teniendo su orden: leer los archivos necesarios, comprobar las condiciones y devolver el resultado de forma clara. Ese orden se puede dejar escrito una sola vez en un skill.
Un Skill es una carpeta con instrucciones en el archivo SKILL.md y, si hace falta, materiales adicionales. Con ella el agente recibe un procedimiento repetible junto con sus ejemplos y archivos auxiliares. El formato está descrito en la especificación Agent Skills.
Esta guía explica la instalación en Claude Code en local y construye un skill de ejemplo para revisar un formulario de contacto. Los comandos se contrastaron con la documentación el 3 de octubre de 2026. El ejemplo es didáctico y no es el informe de una prueba en un sitio real.
Qué tarea convertir en Skill
Elige un procedimiento que ya sepas explicar con palabras: «Antes de entregar el formulario, revisar los campos obligatorios, los mensajes de error y el envío; después, enumerar los problemas».
Para un primer skill funciona mejor que un vago «crea sitios de calidad». La revisión de un formulario tiene datos de entrada, pasos y un resultado que se puede evaluar.
| Tarea | Qué guardar | Resultado |
|---|---|---|
| Revisar formulario | Escenarios y orden | Problemas y condiciones no comprobadas |
| Describir cambios | Estructura y selección de detalles | Borrador acorde con el diff |
| Analizar compilación | Lectura de registros y diagnóstico | Causa fundamentada o hipótesis |
| Preparar artículo | Requisitos editoriales y enlaces | Correcciones concretas |
Empieza por una sola fila de la tabla. Un skill que desarrolla el sitio, escribe los anuncios, configura el servidor y publica el resultado es difícil de arreglar, porque no se sabe qué etapa ha fallado.
Instalar desde una carpeta
Los skills personales se guardan en `~/.claude/skills/` y los del proyecto en `.claude/skills/`, dentro del repositorio. Cada skill tiene su propia carpeta con un SKILL.md. El personal está disponible en todos los proyectos de esa máquina; el de proyecto viaja con el código.
project/
└── .claude/
└── skills/
└── form-review/
├── SKILL.md
└── references/
└── checklist.mdSi has descargado una colección, localiza la carpeta del skill que te interesa y cópiala entera. Copiar solo SKILL.md puede romper las referencias a los materiales adjuntos.
Revisa cómo ha quedado el árbol de carpetas. Al descomprimir es frecuente que aparezca un nivel de más:
.claude/skills/form-review/form-review/SKILL.mdEn nuestro ejemplo, el archivo debe estar un nivel más arriba:
.claude/skills/form-review/SKILL.mdAntes de copiar, mira si ya existe una carpeta con ese nombre. Si existe, compara primero las versiones para no pisar tus propios cambios.
Instalar mediante un plugin
Si el autor distribuye sus skills como plugin, sigue sus instrucciones de instalación. Para el repositorio oficial de Anthropic los comandos son estos, y se escriben dentro de Claude Code:
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skillsEl primer comando añade el marketplace y el segundo instala los ejemplos. Para trabajar con documentos, el mismo repositorio ofrece `document-skills@anthropic-agent-skills`.
La carpeta y el plugin son dos formas distintas de distribución. Un SKILL.md suelto que encuentres en GitHub no se instala con `/plugin install`: comprueba antes si el autor ofrece un paquete en un marketplace.
`/plugin install` abre la ficha del plugin, donde eliges el alcance: para ti en todos tus proyectos, para todas las personas que trabajan en el repositorio o solo para ti en ese repositorio. Después lee el resumen de la instalación. Si hace falta recargar, Claude Code suele ejecutar `/reload-plugins` por su cuenta. Si el plugin no ha podido cargarse, el motivo aparece en la pestaña Errors de `/plugin`.
Revisar un skill ajeno
Antes de ejecutarlo por primera vez, lee SKILL.md y los scripts que lo acompañan, y compáralos con la tarea. Si el skill sirve para revisar un formulario y además envía el contenido del repositorio a un servidor externo, eso exige una explicación.
Apunta de dónde has sacado el skill, qué versión usas y qué has cambiado en él. Si una actualización altera el resultado, tendrás con qué comparar.
Fíjate también en lo que el autor da por supuesto. Puede haber escrito el skill para un framework, un conjunto de comandos o una herramienta de navegador que tu proyecto no tiene. Esas partes tendrás que sustituirlas por las tuyas. Ningún skill «funciona en todas partes».
Crear el skill de revisión
Nuestro skill lee la implementación del formulario y redacta un informe. No corrige código ni envía solicitudes, y así la búsqueda del problema queda separada de su arreglo.
Crea la carpeta `.claude/skills/form-review/` desde el editor. En macOS, Linux o WSL puedes usar el terminal:
mkdir -p .claude/skills/form-reviewDespués crea dentro el archivo SKILL.md con el contenido siguiente. Es un ejemplo didáctico que tendrás que adaptar a tu proyecto.
---
name: form-review
description: Revisa un formulario de contacto e informa sobre validación, mensajes y envío. Úsalo para revisar el formulario antes de publicar.
disable-model-invocation: true
---
# Revisión del formulario
## Objetivo
Encontrar errores de implementación y comprobaciones pendientes.
Solo lee archivos. No cambies código, no envíes el formulario
ni contactes con servicios externos.
## Entradas
Se necesita la ruta del formulario o el nombre del recorrido.
Si coinciden varios formularios, pregunta cuál revisar.
## Procedimiento
1. Lee el componente, su manejador y las pruebas relacionadas.
2. Localiza campos obligatorios y reglas de validación.
3. Revisa en el código los valores vacíos y emails inválidos.
4. Sigue los estados de envío, éxito y error.
5. Comprueba el tratamiento explícito de pulsaciones repetidas;
si no está claro, describe la incertidumbre.
6. Contrasta conclusiones y pruebas. Que exista una prueba
no significa que se haya ejecutado ni superado.
## Informe
Para cada problema indica:
- archivo y ubicación;
- condición que lo provoca;
- posible consecuencia para el usuario;
- comprobación o corrección propuesta.
Enumera aparte lo que requiere ejecutar la aplicación.
Si no encuentras problemas claros, dilo sin afirmar
que el formulario está completamente probado.Al principio del archivo, entre las líneas `---`, van los metadatos; debajo, el procedimiento. La especificación abierta Agent Skills exige `name` y `description`, y el nombre debe coincidir con el de la carpeta. Claude Code es más flexible: en él todos los campos son opcionales y solo se recomienda `description`. El nombre admite minúsculas latinas, cifras y guiones.
`disable-model-invocation: true` es un ajuste de Claude Code: con él, el skill solo se ejecuta cuando lo llamas tú, y Claude no lo carga por su cuenta. Aquí sirve para que la revisión empiece siempre con una orden explícita. La indicación de «solo lectura» describe un comportamiento. Los permisos técnicos se configuran aparte.
Invocar y comprobar
Abre el proyecto en Claude Code y escribe:
/form-review Revisa el formulario en src/components/LeadForm.tsxLa ruta es solo un ejemplo: indica un archivo que exista en tu proyecto. Un skill se llama directamente con `/nombre-del-skill`.
Para probar el skill, elige un formulario con un defecto que ya conozcas. Por ejemplo, el mensaje de error del envío desaparece en cuanto se vuelve a pulsar el botón. Comprueba si el agente detecta justo ese comportamiento y si señala la causa en el código.
Valora el informe con cuatro criterios:
- Cita archivos que existen y partes concretas de la implementación.
- Cada observación indica en qué condición aparece el problema.
- Las suposiciones están separadas de las conclusiones que el código respalda.
- Haber leído las pruebas no se presenta como haberlas ejecutado con éxito.
Si en su lugar recibes una lista larga de consejos genéricos, endurece la exigencia de evidencias. Por ejemplo, añade: «No incluyas recomendaciones sin mostrar la implementación relacionada». Luego repite la revisión con el mismo formulario.
Cambia una sola parte importante de las instrucciones cada vez; de lo contrario no sabrás qué cambio hizo más útil la respuesta. Esto es un método de trabajo editorial. Aquí no se presentan resultados de pruebas del skill.
Describir la selección automática
Si el skill debe elegirse de forma automática, describe tanto lo que hace como cuándo conviene usarlo. Compara:
Ayuda a desarrollar aplicaciones.
Y una versión más precisa:
Revisa formularios antes de publicar: validación, errores y estados de envío. Úsalo para revisar formularios, no para analizar toda la arquitectura.
La segunda versión marca sus límites, y el agente tiene menos motivos para elegir el skill en una tarea que no viene al caso. La especificación también recomienda que `description` diga qué hace el skill y cuándo usarlo.
En nuestro ejemplo la selección automática está desactivada. Si la activas, prueba la descripción con varias peticiones: una adecuada, otra cercana y otra claramente ajena. Ver qué ocurre enseña más que juzgar la redacción de oído.
Si no aparece o no se activa
Empieza por la ruta, el nombre exacto del archivo SKILL.md y el inicio del bloque YAML: la línea `---` debe ser la primera. Claude Code recoge durante la sesión los cambios hechos en carpetas de skills que ya existían. Si creaste la carpeta raíz `.claude/skills/` después de iniciar la sesión, ejecuta `/reload-skills`.
Después distingue dos situaciones. Si el skill no aparece al llamarlo directamente, revisa la instalación. Si funciona a mano pero el agente nunca lo elige por su cuenta, revisa el modo de invocación y la descripción.
Cuando un skill personal y otro del proyecto se llaman igual, Claude Code ejecuta el personal. Si el resultado te sorprende, mira en las dos carpetas.