🌱 Empieza aquí · Publicador de redes sociales

Esta semilla le da a tu asistente una mesa de publicación para tus redes. En vez de entrar a cada app a subir cada post, le pasas el contenido ya listo y tu asistente crea un borrador en tu Postiz, te devuelve un enlace para que lo revises, y solo publica cuando tú apruebas. Sirve para más de 30 redes (Instagram, LinkedIn, Threads, TikTok, YouTube, Bluesky, Pinterest, Telegram y más), programa posts a futuro y te lee las métricas cuando ya se publicaron.

Postiz es una herramienta open-source (gratuita, que tú instalas en tu propia máquina o servidor) para programar y medir redes sociales. Esta semilla es el "control remoto" de tu Postiz: no lo reemplaza, lo maneja por ti.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo demás y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el publicador de redes", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es una skill (habilidad) que trae scripts (.mjs, Node.js) para hablar con la API pública de Postiz. No es un hook (gancho de automatización): no lleva chmod, no lleva entrada en settings.json y no ejecuta nada por sí solo. Se "siembra" copiando la carpeta a donde tu plataforma carga habilidades y configurando dos variables de entorno.

Requisitos previos (verifícalos con la persona antes de sembrar):

• Node.js 18 o superior instalado (los scripts usan fetch nativo). Verifica: node --version.
• Un Postiz corriendo (auto-alojado vía Docker, típicamente en http://localhost:5000). Si la persona aún no lo tiene, la semilla se instala igual, pero el paso de verificación reportará que Postiz no responde hasta que lo levante. Repo de Postiz: https://github.com/gitroomhq/postiz-app
• Una API key de Postiz (se genera en la interfaz de Postiz → Settings → API Keys).

1. Copia la habilidad a su lugar

El kernel trae la habilidad completa: SKILL.md (el método), scripts/ (los .mjs), references/ (specs y protocolo) y templates/ (el mapper).

Claude Code (macOS / Linux):

mkdir -p "$HOME/.claude/skills/social-publisher"
cp -R kernel/. "$HOME/.claude/skills/social-publisher/"

Claude Code (Windows PowerShell):

New-Item -ItemType Directory -Force "$HOME\.claude\skills\social-publisher" | Out-Null
Copy-Item -Recurse -Force kernel\* "$HOME\.claude\skills\social-publisher\"

Las carpetas dentro de ~/.claude/skills/ se cargan como habilidades disponibles. El asistente invoca esta cuando detecta que le piden publicar, programar o crear un borrador para redes.

Cowork: coloca la carpeta social-publisher/ (con todo el contenido del kernel dentro) en la ruta de habilidades de tu proyecto si la soporta. Si no, guarda el contenido dentro del proyecto y agrega en el archivo de instrucciones (CLAUDE.md) una línea que apunte a él: "Cuando te pidan publicar o programar contenido en redes, aplica el método de social-publisher/SKILL.md."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Pega el contenido de SKILL.md dentro de AGENTS.md (o agrégale un puntero al archivo) y deja la carpeta scripts/ accesible en el proyecto para poder ejecutarla.

2. Configura las dos variables de entorno

Los scripts leen la conexión a Postiz de dos variables de entorno. Configúralas donde tu asistente lea el entorno (la config de tu asistente, tu shell/perfil, o un archivo .env), reemplazando los placeholders con los datos reales de la persona:

• POSTIZ_API_URL → la URL base de su Postiz, terminada en /api (ej. http://localhost:5000/api).
• POSTIZ_API_KEY → la API key que generó en Postiz. Va cruda (sin "Bearer" delante).

En Claude Code, una forma es agregarlas al bloque env de ~/.claude/settings.json. En un shell tipo bash/zsh, con export POSTIZ_API_URL=... y export POSTIZ_API_KEY=... en tu perfil. En Windows, con setx.

3. Verificación post-siembra (obligatoria)

a) Los archivos quedaron colocados (ejemplo Claude Code):

ls -la "$HOME/.claude/skills/social-publisher/scripts/postiz-health.mjs"; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) El publicador está vivo y hablando con Postiz (prueba de comportamiento):

node "$HOME/.claude/skills/social-publisher/scripts/postiz-health.mjs"

El script imprime un JSON. Interprétalo así:

• Si dice "ok": true con integraciones en connected → todo listo, ya puedes crear borradores.
• Si dice "error": "env-vars-missing" → faltan las variables del paso 2, configúralas.
• Si dice "error": "postiz-not-running" → la persona aún no levantó Postiz (docker compose up -d).
• Si dice "ok": false con gaps (ej. cero integraciones o token vencido) → la skill funciona; falta que la persona conecte sus redes por OAuth en la interfaz de Postiz.

En los cuatro casos, que el script imprima un JSON limpio y no truene ya prueba que quedó bien cableado. El "ok": true real depende de que la persona tenga Postiz arriba y al menos una red conectada. Cuando ambas partes pasen, dile a la persona en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando tengas un post listo, se lo pasas a tu asistente y él crea el borrador en tu Postiz y te manda el enlace. Tú entras, le das una revisada rápida, y apruebas (o pides cambios). Nada se publica sin tu visto bueno. Puedes decirle "prográmalo para el martes a las 8pm", "¿qué borradores tengo pendientes?" o, un par de días después, "¿cómo le fue a ese post?". Dejas de entrar app por app a subir todo a mano. 🌱