Social Media Skills: cómo usar las skills de Claude para crear contenido en LinkedIn, Instagram y YouTube

Estos días circula por Facebook una publicación que promete que un repositorio de GitHub "convierte a Claude en una máquina de crecimiento de contenido": analiza tus mejores posts, genera ideas y ganchos con tu voz y te ayuda a crecer en LinkedIn, Instagram, X y YouTube. El repositorio es charlie947/social-media-skills, un paquete de 17 skills para Claude y Codex con licencia MIT.

Lo hemos clonado, leído skill por skill, validado e instalado en Claude Code. En este artículo verás qué hace cada skill, cómo instalarlas, el orden en que conviene usarlas y qué parte de la promesa es cierta. Resumen rápido: es un buen sistema para LinkedIn, con apoyo puntual para Reels de Instagram y miniaturas de YouTube. X solo aparece como fuente de investigación.

Qué es social-media-skills

Una *skill* es una carpeta con un SKILL.md: instrucciones en Markdown que el asistente carga cuando detecta que tu petición encaja con su descripción. No es un programa que se ejecute solo ni un servicio en la nube. Es un conjunto de procedimientos que Claude o Codex siguen dentro de tu proyecto.

Datos del repositorio a fecha de esta prueba:

• Versión: 1.1.0 (15 de septiembre de 2026, según VERSIONS.md). La 1.0.0 salió el 22 de abril de 2026.
• Licencia: MIT. Puedes usarlas, modificarlas y adaptarlas a tus clientes.
• Compatibilidad: Claude Code (como plugin), Claude Desktop (subiendo cada skill) y Codex (con su instalador o copiando a .agents/skills/).
• Autor: Charlie Hills, que documenta el sistema en su newsletter *MarTech AI*.

El propio README avisa de algo importante: es un *toolkit* público, no el sistema privado completo del autor (su pipeline de Figma, sus cuentas ni su configuración).

Las 17 skills y para qué sirve cada una

Las agrupamos por lo que producen, no por el orden del README:

Trece de las diecisiete giran en torno a LinkedIn. Si tu canal principal es Instagram o X, el paquete te aporta bastante menos de lo que sugiere la publicación de Facebook.

Cómo instalar las skills

En Claude Code (plugin)

El repositorio incluye un .claude-plugin/marketplace.json, así que se instala como plugin. Dentro de Claude Code:

/plugin marketplace add charlie947/social-media-skills
/plugin install social-media-skills

Lo mismo desde la terminal con la CLI (probado con Claude Code 2.1.284):

claude plugin marketplace add charlie947/social-media-skills
claude plugin install social-media-skills@social-media-skills
claude plugin list

La última orden debe mostrar social-media-skills@social-media-skills, versión 1.1.0, con estado *enabled*. claude plugin validate sobre el repositorio pasa con un único aviso (el marketplace no tiene descripción), que no afecta al uso.

En Claude Desktop

Comprime la carpeta de cada skill (con su subcarpeta references/ si la tiene) y súbela desde la configuración de skills. El README propone:

cd social-media-skills/skills
zip -r voice-builder.skill voice-builder

Cada subida contiene solo esa skill. Empieza por voice-builder y añade las demás según las necesites.

En Codex

Pide al instalador de Codex que instale las skills por su ruta (skills/voice-builder, skills/post-writer...) o clona el repo en tu proyecto y copia cada carpeta a .agents/skills/<nombre>/. El README trae un bucle de copia que no sobrescribe skills que ya existan, pensado para no pisar versiones que hayas personalizado.

Cómo usarlo paso a paso

Trabaja siempre en una carpeta de proyecto dedicada a tu contenido (por ejemplo contenido-linkedin/). Ahí es donde las skills guardan y leen los archivos de voz, no dentro de la carpeta del plugin.

1. Construye tu voz con voice-builder

Di "build my voice" (o "aprende cómo escribo"). La skill no se presenta ni explica nada: arranca directamente con dos tandas de preguntas:

1. Quién eres y a qué te dedicas, para quién escribes, 3-5 temas por los que quieres que te conozcan y tu opinión diferente sobre tu sector.
2. Qué quieres que piense la gente al ver tu nombre y de qué te niegas a escribir.

