internal-comms
por alirezarezvaniinternal-comms ayuda a los equipos a redactar y secuenciar comunicaciones de cambio dirigidas a empleados para reorganizaciones, despidos, despliegues de herramientas, cambios de políticas, transiciones de liderazgo y lanzamientos internos. Usa ADKAR, Kotter, plantillas de brief y scripts de Python para generar anuncios, FAQs, puntos de conversación para managers y un calendario de puntos de contacto.
Esta skill obtiene 84/100, lo que la convierte en una candidata sólida para usuarios de directorios que necesitan comunicaciones internas de gestión del cambio asistidas por agentes. El repositorio aporta suficiente sustancia de flujo de trabajo, scripts, plantillas, disparadores y material de referencia para que un agente pueda ejecutarla con bastante menos conjetura que con un prompt genérico, aunque la guía de instalación y configuración podría ser más clara.
- Alta capacidad de activación: el frontmatter menciona casos de uso concretos, como anuncios para all-hands, comunicaciones de cambio, anuncios de reestructuración, puntos de conversación para managers y comunicaciones sobre despidos, y excluye explícitamente las comunicaciones dirigidas a clientes.
- Artefactos útiles para la operación: la skill incluye tres scripts basados solo en la stdlib que generan un paquete de comunicación, un anuncio etiquetado con Kotter y un calendario secuenciado de puntos de contacto ADKAR.
- Buena divulgación progresiva y señales de confianza: las referencias de apoyo documentan ADKAR, Kotter, el canon de internal-comms y antipatrones de anuncios, mientras que la plantilla de brief ofrece a los usuarios una estructura práctica para aportar información.
- No hay ningún comando de instalación ni README en la ruta de la skill, por lo que los usuarios quizá tengan que deducir la configuración a partir del repositorio general o de las convenciones del ejecutor de skills.
- El flujo de trabajo depende de preparar un `comms_brief.json` estructurado; aunque existe una plantilla, adoptarlo sigue exigiendo recopilar la información con cuidado en situaciones sensibles como despidos o reorganizaciones.
Descripción general de la skill internal-comms
Para qué sirve internal-comms
internal-comms es una skill de operaciones de negocio para redactar y secuenciar comunicaciones de cambio dirigidas a empleados. Está pensada para momentos exclusivamente internos, como reorganizaciones, despliegues de herramientas, cambios de políticas, transiciones de liderazgo, despidos, adquisiciones, cambios en beneficios y lanzamientos internos de producto. Su objetivo no es “escribir un anuncio pulido”, sino producir un paquete de comunicación utilizable: anuncio, FAQ, notas para la cascada de managers, mensajes de seguimiento y calendario de puntos de contacto.
Usuarios y decisiones para los que mejor encaja
La skill internal-comms funciona mejor para Heads of People, responsables de BizOps, chiefs of staff, propietarios de comunicación interna y operadores que necesitan convertir un cambio sensible en un plan de comunicación estructurado. Ayuda a decidir el momento, el responsable, la combinación de canales, la segmentación de audiencias y qué conviene no decir. Es especialmente útil cuando los empleados necesitan claridad sobre comportamientos esperados, no solo estar informados.
Qué hace diferente a esta skill
A diferencia de un prompt genérico, internal-comms combina la secuenciación Prosci ADKAR con el modelo de cambio de 8 pasos de Kotter e incluye helpers en Python que usan solo la stdlib. Los scripts pueden generar un anuncio etiquetado según Kotter, un calendario de 7 puntos de contacto, artefactos marcados con ADKAR y advertencias sobre fallos comunes, como anunciar despidos solo por Slack, omitir la cascada de managers o usar un tono que no corresponde a cambios disruptivos.
Cuándo no encaja
No uses internal-comms para anuncios a clientes, comunicados de PR, mensajes para inversores, lanzamientos de marketing ni determinaciones legales. Puede ayudar a estructurar comunicaciones para empleados, pero no sustituye a HR, asesoría laboral, asesoría en valores, consulta con comités de empresa o aprobación ejecutiva en cambios de alto riesgo.
Cómo usar la skill internal-comms
Instalación de internal-comms y primeros archivos que conviene revisar
Instala la skill internal-comms desde el repositorio con:
npx skills add alirezarezvani/claude-skills --skill internal-comms
Luego revisa los archivos que más influyen en la calidad real del resultado:
SKILL.mdpara alcance, disparadores, flujo de trabajo y restriccionesassets/comms_brief_template.mdpara el formato del brief de entradascripts/comms_template_filler.pypara generar paquetes etiquetados con ADKARscripts/change_announcement_builder.pypara redactar anuncios alineados con Kotterscripts/comms_calendar_builder.pypara secuenciación y advertencias de canalreferences/announcement_anti_patterns.mdantes de enviar borradores sensiblesreferences/change_management_canon.mdyreferences/internal_comms_canon.mdpara entender el modelo operativo detrás de la skill
Primero construye un brief de comunicación completo
La skill funciona mejor cuando le das un brief concreto, no una solicitud vaga. Entre los datos útiles están el tipo de cambio, la magnitud, la fecha de entrada en vigor, las audiencias afectadas, la razón de negocio, los cambios concretos, el responsable de la decisión, los canales disponibles, el rol de los managers, los riesgos, las objeciones conocidas y lo que todavía no se sabe.
Un prompt débil sería:
Write a reorg announcement for engineering.
Un prompt más sólido sería:
Use the internal-comms skill for a high-magnitude reorg. Platform and Infrastructure are merging into one Platform Engineering group on June 15. 82 employees are affected. Reporting lines, on-call rotation, and roadmap ownership change. Decision owner is the CTO; managers need talking points before the all-hands. Available channels: manager cascade, email, allhands, Slack, intranet. Main employee concerns: role security, manager changes, promotion timing, and on-call load. Produce the announcement, FAQ, manager talking points, and sequencing calendar.
Ejecuta los scripts auxiliares cuando necesites repetibilidad
El repositorio incluye scripts deterministas en Python que puedes ejecutar localmente después de completar comms_brief.json a partir de assets/comms_brief_template.md:
python3 scripts/comms_template_filler.py --input comms_brief.json --output markdown
python3 scripts/change_announcement_builder.py --input comms_brief.json --profile scaleup --output markdown
python3 scripts/comms_calendar_builder.py --input comms_brief.json --output markdown
Los perfiles incluyen tech-startup, scaleup, enterprise, public-company y non-profit. Elige el perfil según gobernanza y tono, no según aspiración. Por ejemplo, public-company debería ser más conservador que tech-startup.
Flujo práctico de uso de internal-comms
Empieza por el brief, genera el paquete y luego revísalo en este orden: calendario, cascada de managers, anuncio, FAQ y seguimiento. El calendario va primero porque los errores de secuenciación deterioran la confianza incluso cuando el anuncio suena pulido. Para cambios importantes o disruptivos, verifica que los managers estén informados antes del anuncio amplio, que se incluyan canales síncronos y que el FAQ responda de forma directa las preguntas obvias de los empleados.
FAQ de la skill internal-comms
¿internal-comms es solo para empresas grandes?
No. La skill internal-comms puede ayudar a startups, scaleups, enterprises, public companies y non-profits, pero el valor de adopción varía. Los equipos pequeños se benefician de la claridad y la secuenciación; las organizaciones más grandes se benefician de la segmentación de audiencias, la disciplina en la cascada de managers y los artefactos de revisión repetibles.
¿Por qué es mejor que pedir un borrador de anuncio?
Un prompt normal puede producir un mensaje fluido, pero pasar por alto la mecánica de gestión del cambio. internal-comms empuja explícitamente hacia etapas ADKAR, pasos de Kotter, secuenciación de canales, preparación de managers, cobertura de FAQ y revisión de antipatrones. Eso importa cuando el riesgo no es la gramática, sino la confianza de los empleados, la comprensión, el control de rumores y la adopción de nuevos comportamientos.
¿Pueden usar internal-comms personas principiantes?
Sí, si usan la plantilla de brief. Quienes empiezan deberían evitar arrancar con “haz que esto suene mejor” y, en su lugar, recopilar hechos: quién se ve afectado, qué cambia, por qué ahora, qué deben hacer los empleados, qué deben decir los managers y qué todavía no puede responderse. La skill tiene suficiente estructura para guiar a no especialistas, pero los eventos sensibles aun así requieren revisión experta.
¿Cuándo debería evitar usar esta skill?
Evítala cuando la audiencia sea externa, cuando el mensaje necesite negociación legal antes de redactarse o cuando el liderazgo no haya decidido todavía el cambio real. La skill puede hacer visibles las brechas, pero no puede resolver una decisión inexistente, una política contradictoria ni un plan de impacto en personas que aún no ha sido aprobado.
Cómo mejorar la skill internal-comms
Dale a internal-comms datos y restricciones más precisos
La mejora más importante es aumentar la especificidad de la entrada. Incluye fechas exactas, segmentos afectados, canales, responsables de decisión, magnitud, acciones requeridas y preocupaciones conocidas de los empleados. Si el cambio es negativo, dilo con claridad. Los scripts están diseñados para señalar problemas de tono, así que esconder un despido o una reorganización disruptiva detrás de “exciting update” reduce la calidad del resultado.
Revisa los fallos comunes
Usa references/announcement_anti_patterns.md como checklist antes de enviar. Presta atención a la responsabilidad formulada en voz pasiva, razones de negocio vagas, falta de guía para managers, ausencia de seguimiento, uso excesivo de Slack para noticias disruptivas o un FAQ que evita las preguntas que los empleados realmente harán. No son problemas de estilo; son riesgos para la adopción y la confianza.
Mejora los prompts con segmentación de audiencias
Pide resultados por audiencia cuando el impacto sea distinto. Por ejemplo, mensajes separados para empleados directamente afectados, equipos afectados de forma indirecta, managers, ejecutivos y funciones de soporte. Esto ayuda a que la skill internal-comms produzca FAQs y talking points más útiles, porque cada grupo tiene necesidades diferentes de Awareness, Desire, Knowledge, Ability y Reinforcement.
Itera después del primer resultado
Después del primer borrador, no pidas solo una versión más corta o más cálida. Haz preguntas de seguimiento específicas: “Which Kotter step is weakest?”, “What obvious FAQ question is missing?”, “Where does the tone mismatch the magnitude?”, “What should managers know before employees ask?”, o “Which touchpoint should happen before T+0?” Así, internal-comms pasa de ser una ayuda para redactar a convertirse en un sistema práctico de revisión de Workplace Communication.