feedback-mastery

Visión general de la skill feedback-mastery

La skill feedback-mastery es una ayuda de comunicación estructurada para planificar y redactar conversaciones laborales difíciles. Está pensada para esos casos en los que un prompt genérico suele quedarse corto: feedback de desempeño, reajuste de expectativas, tensiones entre colegas, resistencia de stakeholders y 1:1 delicados en los que el tono y el enfoque importan tanto como el mensaje.

Lo que feedback-mastery realmente te ayuda a hacer

feedback-mastery te ayuda a convertir un problema interpersonal confuso en un plan de conversación utilizable. Su valor principal no es simplemente “escribir un mensaje amable”. Aporta marcos prácticos para:

• prepararte antes de la conversación
• expresar el feedback con claridad usando el modelo SBI
• manejar reacciones probables sin escalar el conflicto
• dar seguimiento con próximos pasos y accountability

Para quién encaja mejor feedback-mastery

Esta skill encaja especialmente bien para:

• managers que tienen que dar feedback correctivo o de desarrollo
• tech leads que gestionan fricción entre pares o expectativas incumplidas
• ICs que se preparan para conversaciones difíciles entre funciones
• cualquier persona que necesite formular feedback sin sonar vaga, dura ni defensiva

Es especialmente relevante para equipos de software porque las referencias incluyen ejemplos como plazos, problemas de calidad y alineación de expectativas.

Por qué elegir esto en lugar de un prompt normal

La principal diferencia está en la estructura. El repositorio combina un flujo de trabajo de Preparación-Entrega-Seguimiento con el framework SBI y scripts por escenario. Eso importa porque la mayoría del feedback débil falla de formas bastante previsibles: es demasiado general, demasiado emocional, demasiado acusatorio o no deja claro cuál es el siguiente paso. feedback-mastery está diseñado para reducir esos fallos.

Lo que la gente quiere saber antes de instalar feedback-mastery

La mayoría de quienes evalúan la feedback-mastery skill quieren resolver cuatro dudas rápido:

1. ¿Sirve para conversaciones reales, no solo para teoría?
2. ¿Ayuda con redacción concreta?
3. ¿Puede manejar conflicto y ajuste de expectativas, no solo feedback de manager a reporte directo?
4. ¿Es mejor que pedirle a un asistente que “haga esto más profesional”?

Según los archivos del repositorio, la respuesta es en gran parte sí. Los documentos de referencia añaden scripts reutilizables, orientación para alinear expectativas y una explicación completa de SBI que hace que los resultados sean más consistentes que con un prompt de una sola pasada.

Cuándo feedback-mastery no es la herramienta adecuada

No uses feedback-mastery for Workplace Communication si lo que necesitas principalmente es:

• asesoría de RR. HH. o legal
• guía sobre procesos disciplinarios formales
• terapia, mediación o intervención en crisis
• interpretación de políticas específicas de tu organización

Esta skill mejora el enfoque y la calidad de la conversación. No sustituye políticas internas, revisión legal ni autoridad de gestión.

Cómo usar la skill feedback-mastery

Contexto de instalación de feedback-mastery

feedback-mastery está en softaworks/agent-toolkit, dentro de skills/feedback-mastery.

Si tu entorno admite instaladores de skills, un patrón habitual es:

npx skills add softaworks/agent-toolkit --skill feedback-mastery

Si tu runtime usa otro cargador, añade la skill desde la ruta de GitHub y confirma que el agente puede leer:

• skills/feedback-mastery/SKILL.md
• skills/feedback-mastery/references/difficult-conversation-scripts.md
• skills/feedback-mastery/references/expectation-alignment.md
• skills/feedback-mastery/references/feedback-sbi-model.md

Qué archivos leer primero antes del primer uso

Para entenderla lo más rápido posible, léelos en este orden:

1. SKILL.md para alcance, triggers y flujo de trabajo
2. references/feedback-sbi-model.md para la fórmula de feedback
3. references/difficult-conversation-scripts.md para aperturas y manejo de reacciones
4. references/expectation-alignment.md para conversaciones sobre alcance, plazos y stakeholders
5. README.md para la intención general

Esta ruta de lectura funciona mejor que hojear todo sin orden porque te lleva antes a prompts realmente utilizables.

Qué input necesita feedback-mastery para funcionar bien

La calidad de uso de feedback-mastery usage depende mucho de los hechos en bruto que le des. Proporciona al modelo:

• tu relación con la otra persona
• la situación o los incidentes concretos
• comportamiento observable, no suposiciones sobre motivos
• el impacto en el equipo, el trabajo, la confianza o la entrega
• tu objetivo para la conversación
• restricciones como tono, seniority, urgencia o si será una conversación remota o en vivo

