faloppad/social-calendar-review

Revisión del calendario social

Una revisión semanal que cierra el ciclo. Examina los últimos 7 días y los próximos 14, luego escribe un informe breve y propone cambios a los archivos markdown que controlan la habilidad social-calendar.

Esta habilidad lee Airtable y nunca escribe en él. Modifica los archivos de estrategia y canal solo después de que el usuario apruebe el cambio, a menos que el mensaje de la rutina indique lo contrario.

Configuración

• AIRTABLE_TOKEN y AIRTABLE_BASE_ID, en el entorno o en un archivo .env en el directorio de trabajo o raíz del repositorio.
• STRATEGY_DIR apuntando a la carpeta con strategy.md y channels/. Si no está definido, busca strategy.md en el directorio de trabajo, ./my-strategy/ y ./strategy/.
• El script del calendario de la habilidad principal: skills/social-calendar/scripts/airtable_calendar.py (en adelante, $CAL). El conector MCP de Airtable también funciona si está conectado.

Pasos

1. Cargar las reglas

Lee strategy.md y todos los archivos channels/*.md de canales activos (python3 $CAL channels). Anota para cada canal: cadencia objetivo, tipos de publicación permitidos, reglas de voz, palabras o temas prohibidos, reglas de hashtags y el propietario. Anota los OKR y pilares de contenido actuales de la estrategia.

Si existe la revisión de la semana pasada en $STRATEGY_DIR/reviews/, léela y verifica si se aplicaron las propuestas aceptadas.

2. Mirar atrás 7 días

python3 $CAL list --from -7 --to today --json > /tmp/review-past.json

De esa lista, revisa:

• Publicaciones En vivo. Son el tema principal.
• Publicaciones Fallidas y Manuales. ¿Se solucionaron los fallos? ¿Alguien publicó realmente las manuales?
• Publicaciones Por aprobar, Necesita medios y Aprobadas con fecha pasada. Son aprobaciones perdidas o un publicador que no se ejecutó.

Verifica cada publicación En vivo contra su archivo de canal y la estrategia:

• Voz y formato. ¿Suena como los ejemplos del archivo de canal? ¿Longitud, hashtags, enlaces, emojis según el archivo?
• Adecuación. ¿Sirve a un pilar u OKR en strategy.md? ¿El tipo de publicación está permitido en este canal?
• Cadencia. Cuenta por canal contra el objetivo. Anota los canales que superan o no alcanzan.
• Repetición. Publicaciones casi idénticas en el mismo canal, o el mismo mensaje en todos los canales el mismo día.
• Hechos. Afirmaciones, números y nombres que el campo Fuente no respalde.

Solo informa problemas que puedas señalar con una publicación específica. Cita el nombre del registro y la fecha.

3. Mirar adelante 14 días

python3 $CAL list --from +1 --to +14 --json > /tmp/review-next.json

Por canal y semana, señala:

• Brechas: semanas por debajo del objetivo de cadencia. Sugiere qué tipo de publicación las llenaría con contenido ya disponible (un podcast con clips sin usar, un artículo reciente).
• Sobrecarga: más de una publicación al día en un canal, o una semana dominada por un solo tipo (tres noticias, promociones consecutivas).
• Publicaciones fuera de estrategia: contenido que no coincide con ningún pilar o que el archivo de canal descarta.
• Cuellos de botella de aprobación: publicaciones Por aprobar con fecha en los próximos 3 días, agrupadas por Propietario, para que alguien pueda darles seguimiento.
• Publicaciones Necesita medios con fecha en los próximos 7 días, indicando qué necesita cada una.

4. Obtener métricas donde sea posible

Intenta en este orden y usa lo que esté disponible:

1. Un conector de plataforma, como un conector de LinkedIn u otro MCP de análisis. Obtén impresiones, reacciones, comentarios, republicaciones y clics por publicación de los últimos 7 días y empareja con los registros mediante Enlace en vivo o fecha y canal.
2. Un conector de analíticas web (GA4 o similar). Obtén sesiones desde referentes sociales o enlaces con etiquetas UTM de la semana.
3. Exportaciones manuales: archivos CSV en $STRATEGY_DIR/metrics/ (por ejemplo, una exportación de análisis de página de LinkedIn). Usa el archivo más reciente por canal y di qué archivo leíste.

Cuando no exista ninguno de estos para un canal, escribe "Sin métricas para esta semana" y continúa. Nunca estimes, extrapoles ni inventes números. Una revisión sin métricas sigue siendo útil para las comprobaciones de estrategia y cadencia.

Con métricas, compara solo publicaciones del mismo canal. Busca patrones que se repitan en al menos 3 publicaciones, como tipo de publicación, estilo de apertura, presencia o ausencia de medios, día de la semana. Una sola publicación buena o mala no es un patrón.

5. Escribir el informe

Guárdalo en $STRATEGY_DIR/reviews/YYYY-MM-DD.md (crea la carpeta si es necesario) y muéstralo. Mantenlo en una pantalla:

# Revisión social, semana del 2026-11-02

## Resumen
De tres a cinco frases sencillas. Qué salió, qué falló, el único cambio que vale la pena hacer.

## Últimos 7 días
| Canal | En vivo | Objetivo | Fallidas | Notas |
|---|---|---|---|---|

Problemas específicos, un punto cada uno, con nombre del registro y fecha.

## Métricas
Por canal: lo que encontraste y su fuente, o "Sin métricas para <canal> esta semana".

## Próximos 14 días
Brechas, sobrecarga, publicaciones fuera de estrategia, aprobaciones por perseguir (por propietario), medios aún necesarios.

## Cambios propuestos
Lista numerada. Cada uno nombra el archivo, explica por qué en una frase y muestra un diff.

6. Proponer cambios a los archivos de estrategia y canal

Propón un cambio solo cuando la evidencia de esta semana lo respalde: un error repetido, una regla que nadie sigue, una cadencia que no se mantiene, o un patrón en las métricas a lo largo de varias publicaciones. Cada propuesta es un diff unificado contra el archivo actual:

--- channels/brightloop-linkedin.md
+++ channels/brightloop-linkedin.md
@@ Cadencia @@
-- 5 publicaciones por semana, de lunes a viernes
+- 4 publicaciones por semana, de lunes a jueves. Las publicaciones de los viernes recibieron menos de la mitad de las reacciones que otros días en las últimas 6 semanas.

No apliques los diffs. Enuméralos y espera a que el usuario diga cuáles aplicar. Aplícalos sin preguntar solo si el mensaje de la rutina lo permite explícitamente, y solo para el tipo de cambio que nombre. Nunca cambies el archivo de canal de otra persona sin su aprobación, incluso cuando esté permitido aplicar cambios.

No edites registros de Airtable desde esta habilidad. Si una publicación planificada debe cambiar, di cuál y por qué. El usuario o la habilidad social-calendar harán el cambio.

Ejemplo de mensaje de rutina

Configúrala como una tarea programada semanal o rutina, por ejemplo todos los lunes a las 08:00, con el repositorio como directorio de trabajo:

Ejecuta la habilidad social-calendar-review de la semana pasada.
STRATEGY_DIR es ./my-strategy. Las credenciales de Airtable están en .env.
Usa el conector de LinkedIn para métricas si está disponible. De lo contrario, lee el CSV
más reciente en ./my-strategy/metrics/ para cada canal, y di claramente dónde no hay.
Guarda el informe en ./my-strategy/reviews/ y publica las secciones Resumen y Cambios propuestos
en #marketing en Slack.
No apliques ningún cambio propuesto. Responderé con los números que quiero aplicar.

Para permitir que la rutina haga pequeñas correcciones por su cuenta, reemplaza la última línea con algo como "Puedes aplicar cambios propuestos a listas de hashtags y días de publicación en mis propios archivos de canal. Deja todo lo demás como propuesta."