Saltar al contenido
← Volver al blog

Claude Code Skills: instalar, crear y comprobar un skill

Añade skills a Claude Code, crea un SKILL.md mínimo y comprueba el resultado antes de usar cuentas y herramientas externas.

OOMOL

Un skill guarda un procedimiento que repites, como ordenar notas de versión o revisar un informe. Empieza con una tarea pequeña cuyo resultado puedas comprobar. Un skill de redacción local no necesita una cuenta OOMOL; las tareas externas sí necesitan herramientas y autorización.

Crear un skill de proyecto

Crea .claude/skills/release-note-outline/SKILL.md en el repositorio local. Los skills personales en ~/.claude/skills/ sirven para varios proyectos locales; los del proyecto se comparten con el repositorio. Consulta la guía oficial para entornos administrados o en la nube. Este ejemplo original en inglés se invoca manualmente:

---
name: release-note-outline
description: Turn supplied change notes into a release-note outline.
disable-model-invocation: true
---
Use only the change notes supplied by the user.
If no change notes are provided, ask the user to supply them.
Return three headings: Added, Fixed, Questions.
Put each confirmed change under Added or Fixed.
Put unclear claims under Questions. Do not invent versions or dates.
Do not edit files, run commands, or publish anything.

Comprobar con datos conocidos

Invoca /release-note-outline con “Added CSV export. Fixed duplicate notifications. Faster reports, but no measurement yet.”

Busca las secciones Added, Fixed y Questions. La exportación CSV y la corrección son cambios suministrados; la mejora de velocidad sin medir debe quedar como pregunta. Abre una conversación nueva en el mismo proyecto, sin las notas anteriores, e invoca /release-note-outline sin entrada. Comprueba que pida notas en lugar de reutilizar el ejemplo anterior o inventar una versión.

Instalar un skill existente

Lee SKILL.md y sus scripts. Comprueba qué archivos puede cambiar, qué credenciales necesita y qué servicios cobran. Coloca la carpeta de un skill independiente y fiable en la ubicación adecuada, conservando los archivos de apoyo. Si se distribuye como plugin, sigue sus instrucciones. Que aparezca en el menú solo demuestra que se detectó: verifica su salida con una entrada conocida.

Por ejemplo, copia una carpeta independiente ya revisada, ~/Downloads/release-note-outline/, dentro de .claude/skills/ en el repositorio. El resultado debe ser .claude/skills/release-note-outline/SKILL.md, sin otra carpeta del mismo nombre dentro. Conserva scripts/, references/ y los archivos auxiliares.

Para varios proyectos, usa ~/.claude/skills/release-note-outline/ en su lugar. Elige una ubicación y no sobrescribas el ejemplo si ya existe. Abre Claude Code en el repositorio, escribe / para encontrar el comando y prueba /release-note-outline con la entrada anterior.

Invocación manual o automática

disable-model-invocation: true reserva la ejecución manual. Quita el campo o usa false para permitir selección automática; describe la tarea y cuándo usarla en description. Pide un esquema de notas de versión y comprueba qué skill se utilizó.

Resolver problemas

Revisa la ruta, el nombre SKILL.md, el frontmatter y el directorio de la sesión. Los nombres duplicados y las políticas de organización pueden afectar la disponibilidad. Este ejemplo usa disable-model-invocation: true, así que debes invocarlo expresamente. Si la salida es vaga, concreta las entradas y el tratamiento de información ausente.

Elegir según la tarea

Para texto proporcionado, empieza con el ejemplo anterior y rechaza resultados que inventen cambios. Para revisar código, exige lectura de archivos y referencias a sus rutas. Para investigación conectada, comprueba cuenta, fuente, límites y costes.

Explora el catálogo de skills, configura OOMOL en Claude Code o empieza en OOMOL Chat.

Skills, MCP y plugins

Un skill describe un procedimiento, MCP ofrece una interfaz de herramientas y un plugin puede agrupar capacidades. Instalar instrucciones no concede acceso a cuentas. Lee una incidencia de Jira o una PR de GitHub y contrasta el resultado con su fuente. Consulta MCP frente a API para elegir cómo llamar a las herramientas.