Después te pide 3 a 5 textos publicados (posts, newsletters, correos). Con menos de 3 no sigue. Analiza longitud de frase, ritmo, tipo de gancho, cierres y, lo más útil, lo que nunca haces (por ejemplo, 0 de 5 textos usan rayas o preguntas retóricas). Escribe dos archivos en la raíz del proyecto:

• about-me.md (máx. 300 palabras): rol, audiencia, pilares, punto de vista, promesa de marca y temas vetados.
• voice.md (máx. 500 palabras): tono, ritmo, ganchos, aperturas, cierres, frases propias y lo que tu voz evita.

Si no tienes textos, puedes escribir "use samples" y carga unos de ejemplo. Úsalo solo para probar: estarías copiando la voz de otra persona.

2. Decide de qué hablar: content-matrix y niche-research

• content-matrix cruza tus pilares con 8 formatos (accionable, motivacional, analítico, contrario, observación, X vs Y, presente vs futuro y listado). Cada celda es un titular concreto, no un tema genérico. En Claude Code guarda la tabla en content-matrix-AAAA-MM-DD.md.
• niche-research busca historias de los últimos 7 días en Reddit, en el feed "Para ti" de X y en Google, verifica la fecha de cada una y descarta lo antiguo. Necesita navegador o búsqueda web disponibles en tu asistente; si no los hay, te lo dice en lugar de inventar.

3. Escribe: post-writer, hook-generator y post-formatter

• post-writer exige que existan about-me.md y voice.md; si faltan, te manda a ejecutar voice-builder y se detiene. Te propone tres ángulos y un marco, entrega el post en un bloque de código listo para pegar y admite hasta 3 rondas de cambios.
• hook-generator produce 6 ganchos de dos líneas: con número, contrario, transformación personal, referencia a una autoridad, confesión y predicción. Solo usa "yo" si le das una experiencia real tuya.
• post-formatter aplica un marco estricto (PAS, AIDA, BAB, STAR o SLAY) con un máximo de 20 líneas, formateado para móvil.

4. Mide: post-scorer y analytics-dashboard

Esta es la parte de "analiza tus mejores posts" de la publicación de Facebook, y tiene letra pequeña.

post-scorer puntúa un borrador de 1 a 10 en cinco criterios: fuerza del gancho, encaje con tu voz, densidad de valor, estructura y formato, y si está listo para publicar. Para compararlo con tu historial necesita datos reales, que obtiene de una de estas formas:

1. Una exportación de tus posts que tú le subes.
2. Una ejecución de Apify (actor apimaestro/linkedin-profile-posts, hasta 100 posts) con tu propia cuenta, que cuesta dinero y te pide confirmar antes.
3. Si no hay datos, una revisión solo editorial, marcada como tal.

Con datos, calcula una puntuación de interacción por post (reacciones + comentarios × 3), toma el 10 % superior y extrae sus patrones: tipo de gancho, longitud, formato, llamada a la acción y temas. Guarda el resultado en outputs/post-scorer/. Si los datos tienen más de 14 días, te sugiere actualizarlos.

analytics-dashboard parte de la exportación .xlsx de LinkedIn Analytics (Analytics → rango de 30, 60 o 90 días → Exportar). Construye un dashboard en React con Recharts (métricas principales, tendencia de interacción, crecimiento de seguidores, dispersión impresiones/interacción por post, mapa de calor por día de la semana y desglose de audiencia) y añade un análisis escrito con 5 recomendaciones apoyadas en tus datos.

5. Visuales: carruseles, infografías y miniaturas

Las skills gemini-*, quote-post, pinned-comment y youtube-thumbnail generan prompts para Gemini. Para tener la imagen necesitas acceso a la generación de imágenes de Gemini; sin él, te quedas con el prompt listo. graphic-designer puede producir el gráfico en HTML/CSS editable y, si tu entorno renderiza (un navegador con capturas), un PNG revisado.

Instagram Reels: qué necesita reels-scripting

Es la skill más técnica. A partir de la URL de un Reel de referencia:

1. Descarga el vídeo con Apify (apify/instagram-reel-scraper) en outputs/reels/<slug>/downloads/.
2. Lo envía a Gemini 2.5 Flash para transcribirlo con marcas de tiempo y analizar gancho, patrones de lenguaje y estructura.
3. Escribe tu guion propio (gancho de 0-3 s, puntos, llamada a la acción y pie) en outputs/reels/<slug>/reel-<slug>.md, adaptado a un tema de tu newsletter.

