SKILL RECURSO ACADEMY

Cómo instalar un skill de Claude en 5 minutos

Al terminar tendrás un skill custom de Claude funcionando en tu entorno local, invocable desde cualquier sesión de Claude Code.

Publicado · 25 de mayo de 2026 ~5 min claude-code · skills · ai-tooling · productivity · anthropic

Antes de empezar

Claude Code instalado y autenticado

Necesitas Claude Code corriendo en tu máquina. Verifica con `claude --version` en terminal; si no responde, instálalo desde `claude.ai/code` y autentícate con tu cuenta Anthropic.

Terminal funcional (macOS, Linux o WSL)

En macOS abre Terminal con `Cmd+Espacio`, en Windows usa PowerShell o preferiblemente WSL para evitar problemas con paths. Linux nativo funciona out of the box.

Editor de texto a mano

VS Code, Cursor o cualquier editor que abra archivos `.md` y `.yaml`. Lo vas a usar para crear el manifest del skill.

Idea clara del skill que quieres crear

Un skill es una instrucción reutilizable (e.g. 'revisa mi código siguiendo X convención'). Tener el caso de uso definido antes de empezar te ahorra 10 minutos de improvisar el prompt.

¿Prefieres que Claude te guíe?

Copia este prompt y pégalo en Claude Code o claude.ai

Guíame paso a paso para instalar un skill custom en Claude Code. Necesito: Claude Code instalado y autenticado (verifica con `claude --version`), terminal funcional (macOS/Linux/WSL), editor de texto, y una idea clara del skill a crear. Pasos: 1) Crea la carpeta global de skills con `mkdir -p ~/.claude/skills` (o equivalente en PowerShell). 2) Dentro de esa carpeta crea una subcarpeta con nombre en kebab-case que será el nombre del skill (ejemplo: `code-reviewer`). 3) Dentro crea un archivo `SKILL.md` con frontmatter YAML que incluya `name` y `description`, seguido del prompt en markdown que define el comportamiento del skill. 4) Valida que Claude lo detecte ejecutando `claude /skills` — debe aparecer en la lista. 5) Invoca el skill en una tarea real mencionándolo por nombre en el prompt. 6) Itera el `SKILL.md` según resultados: instrucciones más imperativas si Claude las ignora, description más específico si se activa fuera de contexto. Explícame cada paso con el comando exacto y qué validar antes de avanzar al siguiente.

Claude te lleva paso a paso, contestando dudas en vivo.

Paso 1: Crea la carpeta de skills en tu home

Claude Code busca skills en una ruta específica dentro de tu directorio home. Si la carpeta no existe, créala — Claude no la genera automáticamente. Esta carpeta es global: cualquier skill aquí queda disponible en todas tus sesiones.

macOS / Linux

mkdir -p ~/.claude/skills

Windows (PowerShell)

New-Item -ItemType Directory -Force -Path $HOME\.claude\skills

Paso 2: Crea la subcarpeta del skill con nombre kebab-case

Cada skill vive en su propia carpeta. Usa kebab-case (palabras-con-guiones) en minúsculas — Claude no reconoce nombres con espacios o mayúsculas. El nombre de la carpeta es el nombre del skill que vas a invocar después.

cd ~/.claude/skills && mkdir code-reviewer && cd code-reviewer

Paso 3: Crea el archivo SKILL.md con el manifest

Este archivo es el corazón del skill: define cuándo Claude lo invoca y qué instrucciones sigue. El frontmatter YAML al inicio es obligatorio — name debe coincidir con la carpeta y description es lo que Claude lee para decidir si activarlo. Debajo del frontmatter va el prompt en markdown plano.

---
name: code-reviewer
description: Revisa código siguiendo convenciones de clean code y señala issues de seguridad.
---

# Code Reviewer Skill

Cuando el usuario pida revisar código:
1. Identifica issues de seguridad primero (inyección, secrets hardcoded).
2. Señala violaciones de clean code (funciones >30 líneas, naming poco claro).
3. Sugiere refactors concretos con ejemplo.
4. NO reescribas todo el archivo — solo las secciones problemáticas.

Paso 4: Valida que Claude detecta el skill

Abre una nueva sesión de Claude Code y lista los skills disponibles. Debes ver code-reviewer en el output. Si no aparece, revisa que el archivo se llame exactamente SKILL.md (mayúsculas importan) y que el frontmatter YAML no tenga errores de indentación.

claude /skills

Paso 5: Invoca el skill en una tarea real

Pide a Claude usar el skill explícitamente o deja que lo active automáticamente según el contexto. Si no se activa solo, menciona el nombre del skill en tu prompt para forzarlo. La primera invocación es la prueba de fuego — si el output no refleja las instrucciones del SKILL.md, revisa que el description sea suficientemente específico.

claude "usa el skill code-reviewer sobre src/auth.ts"

Paso 6: Itera el SKILL.md según resultados

El primer skill rara vez sale perfecto. Si Claude ignora instrucciones, hazlas más imperativas y específicas (‘NO hagas X’ funciona mejor que ‘evita X’). Si activa el skill cuando no debe, afina el description del frontmatter para acotar el caso de uso. Cada edición es instantánea — no hay que reiniciar nada.

¿Lo aplicamos en tu empresa?

Conversemos 30 min