Tu primera skill: /post

¿Qué es una skill?

Hasta ahora, cada petición a Claude era desechable: escribes un prompt, obtienes un resultado, y la próxima vez lo vuelves a escribir todo. Una skill cambia eso. Es un comando slash que construyes tú mismo: escribes /post y Claude sigue las instrucciones que definiste de una vez por todas. Las skills persisten entre conversaciones: las construyes una vez, las reutilizas para siempre.

Es el concepto más importante del curso. La diferencia entre un usuario ocasional y un usuario 10x no es la calidad de sus prompts — es que capitaliza. Cada problema resuelto se convierte en una herramienta permanente. Al cabo de tres meses, el usuario ocasional vuelve a escribir sus instrucciones; el usuario 10x tiene una caja de herramientas de quince comandos que codifican toda su experiencia de negocio.

Para Lea, la skill /post va a codificar todo su proceso de publicación: dónde buscar la información, cómo estructurar un post, qué formato de imagen generar, cómo registrar en el journal. Ese saber hacer, hoy en su cabeza, estará mañana en un archivo que Claude ejecuta bajo demanda.

Anatomía de una skill

Una skill vive en tu proyecto como una carpeta que contiene un archivo SKILL.md:

.claude/
  skills/
    post/
      SKILL.md      <-- las instrucciones de la skill (requerido)
      reference.md  <-- (opcional) doc de referencia cargada bajo demanda
      scripts/      <-- (opcional) scripts utilitarios de la skill

El archivo SKILL.md contiene un encabezado YAML (el «frontmatter»: nombre y descripción) seguido de las instrucciones en Markdown libre. El nombre de la carpeta se convierte en el comando: .claude/skills/post/ → /post. Así es la estructura:

---
name: post
description: Publica un post en una red social (texto + visual + journal). Usar cuando el usuario quiere publicar o programar contenido.
---

# Rol
Eres el gestor de redes sociales de la marca...

# Etapas
1. Identificar la plataforma y el tema proporcionados
2. Investigar el tema si es necesario
3. Redactar el post en el formato de la plataforma
...

Detalle que importa: la description del frontmatter no es decorativa. Es lo que Claude lee para decidir si la skill es pertinente — incluso puede invocarla por sí mismo cuando tu petición coincide, sin que escribas el comando. Una buena descripción dice qué hace la skill y cuándo usarla. El cuerpo del archivo, en cambio, solo se carga en contexto en el momento de la ejecución: eso es lo que permite tener decenas de skills sin sobrecargar cada sesión.

¿Skills de proyecto o skills personales?

La regla de decisión es simple: si la skill contiene contexto específico del proyecto (la voz de Lea, sus plataformas, sus API), va en el proyecto. Si codifica un hábito tuyo, independiente del proyecto, va en tu carpeta personal.

Construir la skill (empezando simple)

Empezamos con una sola plataforma para validar todo el pipeline: la generación del texto, del visual, y la publicación. Pasaremos al multiplataforma más tarde. Esta disciplina — reducir el alcance hasta que una versión mínima funcione de extremo a extremo — es la competencia número uno de la automatización. Pega este prompt en Claude Code:

crea una nueva skill claude code "post" en esta carpeta.

rol: gestor de redes sociales IA para linkedin, instagram, twitter, facebook.
el usuario proporciona una plataforma + cualquier combinación de: un tema, un post a adaptar, una URL (youtube, artículo, pdf), o sus propias imágenes.
deduce la intención a partir de lo proporcionado.
mantén un archivo journal de los posts publicados y de sus URLs.

hazme preguntas una a la vez hasta estar seguro al 95% de lograr la tarea.

La frase más útil del curso

Fíjate en la última línea: «hazme preguntas una a la vez hasta el 95% de confianza». Es uno de los patrones más poderosos con la IA, y merece que nos detengamos en él.

El reflejo natural es intentar acotarlo todo en el primer prompt — y fracasar, porque nadie piensa en todo de antemano. Este patrón invierte la carga: es Claude quien te interroga. Sus preguntas revelan los huecos de tu razonamiento («¿qué hacer si el usuario proporciona una imagen Y una URL?», «¿el journal debe incluir los borradores no publicados?»), que rellenas mediante el diálogo en lugar de anticipándolo todo. Responde una pregunta a la vez; cuando Claude tiene suficiente contexto, construye la skill.

El «una a la vez» también es importante: si Claude hace ocho preguntas de golpe, respondes superficialmente a las ocho. Una a la vez, cada respuesta alimenta la pregunta siguiente — es una verdadera conversación de encuadre, como con un freelance competente que toma tu brief.

Probar la skill

Cierra y vuelve a abrir una sesión (las nuevas skills se detectan al arrancar). Escribe /: debes ver /post en la lista con su descripción. Lanza una primera prueba:

/post "trucos de prompts para principiantes" twitter

Claude genera un visual, redacta el post y lo publica (o lo programa), luego registra el resultado en el journal. El objetivo aquí no es el volumen: es validar el pipeline completo antes de escalar. Si una clave API es incorrecta, una cuenta está mal conectada o un formato de imagen es rechazado por la plataforma, lo descubres ahora, con un solo post de prueba — no publicando una semana de contenido.

flowchart LR
  A["/post tema + plataforma"] --> B["Investigación del tema"]
  B --> C["Redacción del texto"]
  C --> D["Generación del visual"]
  D --> E["Publicación vía API"]
  E --> F["Journal de los posts"]

Conectar las API sin tirarte de los pelos

Para publicar de verdad, tu skill necesita acceder a las API de las redes sociales — bien llamando directamente a una API de publicación (la mayoría de las herramientas de programación de posts ofrecen una), bien vía un servidor MCP (Model Context Protocol), el estándar que permite conectar herramientas externas a Claude Code con el comando claude mcp add. Buena noticia: no necesitas leer la documentación tú mismo. Dale la URL de la doc a Claude y dile «lee esta doc y configura la integración».

Para las claves API, la convención limpia: un archivo .env en la raíz del proyecto (¡añadido al .gitignore!), que los comandos referencian sin mostrar nunca el valor. Pide explícitamente a Claude respetar esta convención — y es exactamente el tipo de regla que grabaremos en el CLAUDE.md en el capítulo 8.