Requisitos: variables de entorno APIFY_API_TOKEN y GOOGLE_AI_API_KEY, Node.js 18 o superior y los paquetes apify-client y @google/generative-ai. Si ya tienes el vídeo puedes saltarte Apify, y con una transcripción te saltas los dos pasos de análisis.

Lo que la publicación de Facebook no cuenta

• X no tiene skills propias. Solo se usa como fuente en niche-research. Para escribir hilos de X tendrías que adaptar post-writer tú mismo.
• YouTube se limita a miniaturas. No hay guiones de vídeo largo ni análisis del canal.
• No publica nada. El README es explícito: guardar un borrador no es publicarlo, y ninguna skill envía mensajes ni toca tus cuentas.
• El "análisis de rendimiento" depende de tus datos. Sin exportación ni Apify, la puntuación es una opinión editorial, y la propia skill lo etiqueta así.
• No recoge comentarios. Todas las rutas de scraping se limitan al texto de tus posts y a recuentos agregados. Las skills prohíben extraer comentarios o respuestas.
• Escriben en inglés británico por defecto. Varias reglas dicen "British English throughout". Si publicas en español, indícalo en voice.md (por ejemplo, en "Off-limits": "escribir siempre en español neutro") y pídelo en cada petición.

Errores frecuentes

error: unable to open loose object ...: Filename too long al clonar en Windows

Nos pasó al clonar dentro de una ruta larga: Git en Windows choca con el límite de 260 caracteres. Clona en una ruta corta o activa las rutas largas para ese clon:

git -c core.longpaths=true clone --depth 1 https://github.com/charlie947/social-media-skills C:/src/sms

FileNotFoundError: [WinError 2] al ejecutar tests/test-codex-portability.py

El test llama a /bin/bash con ruta fija, que no existe en Windows nativo. Además, sin -X utf8 falla antes con UnicodeDecodeError al leer el README. Es un test para quien contribuye al repo, no lo necesitas para usar las skills. El otro validador, bash validate-skills.sh, sí funciona en Git Bash: revisa las 17 skills con 87 comprobaciones superadas y 0 fallos.

post-writer se detiene y te pide "build my voice"

No es un fallo: post-writer no escribe sin about-me.md y voice.md en la raíz del proyecto. Ejecuta voice-builder antes, o abre el proyecto correcto si ya los tienes en otra carpeta.

El post sale en inglés o con ortografía británica

Ver la última viñeta de la sección anterior: deja escrito el idioma en voice.md y repítelo en la petición.

Preguntas frecuentes

¿social-media-skills es gratis?

Sí. Las skills tienen licencia MIT. Lo que puede costar es lo externo: tu plan de Claude o Codex, las ejecuciones de Apify y el uso de la API de Gemini.

¿Necesito Apify y Gemini para usarlo?

No para lo básico. Voz, posts, ganchos, matriz de contenido y puntuación editorial funcionan solo con el asistente. Apify sirve para traer tu historial o descargar un Reel, y Gemini para analizar vídeo y generar imágenes.

¿Funciona con Instagram y X?

Parcialmente. Para Instagram solo hay guiones de Reels. X solo se lee como fuente de noticias. El grueso del paquete está pensado para LinkedIn.

¿Puedo usarlo para los clientes de mi agencia?

Sí, la licencia lo permite. Crea un proyecto por cliente con su propio about-me.md y voice.md: las skills insisten en no mezclar autores ni heredar los datos de otra persona.

¿Publica automáticamente en mis redes?

No. Genera borradores, prompts y análisis; publicar sigue siendo cosa tuya.

Conclusión

social-media-skills es un sistema ordenado para producir contenido de LinkedIn con tu voz: primero voice-builder, después ideas (content-matrix, niche-research), redacción (post-writer, hook-generator) y medición (post-scorer, analytics-dashboard). Para Instagram, X y YouTube cubre mucho menos de lo que promete la publicación viral. El siguiente paso es instalar el plugin, crear una carpeta de proyecto y pasar 15 minutos con voice-builder. Sin esos dos archivos de voz, el resto de skills rinde muy por debajo.