Skills en Claude Code: instala uno existente y crea el tuyo
Neaptide · 20 de septiembre de 2026 · 8 min de lectura
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
Las tareas repetidas suelen adquirir un orden: leer archivos, comprobar condiciones y devolver un resultado claro. Si pides con frecuencia revisar formularios, redactar cambios o investigar errores de compilación, puedes guardar ese procedimiento como skill.
Un Skill es una carpeta con instrucciones en SKILL.md y materiales opcionales. Reúne una rutina repetible, ejemplos y archivos auxiliares. Consulta la especificación Agent Skills.
Esta guía cubre Claude Code local y un ejemplo de revisión de formulario. Los comandos se contrastaron con la documentación; el ejemplo no representa una prueba en un sitio real.
Qué tarea convertir en Skill
Elige algo que ya puedas explicar: «Antes de entregar el formulario, revisar campos obligatorios, errores y envío; después enumerar problemas».
Es más fácil empezar así que con «crea sitios de calidad». La revisión tiene entradas, pasos y un resultado evaluable.
| 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 fila. Si el skill desarrolla, escribe anuncios, configura servidores y publica, será difícil saber qué mejorar.
Instalar desde una carpeta
Los skills personales van en `~/.claude/skills/`; los del proyecto, en `.claude/skills/` dentro del repositorio. Cada uno tiene su carpeta y SKILL.md. El personal sirve en varios proyectos de esa máquina; el de proyecto se guarda con el código. Ubicaciones.
project/
└── .claude/
└── skills/
└── form-review/
├── SKILL.md
└── references/
└── checklist.mdSi descargaste una colección, localiza el skill y copia la carpeta completa. Copiar solo SKILL.md puede romper referencias a otros archivos.
Evita una carpeta duplicada:
.claude/skills/form-review/form-review/SKILL.mdLa ruta correcta del ejemplo es:
.claude/skills/form-review/SKILL.mdSi ya existe ese nombre, compara versiones antes de copiar para conservar tus cambios.
Instalar mediante un plugin
Sigue las instrucciones del autor cuando distribuya un plugin. Para el repositorio oficial de Anthropic, escribe dentro de Claude Code:
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skillsLa primera orden añade el marketplace; la segunda instala los ejemplos. El repositorio también incluye `document-skills@anthropic-agent-skills` para documentos. README oficial.
Carpeta y plugin son formas distintas de distribución. Un SKILL.md aislado de GitHub no se convierte automáticamente en un paquete instalable: comprueba si existe un marketplace.
Lee la respuesta de instalación. Si hace falta activarlo, ejecuta `/reload-plugins`; los errores aparecen en `/plugin`. El alcance determina si es personal, compartido por el proyecto o local para ti en ese proyecto. Instalar plugins.
Revisar un skill ajeno
Lee SKILL.md y los scripts antes de ejecutarlo. Contrasta su comportamiento con la tarea: enviar el repositorio a un servidor externo para revisar un formulario necesita explicación.
Registra origen, versión y modificaciones propias. Tendrás una referencia si una actualización cambia el resultado.
Comprueba los requisitos: el autor puede dar por hecho un framework, comandos o herramientas de navegador ausentes en tu proyecto. Adapta esas suposiciones en lugar de prometer compatibilidad universal.
Crear el skill de revisión
Este ejemplo lee la implementación y redacta un informe. No corrige código ni envía solicitudes, para separar diagnóstico y reparación.
Crea `.claude/skills/form-review/` en el editor o, en macOS, Linux o WSL:
mkdir -p .claude/skills/form-reviewAñade este ejemplo didáctico a SKILL.md y adáptalo:
---
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.Los metadatos van entre `---`; después aparece el procedimiento. La especificación exige `name` y `description`, con el nombre igual al directorio. Aquí se usan minúsculas latinas y guion. Formato.
`disable-model-invocation: true` es un ajuste de Claude Code para invocación manual, elegido para iniciar la revisión explícitamente. «Solo lectura» es una instrucción; los permisos técnicos se configuran aparte. Invocación, permisos.
Invocar y comprobar
Abre el proyecto en Claude Code:
/form-review Revisa el formulario en src/components/LeadForm.tsxSustituye la ruta de ejemplo por un archivo existente. La llamada directa usa `/nombre-del-skill`. Invocar Skills.
Elige un formulario con un comportamiento conocido, como un error que desaparece tras otro clic. Comprueba si el agente lo detecta y señala la causa en el código.
Evalúa cuatro puntos:
- Cita archivos reales y ubicaciones concretas.
- Cada observación incluye su condición de aparición.
- Separa suposiciones y conclusiones respaldadas.
- No presenta la lectura de pruebas como ejecución correcta.
Si solo ofrece consejos genéricos, exige evidencias: «No incluyas recomendaciones sin mostrar la implementación relacionada». Repite sobre el mismo formulario.
Cambia una parte importante cada vez para saber qué mejoró la respuesta. Es un método propuesto; aquí no se afirman resultados de pruebas del skill.
Describir la selección automática
Indica acción y momento de uso. Compara:
Ayuda a desarrollar aplicaciones.
Con:
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 delimita mejor el alcance. La especificación recomienda explicar qué hace y cuándo usarlo. Campo description.
El ejemplo desactiva la selección automática. Si la activas, prueba una petición adecuada, otra cercana y otra ajena. Observar el resultado ayuda más que valorar solo la redacción.
Si no aparece o no se activa
Revisa ruta, nombre SKILL.md y apertura YAML: `---` debe ser la primera línea. Si creaste `.claude/skills/` después de iniciar la sesión, reinicia Claude Code. Edición y carga.
Distingue instalación y selección. Si falla la llamada directa, revisa la instalación. Si funciona manualmente pero no automáticamente, revisa modo y descripción.
Con nombres iguales, Claude Code prioriza el skill personal sobre el del proyecto. Comprueba ambas carpetas si hay resultados inesperados. Conflictos de nombres.