Crear tu primera Skill

Si cada vez que pides a Claude una especificación funcional le pegas la misma plantilla y las mismas reglas, eso es una Skill esperando a nacer. En 15 minutos vas a crear una, la vas a instalar en la app de Claude y en Claude Code, y Claude la usará solo cuando le pidas una especificación, sin que tengas que recordárselo.

Antes de empezar

• Una cuenta de Claude. Las Skills están disponibles en todos los planes, incluido el gratuito, pero necesitan activada la opción Code execution and file creation (en planes individuales, en Settings > Capabilities; en Team y Enterprise lo controla el administrador).
• Si vas a usarla en Claude Code, tenerlo instalado.
• Un editor de texto y saber comprimir una carpeta en ZIP.
• Tu plantilla de especificación funcional (o la de ejemplo de esta guía).

1. Qué es una Skill, en dos párrafos

Una Skill es una carpeta con un archivo SKILL.md dentro: arriba, una cabecera con nombre y descripción; debajo, las instrucciones. Puede llevar más archivos (plantillas, ejemplos, scripts) que Claude consulta cuando los necesita.

La gracia está en cómo se carga. Claude solo ve de entrada el nombre y la descripción de cada Skill. Cuando tu petición encaja con una descripción, carga las instrucciones completas; si no, no gastan contexto. Por eso la descripción es la línea más importante: debe decir qué hace la Skill y cuándo usarla. Es un formato abierto: la misma carpeta sirve en la app, en Claude Code y en la API.

2. Escribe el SKILL.md

Crea una carpeta llamada especificacion-funcional-sap y dentro un archivo SKILL.md con esto:

---
name: especificacion-funcional-sap
description: Redacta especificaciones funcionales SAP con la plantilla del equipo. Úsala cuando pidan una EF, un documento funcional o especificar un desarrollo RICEFW.
---

# Especificación funcional SAP

## Antes de redactar
1. Confirma: módulo (FI, SD, MM…), tipo de objeto RICEFW (informe,
   interfaz, conversión, ampliación, formulario, workflow), proceso
   afectado y sistema (S/4HANA Cloud u on-premise).
2. Si falta algo, pregunta en una sola tanda.

## Cómo redactar
- Sigue la estructura de `plantilla.md`, sección por sección.
- No inventes transacciones, tablas, campos ni BAPIs. Si no los
  sabes, escribe [POR CONFIRMAR].
- Criterios de aceptación en formato Dado / Cuando / Entonces.
- Lenguaje de negocio; lo técnico, solo en «Consideraciones técnicas».

## Al terminar
Cierra con una lista de preguntas abiertas para el consultor.

Y al lado, un plantilla.md con las secciones de tu equipo. Por ejemplo: datos generales, contexto de negocio, situación actual, solución propuesta, datos y reglas, autorizaciones, consideraciones técnicas, criterios de aceptación y preguntas abiertas.

Tres reglas para el nombre, que valen en todas partes: solo minúsculas, números y guiones; máximo 64 caracteres; y no puede contener las palabras «claude» ni «anthropic». Deja la descripción corta y al grano: la app admite menos caracteres que Claude Code, así que si cabe en un par de líneas, sirve en ambos.

3. Instálala donde la vayas a usar

# App de Claude: comprime la carpeta entera en un ZIP
$ zip -r especificacion-funcional-sap.zip especificacion-funcional-sap
# Luego: Customize > Skills > + > Create skill > Upload a skill
# Claude Code, para ti en todos tus proyectos
$ cp -r especificacion-funcional-sap ~/.claude/skills/
# Claude Code, solo en este repositorio (y compartida vía git)
$ mkdir -p .claude/skills && cp -r especificacion-funcional-sap .claude/skills/

En la app, tras subir el ZIP la Skill aparece en tu lista de Customize > Skills con un interruptor para activarla o desactivarla. Las Skills que subes son tuyas: en Team y Enterprise puedes compartirlas con compañeros desde el menú de tres puntos, y los propietarios de la organización pueden publicarlas para todos.

En Claude Code, la Skill aparece además como comando: puedes invocarla a mano con /especificacion-funcional-sap. Y si inicias sesión con tu cuenta de claude.ai, las Skills que tengas activadas en la app se sincronizan a Claude Code.

4. Pruébala

Abre una conversación nueva y pide algo que encaje con la descripción, sin nombrar la Skill:

Itera como con cualquier documento: si la especificación sale floja en algo, corrige el SKILL.md o la plantilla y vuelve a subirla. Pocas instrucciones claras funcionan mejor que muchas.

Si algo falla

• La subida del ZIP da error por campos de la cabecera: la app y la API solo aceptan name, description, license, compatibility, metadata y allowed-tools. Si copiaste campos propios de Claude Code (como argument-hint o disable-model-invocation), quítalos para la versión de la app.
• Claude no usa la Skill: la descripción es vaga o no incluye las palabras con las que pides la tarea. Añade los disparadores reales («EF», «documento funcional») o invócala a mano con /nombre en Claude Code.
• La Skill se dispara cuando no toca: la descripción es demasiado amplia. Acótala. En Claude Code puedes añadir disable-model-invocation: true para que solo se ejecute cuando tú la llames.
• No ves el apartado de Skills: comprueba que Code execution and file creation está activado; en Team o Enterprise, pide al administrador que revise la política de Skills.