Vas a escribir en una skill de Claude Code cómo prepara tu empresa una propuesta comercial, compartirla con el equipo y comprobar que Claude la sigue.
Cada empresa tiene su forma de hacer las cosas: qué se pregunta antes de presupuestar, qué condiciones se ponen, qué tono se usa. Si cada vez que pides algo a Claude tienes que pegar esas reglas en el chat, ese método debería estar en una skill.
Antes de empezar
- Claude Code instalado y una cuenta que lo incluya: Pro, Max, Ultra, Team, Enterprise o Console. El plan gratuito de claude.ai no incluye Claude Code. La instalación está en la documentación oficial.
- Una carpeta de proyecto en la que trabaje el equipo, mejor si está en un repositorio de Git para compartir la skill.
- Tu método por escrito, aunque sea en borrador: los pasos que sigue tu equipo y las condiciones que nunca cambian.
Qué es una skill y cuándo merece la pena
Una skill es un archivo SKILL.md con instrucciones que Claude añade a lo que sabe hacer. Claude la usa cuando la
tarea encaja, o la puedes llamar directamente con /nombre-de-la-skill.
La documentación de Claude Code da dos señales para crear una:
- Pegas una y otra vez en el chat las mismas instrucciones, la misma lista de comprobación o el mismo procedimiento de varios pasos.
- Una parte del archivo CLAUDE.md del proyecto ya no es un dato, sino un procedimiento.
Y una ventaja frente a CLAUDE.md: el cuerpo de la skill solo se carga cuando se usa, así que el material largo de consulta casi no cuesta nada hasta que lo necesitas.
Dónde se guarda: para ti o para el equipo
El sitio donde guardas la skill decide en qué sesiones se carga:
| Ubicación | Ruta | Dónde se carga |
|---|---|---|
| Personal | ~/.claude/skills/<nombre>/SKILL.md (en tu carpeta de usuario) |
En todos tus proyectos de este ordenador, pero no en las sesiones de Cowork ni en las de la nube |
| Proyecto | .claude/skills/<nombre>/SKILL.md (dentro del proyecto) |
En las sesiones de ese repositorio, pero no en los hilos en la nube de un proyecto. Si lo subes al repositorio, la tiene todo el equipo |
El método de la empresa va en el proyecto, para que quien trabaje en él use las mismas reglas.
Qué puede ejecutar Claude por su cuenta
Por defecto, tanto tú como Claude podéis llamar a cualquier skill. Para los procesos con efectos, como desplegar o
enviar un mensaje de Slack, o cuando quieras decidir tú el momento, añade al encabezado
disable-model-invocation: true. Con ese campo, Claude no puede usar la skill por su cuenta: se lanza a mano con
/nombre, y su descripción deja de estar en el contexto.
La skill de propuestas de esta guía solo deja un borrador, así que no lleva ese campo.
Paso 1. Crea la carpeta de la skill
Dentro de la carpeta del proyecto, crea esta estructura:
.claude/
└── skills/
└── propuesta-comercial/
├── SKILL.md
└── condiciones.md
El nombre de la carpeta, propuesta-comercial, será el comando que se escriba para llamarla: /propuesta-comercial.
Cómo saber que ha ido bien: la ruta del archivo es .claude/skills/propuesta-comercial/SKILL.md, contando desde
la raíz del proyecto.
Paso 2. Escribe el SKILL.md
Un SKILL.md tiene dos partes: un encabezado YAML entre marcas ---, que le dice a Claude cuándo usar la skill, y
el contenido en Markdown, con las instrucciones que sigue cuando la skill se ejecuta. Un ejemplo:
---
description: Prepara propuestas comerciales con el método y las condiciones de la empresa. Úsala cuando se pida una propuesta, un presupuesto o una oferta para un cliente.
---
## Pasos
1. Antes de redactar, pide lo que falte: cliente, problema que quiere resolver, alcance y fecha límite.
2. Redacta la propuesta con esta estructura: situación del cliente, lo que proponemos, lo que incluye y lo que no,
plazos y condiciones.
3. Copia las condiciones de condiciones.md sin cambiarlas.
4. Termina con un resumen de lo que falta por confirmar.
## Reglas
- No pongas precios que no estén en condiciones.md. Si falta uno, déjalo marcado como pendiente.
- No prometas plazos que el cliente no haya acordado.
- Deja la propuesta como borrador para que la revise una persona.
Todos los campos del encabezado son opcionales, pero conviene poner siempre description, porque es lo que usa Claude
para decidir cuándo aplicar la skill. Pon primero el uso principal: la documentación avisa de que ese texto, junto con
el del campo opcional when_to_use, se corta a 1.536 caracteres en la lista de skills.
El cuerpo, corto. Cuando la skill se carga, su contenido se queda en el contexto de la conversación, así que cada línea tiene un coste que se repite. Escribe qué hay que hacer, sin contar cómo ni por qué.
Cómo saber que ha ido bien: el archivo empieza por ---, la línea description: está dentro del encabezado y
los pasos y las reglas van debajo de la segunda marca ---.
Paso 3. Añade los archivos de apoyo
Una skill puede tener varios archivos en su carpeta. Así el SKILL.md se queda con lo esencial y Claude consulta el
material de detalle solo cuando lo necesita. En el ejemplo, condiciones.md guarda las tarifas y las condiciones de
la empresa. Un ejemplo, con marcadores en lugar de cifras:
Condiciones de las propuestas:
- Tarifa por hora: [poner tarifa]
- Forma de pago: [poner forma de pago]
- Plazo de validez de la propuesta: [poner plazo]
- Garantía: [poner garantía]
Desde el SKILL.md, di qué contiene cada archivo y cuándo usarlo. Puedes añadir al final del ejemplo:
## Material de apoyo
- Tarifas, forma de pago, validez y garantías: [condiciones.md](condiciones.md). Consúltalo antes de poner un precio o escribir el apartado de condiciones.
Cómo saber que ha ido bien: el SKILL.md nombra condiciones.md y dice cuándo leerlo.
Paso 4. Prueba la skill
Abre Claude Code en la carpeta del proyecto ejecutando claude. Si la sesión ya estaba abierta, no hace falta
reiniciarla: Claude Code detecta los cambios en la carpeta .claude/skills/ del proyecto. Si esa carpeta de skills
no existía cuando empezó la sesión, ejecuta /reload-skills, y vuelve a ejecutarlo después de cada cambio en esa
carpeta, porque Claude Code todavía no la vigila.
La skill se prueba de dos formas:
- Que Claude la use por su cuenta: pide algo que encaje con la descripción, por ejemplo «prepárame una propuesta para un cliente que quiere formar a su equipo».
- Llamarla directamente: escribe
/propuesta-comercial.
Cómo saber que ha ido bien: en los dos casos, Claude empieza pidiendo los datos que faltan (cliente, problema,
alcance y fecha límite), y la propuesta sigue la estructura de la skill y copia las condiciones de condiciones.md.
Paso 5. Compártela con el equipo
Sube la carpeta .claude/skills/propuesta-comercial/ al repositorio del proyecto. Quien trabaje en ese repositorio
tendrá la skill en sus sesiones. Cuando cambie el método, se edita el SKILL.md y se sube otra vez, como cualquier
otro archivo del proyecto.
Cómo saber que ha ido bien: otra persona del equipo actualiza el repositorio, abre Claude Code en el proyecto y
puede escribir /propuesta-comercial.
Errores típicos y cómo evitarlos
| Síntoma | Por qué pasa | Qué hacer |
|---|---|---|
| Claude no usa la skill cuando debería | Claude decide cuándo usarla por la descripción | Añade a la descripción las palabras que usa el equipo al pedirlo («presupuesto», «oferta») y pregunta a Claude What skills are available? para ver si aparece |
/propuesta-comercial funciona, pero Claude nunca la usa por su cuenta |
El YAML del encabezado está mal escrito y Claude Code carga la skill sin descripción | Revisa las marcas --- y la línea description:, o ejecuta Claude Code con --debug para ver el error |
| Claude usa la skill cuando no toca | Claude la elige por su descripción | Haz la descripción más concreta o añade disable-model-invocation: true si solo quieres llamarla a mano |
| Una regla que tiene que cumplirse siempre a veces se salta | Las instrucciones de la skill las sigue Claude; un hook lo ejecuta Claude Code cada vez que ocurre su evento, siga o no la skill | Lleva esa regla a un hook |
| Tras una conversación muy larga, Claude deja de seguir la skill | Al resumirse la conversación, Claude Code puede quedarse solo con el principio de la skill | Vuelve a llamar a la skill y pon arriba del SKILL.md lo más importante |
Siguientes pasos
Con la primera skill ya tienes el método de un proceso por escrito. Lo siguiente es conectarla con las herramientas del equipo mediante MCP, poner un segundo agente que revise lo que hace el primero y programar los procesos para que funcionen solos. Es lo que trabajamos en el curso de Claude Code para empresas, y cada equipo termina con un proyecto sobre un proceso real de su empresa. Si quieres hacerlo con tu equipo, puedes solicitar la formación.
Preguntas frecuentes
¿Cómo borro una skill?
Borra su carpeta, la de .claude/skills/ del proyecto o la de la carpeta .claude/skills/ de tu usuario.
¿Las skills sirven solo para Claude Code?
Las skills de Claude Code siguen el estándar abierto Agent Skills, que funciona en varias herramientas de IA. Claude Code amplía el estándar con funciones propias, como decidir quién puede llamar a la skill.
¿Siguen funcionando los comandos de la carpeta .claude/commands/?
Sí. Un archivo Markdown en .claude/commands/ es el formato antiguo y sigue funcionando, pero la documentación recomienda usar skills para lo nuevo, porque además admiten archivos de apoyo.
¿Qué pasa si el equipo acumula muchas skills?
Claude Code carga una lista con el nombre y la descripción de cada skill. La lista siempre incluye todos los nombres, pero si hay muchas skills Claude Code quita algunas descripciones para no pasarse de espacio, empezando por las skills que menos se usan. Sin descripción, Claude pierde las palabras con las que relaciona tu petición con la skill.
Fuentes consultadas
Automatekit Academy
Academia de formación en IA y automatización para equipos de empresa, in-company u online.