# Pencil Ig Carousel

> Claude Code skill to create Instagram, TikTok, and LinkedIn carousels in Pencil and publish via Buffer API

- **Type:** MCP server
- **Install:** `agentstack add mcp-stivenrosales-pencil-ig-carousel`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [stivenrosales](https://agentstack.voostack.com/s/stivenrosales)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [stivenrosales](https://github.com/stivenrosales)
- **Source:** https://github.com/stivenrosales/pencil-ig-carousel

## Install

```sh
agentstack add mcp-stivenrosales-pencil-ig-carousel
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# pencil-ig-carousel

**Skill de [Claude Code](https://claude.com/claude-code) para crear carruseles de Instagram, TikTok y LinkedIn dentro de [Pencil](https://pencil.so) y publicarlos automáticamente con la API de Buffer.**

[](https://claude.com/claude-code)
[](https://pencil.so)
[](https://buffer.com)
[](https://modelcontextprotocol.io)

[](https://instagram.com)
[](https://tiktok.com)
[](https://linkedin.com)

[](LICENSE)
[](#contribuir)
[](#autor)

---

## ¿Qué hace?

Le das a Claude Code un artículo, noticia, o tema, y el skill va a:

1. 📋 **Planear** la estructura del carrusel (hook → explicación → features → CTA)
2. 🖼️ **Pedirte las imágenes** (generadas con IA, screenshots, o assets propios)
3. 🎨 **Construir** cada slide en Pencil usando la integración MCP
4. 📤 **Exportar** en diferentes escalas (x1 para TikTok, x3 para Instagram) + PDF
5. 🚀 **Publicar** en Instagram, TikTok y LinkedIn vía Buffer API con captions adaptados por plataforma

---

## ✨ Características

- 🎨 **Sistema de diseño consistente** — colores, tipografía y layouts predefinidos
- 📐 **Formato 4:5 optimizado** para el feed de Instagram (1080x1350)
- 🔄 **Exportación multi-escala** — x1 para TikTok, x3 para Instagram, PDF para revisión
- ✍️ **Copy adaptado por plataforma** — hashtags en IG, 150 caracteres en TikTok, profesional en LinkedIn
- 🔐 **Credenciales seguras** — manejadas con variables de entorno, nunca hardcoded
- 🌎 **Multi-cuenta** — soporta cuentas separadas (ejemplo: marca vs personal)

---

## 📦 Requisitos

- [Claude Code](https://claude.com/claude-code) instalado
- [Pencil](https://pencil.so) instalado con MCP configurado
- Cuenta de [Buffer](https://buffer.com) con acceso a la API
- macOS o Linux (usa variables de entorno del shell)

---

## 🚀 Instalación

### 1. Clona el repo en tu carpeta de skills

```bash
git clone https://github.com/stivenrosales/pencil-ig-carousel.git ~/.claude/skills/pencil-ig-carousel
```

### 2. Configura tus credenciales de Buffer

Crea el archivo `~/.claude/.env.skills`:

```bash
# Buffer API — Cuenta principal (Instagram + TikTok)
export BUFFER_API_KEY_PRIMARY="tu-api-key-aqui"
export BUFFER_CHANNEL_IG="tu-channel-id-de-instagram"
export BUFFER_CHANNEL_TIKTOK="tu-channel-id-de-tiktok"

# Buffer API — Cuenta secundaria (LinkedIn, opcional)
export BUFFER_API_KEY_SECONDARY="tu-api-key-de-linkedin"
export BUFFER_CHANNEL_LINKEDIN="tu-channel-id-de-linkedin"
```

Configura los permisos del archivo:

```bash
chmod 600 ~/.claude/.env.skills
```

### 3. Carga las credenciales en tu shell

Agrega esta línea a tu `~/.zshrc` (o `~/.bashrc`):

```bash
[ -f ~/.claude/.env.skills ] && source ~/.claude/.env.skills
```

Después abre una terminal nueva o ejecuta `source ~/.zshrc`.

### 4. Obtén tus credenciales de Buffer

1. Entra a [publish.buffer.com](https://publish.buffer.com) e inicia sesión
2. Genera una API key en **Settings → Developer**
3. Usa la query GraphQL que está en el SKILL.md ("Step 1: Get organization and channels") para encontrar los channel IDs de cada red social

### 5. Verifica el setup

```bash
echo $BUFFER_API_KEY_PRIMARY
```

Si ves tu key, ya está listo. Si está vacío, revisa que hayas abierto una terminal nueva después de editar `.zshrc`.

---

## 💡 Cómo usarlo

En Claude Code, abre un archivo `.pen` en Pencil y pídele:

```
Crea un carrusel de Instagram sobre [tu tema] usando el skill pencil-ig-carousel
```

Claude Code va a:
1. Presentarte la estructura de los slides para que la apruebes
2. Pedirte las imágenes que necesita
3. Construir el carrusel en Pencil
4. Exportar los slides
5. Publicarlos vía Buffer en las redes que configuraste

---

## 🎨 Sistema de diseño

El skill usa un sistema de diseño predefinido (colores, tipografía, espaciado) pensado para carruseles de alto engagement. Puedes personalizarlo editando `SKILL.md` directamente.

| Elemento | Slide claro | Slide oscuro |
|----------|-------------|--------------|
| Fondo | `#FAF9F6` + gradiente radial | `#171717` |
| Acento | `#00A86B` | `#00A86B` |
| Título | `#171717` | `#FFFFFF` |
| Body | `#555555` | `#FFFFFFA0` |

**Tipografía:** Inter, tamaños 20-74px.

---

## 📱 Reglas por plataforma

El skill adapta automáticamente el caption según la plataforma:

| Plataforma | Tono | Límite | Hashtags |
|------------|------|--------|----------|
| 📸 **Instagram** | Casual, con emojis | Sin límite | ✅ Permitidos |
| 🎵 **TikTok** | Directo y corto | 150 caracteres | ✅ Incluidos en el límite |
| 💼 **LinkedIn** | Profesional, valor de negocio | Sin límite | ❌ No (o máximo 3) |

---

## 🔒 Seguridad

- El archivo `~/.claude/.env.skills` debe tener permisos `600`
- **Nunca hagas commit de ese archivo** — ya está en el `.gitignore`
- Si usas un repo de dotfiles, agrega `.env.skills` a su lista de ignorados
- Las credenciales nunca salen de tu máquina local

---

## 🤝 Contribuir

Los issues y PRs son bienvenidos. Si extiendes el sistema de diseño o agregas integraciones con otras plataformas, abre un PR.

---

## 📄 Licencia

MIT — ver [LICENSE](LICENSE)

---

## 👤 Autor

Hecho por [@stivenrosales](https://github.com/stivenrosales)

[](https://youtube.com/@stivenrosalesc)
[](https://instagram.com/stiven.rosalesc/)
[](https://www.linkedin.com/in/stiven-kevin-rosales-casas/)

---

**¿Te sirvió este skill?** ⭐ Dale una estrella al repo y compártelo con otros creadores.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [stivenrosales](https://github.com/stivenrosales)
- **Source:** [stivenrosales/pencil-ig-carousel](https://github.com/stivenrosales/pencil-ig-carousel)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-stivenrosales-pencil-ig-carousel
- Seller: https://agentstack.voostack.com/s/stivenrosales
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.