Input débil:

• “Ayúdame a darle feedback a un engineer.”

Input sólido:

• “I’m a tech lead speaking to a mid-level engineer in a 1:1. In the last three sprints, two backend tasks slipped without early warning, and code reviews often arrive after agreed timelines. I want to address reliability without demotivating them. I need a live conversation outline, likely reactions, and a short follow-up summary.”

Cómo convertir un objetivo difuso en una invocación sólida de feedback-mastery

Un buen prompt de feedback-mastery guide suele incluir cinco partes:

1. escenario
2. hechos
3. resultado deseado
4. tono
5. formato de salida

Plantilla útil:

Use feedback-mastery to help me prepare a workplace conversation.
Scenario: [manager/peer/stakeholder/direct report].
Facts: [specific incidents, dates, examples].
Goal: [clarify expectations / address behavior / repair tension / reset scope].
Tone: [direct but supportive / calm and firm / collaborative].
Output: [prep notes, SBI draft, opening lines, likely reactions, follow-up plan].

Mejor flujo de trabajo de feedback-mastery para una conversación en vivo

Un flujo práctico con feedback-mastery es:

1. resumir el problema en lenguaje claro
2. pedir a la skill que separe hechos de interpretaciones
3. generar un borrador SBI
4. pedir una frase de apertura adecuada a vuestra relación
5. pedir de 2 a 4 reacciones probables y respuestas serenas
6. redactar acciones de seguimiento y criterios de éxito
7. acortar el guion final a un lenguaje oral natural

Esta secuencia importa porque mucha gente salta directamente a la redacción antes de tener claro cuál es el mensaje real.

Usa feedback-mastery para reajustar expectativas, no solo para criticar

Una de las partes más útiles del repo es la referencia de alineación de expectativas. Úsala cuando el problema tenga menos que ver con comportamiento y más con supuestos desalineados, una definición poco clara de “hecho” o cambios de alcance que ocurrieron sin explicitarse.

Buen ejemplo de prompt:

Use feedback-mastery for Workplace Communication to help me reset expectations with a product stakeholder. They think a feature will ship this sprint, but a dependency changed and scope expanded. Draft a conversation that clarifies assumptions, defines success explicitly, and proposes a revised plan without sounding defensive.

Cómo obtener mejores scripts a partir de los archivos de referencia

El repositorio rinde mejor cuando le pides a la skill que se apoye en referencias concretas en lugar de generar consejos genéricos. Por ejemplo:

• pide una versión SBI usando references/feedback-sbi-model.md
• pide frases de apertura basadas en references/difficult-conversation-scripts.md
• pide aclaración de expectativas usando references/expectation-alignment.md

Eso suele producir resultados con una estructura más clara y menos frases vagas de manual de management.

Patrones de prompt prácticos que mejoran la calidad de salida

Pide uno de estos entregables en lugar de “ayúdame con feedback”:

• “Write an SBI statement.”
• “Give me a 10-minute conversation outline.”
• “Draft three opening lines with different firmness levels.”
• “List likely defensive reactions and grounded responses.”
• “Turn this emotional draft into behavior-based feedback.”
• “Create a follow-up summary with explicit expectations and dates.”

Estos formatos de salida encajan muy bien con el material del repo.

Errores frecuentes al usar feedback-mastery

Evita estos patrones de input:

• meter cinco problemas en una sola conversación
• describir la intención de la persona en vez de su comportamiento
• pedir un guion sin indicar el resultado deseado
• pedir “redacción profesional” sin aportar los hechos de fondo
• usar la skill para documentación formal de RR. HH. cuando en realidad necesitas guía de políticas

La skill funciona mejor cuando la conversación tiene un foco estrecho y un propósito claro.

Preguntas frecuentes sobre la skill feedback-mastery

¿feedback-mastery es apta para principiantes?

Sí. feedback-mastery resulta accesible para personas que entienden la situación pero no saben cómo estructurar la conversación. Los scripts y la referencia de SBI reducen bastante la improvisación. Aun así, quien empieza debe aportar hechos concretos; la skill no puede inventar evidencia ni contexto.

¿feedback-mastery es solo para managers?

No. Los ejemplos encajan bien con managers, pero el repositorio también sirve para feedback entre pares, manejo de conflictos y alineación de expectativas con stakeholders. Es útil siempre que necesites comunicarte con precisión, calma y orientación a resultados.

¿En qué se diferencia de pedirle a una IA que reescriba mi mensaje?

Un prompt normal de reescritura suele mejorar el tono, pero deja floja la lógica de fondo. La feedback-mastery skill añade un marco: preparación, entrega basada en SBI, reacciones previstas y seguimiento. Eso conduce a mejores conversaciones reales, no solo a una redacción más pulida.

