content-engine

Skill agéntica para crear contenido de redes sociales hablando con tu agente.
Castellano. Multi-modelo de imagen. Publica solo. Cero nodos de n8n.

---

🚀 Instalación en 30 segundos

Si tienes Claude Desktop (Pro o Max) o Claude Cowork, abre el chat y pega este mensaje exacto:

Instala la skill content-engine desde
https://github.com/iamasters-academy/content-engine
y guíame en el setup paso a paso

Claude clonará el repo, ejecutará el wizard de configuración, te entrevistará para construir tu brief de marca personal (~10 min) y publicará tu primer post real en LinkedIn o Instagram (~5 min). Total: ~15-20 min la primera vez.

💡 Para no técnicos: la skill te lleva de la mano por las 3 cuentas que necesitas, las API keys, el modelo de imagen que prefieras y tu brief de marca. No tienes que recordar nada de antemano. Si te atascas, le dices a Claude "no entiendo este paso" y te lo explica.

¿No tienes Claude Desktop todavía? Descárgalo aquí. ¿No sabes qué plan necesitas? Ver 💰 Coste real abajo.

---

Qué es

content-engine es una skill de Claude Code que reemplaza el workflow visual de marketing (n8n / Make / Zapier) por una sola conversación. Le hablas. Piensa. Publica.

Tres capas:

1. Wizard interactivo — la skill detecta si es tu primera vez y te guía a crear las 3 cuentas necesarias (Fal, Groq, Upload-Post), pegar las API keys y elegir tu modelo de imagen preferido. Cero docs externas.
2. Motor agéntico — 6 fases conversacionales: brief de marca, procesar input variado (texto/audio/vídeo/URL/PDF), research online, generar 5 piezas adaptadas, generar imagen, publicar. Todo en el chat.
3. Multi-modelo de imagen — nano-banana-2 (Google) por defecto, pero soporta Flux, OpenAI gpt-image-1, o cualquier otro modelo de Fal vía URL. Sin tocar código.

Para quién

• Emprendedor que publica en redes y odia el cross-posting
• Freelancer de marketing que quiere acelerar su producción de contenido
• Dueño de pequeño negocio que no tiene community manager
• Cualquiera que ya use Claude Code y quiera dejar de usar n8n para esto

No requiere conocimientos de programación. Sí requiere paciencia para configurarlo la primera vez (~15-20 min de wizard guiado).

Qué te da el primer día

• ✅ Skill instalada y funcional en menos de 20 minutos
• ✅ Tu brief de marca personal en YAML, reutilizable cada semana
• ✅ Tu primera generación de 5 piezas adaptadas (LinkedIn, X, Instagram, YouTube short, TikTok)
• ✅ Tu primer post real publicado en LinkedIn + Instagram
• ✅ Imagen agéntica generada con nano-banana-2 o el modelo que elijas
• ✅ Multi-modelo desde el día 1: cambias hablando, no tocando código
• ✅ Edición de imagen con foto referencia (sales tú en las imágenes)
• ✅ Privacidad por defecto: tus claves están en .env.local, gitignored

💰 Coste real

Importante leerlo antes de instalar. content-engine es gratis y open source, pero los servicios externos a los que se conecta tienen sus propios costes.

Concepto	Coste	Cuándo se paga
content-engine (este repo)	Gratis (MIT)	Nunca
Claude Desktop app	Gratis (descarga)	Nunca
Anthropic Pro	$20/mes	Mínimo necesario para que la skill funcione bien
Anthropic Max	$100-200/mes	Solo si haces muchísimo contenido o sesiones largas
Fal.ai	Pago por imagen	~$0.04 por imagen con nano-banana-2. Sin suscripción
Groq	Free tier	Solo si pasas audio/vídeo. Plan gratuito sobra para uso personal
Upload-Post	Free 10 posts/mes	Si superas 10/mes, planes desde $9/mes
OpenAI (opcional)	Pago por imagen	Solo si eliges OpenAI como proveedor de imagen alternativo

Conclusión: el coste mínimo realista para empezar es $20/mes de Anthropic Pro + ~1-3€/mes en imágenes Fal. Todo lo demás está cubierto por planes gratis para uso personal típico (1-2 posts/semana).

Instalación alternativa (sin prompt conversacional)

Si prefieres clonar manualmente:

git clone https://github.com/iamasters-academy/content-engine.git ~/.claude/skills/content-engine
cd ~/.claude/skills/content-engine
cp .env.example .env.local
# Edita .env.local con tus API keys

Detalle completo en docs/installation.md.

Después de instalar

Lo más útil para arrancar:

Comando / acción	Qué hace
Wizard inicial (auto la 1ª vez)	Te lleva por cuentas, keys, modelo y brief. ~15-20 min
/content-engine o "usa content-engine"	Activa la skill en cualquier sesión Claude
"Genera contenido para esta idea"	Flujo completo: 5 piezas + imagen + publicación
"Cambia el modelo de imagen a X"	Multi-modelo en caliente, sin tocar código
"Edita esta foto mía y ponme en una oficina"	Modo edición con foto referencia

Ver ejemplos completos en docs/examples.md.

Tools incluidas

tools/
├── image_engine.py          Selector — único punto de entrada para imagen
├── fal_image.py             Cliente Fal.ai (multi-modelo + edición)
├── openai_image.py          Cliente OpenAI gpt-image-1 + edits
├── groq_transcribe.py       Cliente Groq Whisper (audio/vídeo)
├── upload_post.py           Cliente Upload-Post API (LI, IG, X, TikTok…)
├── validate_env.py          Valida que tus API keys funcionan (ping real)
└── render_dashboard.py      Dashboard HTML opcional para community managers

Cada tool es stdlib pura — cero pip install requerido.

Estructura del repo

content-engine/
├── SKILL.md                    # Instrucciones agénticas (las lee Claude)
├── README.md                   # Este archivo
├── LICENSE                     # MIT
├── CITATION.cff                # Citación académica
├── .env.example                # Plantilla de claves (copia a .env.local)
├── .gitignore                  # Protege secrets + assets generados
├── assets/
│   └── logo.png                # Logo IA Masters Academy
├── tools/                      # 7 clientes Python stdlib
├── templates/
│   ├── brief.yaml.template     # Schema brief de marca
│   ├── linkedin.md             # Reglas plantilla LinkedIn
│   ├── instagram.md
│   ├── x-thread.md
│   ├── youtube-short.md
│   ├── tiktok.md
│   └── dashboard.html.template # Dashboard opcional
├── data/
│   ├── briefs/                 # Tus briefs (gitignored)
│   ├── image_config.yaml       # Modelo elegido (gitignored)
│   ├── upload_post_config.yaml # User Upload-Post (gitignored)
│   └── inbox-redes/            # Outputs por fecha (gitignored)
├── docs/
│   ├── onboarding-flow.md      # Qué pasa en el primer arranque
│   ├── installation.md         # Setup manual paso a paso
│   ├── quickstart.md           # Tu primer post en 10 min
│   └── examples.md             # Casos reales
└── .github/
    └── CODEOWNERS              # Mantenedor: @angelapaia

Privacidad y seguridad

• ✅ Tus API keys nunca llegan a este repo. Viven en .env.local, archivo gitignored. Si haces fork y commit, no se suben.
• ✅ Tus briefs de marca y outputs son tuyos. Carpetas data/briefs/ y data/inbox-redes/ están gitignored. Cero exfiltración accidental.
• ✅ Tu username de Upload-Post tampoco se sube. Va a data/upload_post_config.yaml, también gitignored.
• ✅ Cero telemetría. Esta skill no manda datos a nadie. Habla solo con Anthropic, Fal, Groq y Upload-Post — los servicios que tú mismo configuras.
• ✅ Permisos mínimos. La skill solo lee y escribe dentro de su propia carpeta. No toca tu sistema.

Si encuentras una vulnerabilidad o un bug que comprometa la privacidad, abre un issue privado o escribe a aaparicio@iamastersacademy.com.

Contribuir

Esta es una implementación de referencia. Forks bienvenidos. Pull requests bienvenidos si mantienen la skill en su misma línea: agéntica, conversacional, cero dependencias donde sea posible, idioma del usuario configurable.

Ver CITATION.cff si construyes encima de esto y quieres citar.

Licencia

MIT. Úsala. Modifícala. Compártela. Cobra por servicios encima de ella si quieres. Solo mantén el aviso de copyright.

---

_{Construido por Angel Aparicio · IA Masters Academy · @iamasters-academy · aaparicio@iamastersacademy.com}