¿Puedo usar feedback-mastery para mensajes escritos en vez de conversaciones en vivo?

Sí, pero su uso más potente es preparar conversaciones habladas. Si necesitas un mensaje de Slack o un email, usa primero la skill para aclarar la lógica y luego pide una versión escrita y concisa. Así evitas enviar un mensaje pulido pero mal enfocado.

¿Cuándo no debería usar feedback-mastery?

No te apoyes solo en feedback-mastery install para:

• situaciones sensibles desde el punto de vista legal o de compliance
• procesos formales de gestión del desempeño
• casos de acoso o seguridad
• rupturas interpersonales graves que requieran la intervención de RR. HH. o liderazgo

En esos casos, usa la skill únicamente como ayuda de comunicación después de confirmar el proceso correcto.

¿feedback-mastery encaja en equipos no técnicos?

Sí. Aunque los ejemplos tienen sabor a equipos de software, los marcos se trasladan bien a otros contextos. SBI, la alineación de expectativas y la preparación de conversaciones difíciles funcionan en producto, operaciones, ventas y colaboración transversal.

Cómo mejorar la skill feedback-mastery

Da hechos más precisos, no una historia más larga

La mayor palanca de mejora para feedback-mastery es la precisión del input. Sustituye afirmaciones amplias como “they are unreliable” por patrones observables:

• “missed two agreed review windows last week”
• “did not communicate a blocker until the deadline day”
• “interrupted two teammates repeatedly during sprint planning”

Esto produce feedback más fácil de expresar y más difícil de cuestionar.

Separa el comportamiento de tu interpretación

Un fallo muy común es alimentar a la skill con suposiciones sobre actitud, pereza o intención. Pide a feedback-mastery que divida tus notas en:

• comportamiento observado
• posible interpretación
• impacto confirmado
• preguntas abiertas por explorar

Eso hace que la conversación final sea más creíble y menos acusatoria.

Pide varios tonos antes de elegir uno

La primera salida puede resultar demasiado suave o demasiado dura para tu cultura de trabajo. Mejora el resultado pidiendo variantes como:

• supportive and coaching
• direct and firm
• collaborative and problem-solving

Esto es especialmente útil en feedback entre pares o en reajustes de expectativas con stakeholders, donde tu autoridad puede ser limitada.

Pon a prueba la conversación frente a reacciones probables

El material de scripts del repositorio aporta más valor cuando lo usas para planificar respuestas. Pide a la skill que simule reacciones como:

• actitud defensiva
• sorpresa
• desvío de culpas
• retirada emocional
• acuerdo sin compromiso real

Después, refina tus respuestas para que la conversación no se desmorone tras la frase inicial.

Mejora el seguimiento, no solo la apertura

Muchas personas se detienen después de generar una buena frase de apertura. Los mejores resultados llegan cuando le pides a feedback-mastery la siguiente capa:

• cómo se vería un buen cambio
• cómo se comprobará el progreso
• qué apoyo puedes ofrecer
• cuándo retomarás el tema

Sin eso, la conversación puede parecer bien pensada pero aun así no producir ningún cambio de comportamiento.

Usa un solo problema por borrador de conversación

Si la primera salida te parece genérica, muchas veces el problema es un alcance demasiado amplio. Ejecuta feedback-mastery por separado para:

• fiabilidad en el desempeño
• brechas de comunicación
• reparación de conflicto
• reajuste de expectativas

Los prompts centrados en un solo asunto producen declaraciones SBI más limpias y scripts más realistas.

Itera tras el primer borrador con tu forma real de hablar

Un buen ciclo de refinamiento es:

1. generar el borrador estructurado
2. reescribirlo con tu estilo natural al hablar
3. pegar de nuevo tu versión revisada
4. pedir a la skill que detecte vaguedad, juicio y riesgo de escalada

Ese flujo conserva el framework sin hacer que la conversación suene a plantilla.

Lee las referencias cuando feedback-mastery te dé resultados genéricos

Si feedback-mastery usage te resulta superficial, la solución más rápida es anclar explícitamente el prompt en los archivos de apoyo. Menciona qué archivo quieres que use el agente y qué entregable esperas de él. Eso suele mejorar la especificidad más que pedir simplemente “más detalle”.

Checklist de mejora para obtener mejor salida con feedback-mastery

Antes de usar el borrador final, confirma que tu salida de feedback-mastery guide incluye:

• un propósito claro
• ejemplos concretos de la situación
• comportamiento observable
• impacto real
• una invitación a responder
• un siguiente paso o plan de seguimiento

Si falta alguno de esos elementos, lo más probable es que la conversación se sienta incompleta o se desvíe del objetivo.