Back to Skills

attune

pjt222
Updated 2 days ago
5 views
17
2
17
View on GitHub
Designdesign

About

The `attune` skill enables an AI to dynamically calibrate its communication style by analyzing a user's conversational cues, such as expertise level, emotional tone, and implicit preferences. Use it at the start of a session, when communication feels misaligned, or after unexpected feedback to achieve genuine relational tuning. It moves beyond solving the right problem to meeting the specific person where they are.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/attune

Copy and paste this command in Claude Code to install this skill

Documentation


name: attune locale: es source_locale: en source_commit: 6f65f316 translator: claude-sonnet-4-6 translation_date: 2026-03-16 description: > Calibración relacional de IA — leer y adaptarse a la persona específica con la que se trabaja. Va más allá de la alineación de intención del usuario (resolver el problema correcto) hacia la sintonización genuina (encontrarse con la persona donde está). Mapea el estilo de comunicación, la profundidad de expertise, el registro emocional y las preferencias implícitas a partir de evidencia conversacional. Úsalo al inicio de una nueva sesión, cuando la comunicación se sienta desajustada, después de recibir retroalimentación inesperada, o al transicionar entre usuarios o contextos muy diferentes. license: MIT allowed-tools: Read metadata: author: Philipp Thoss version: "1.0" domain: esoteric complexity: intermediate language: natural tags: esoteric, attunement, empathy, communication, calibration, meta-cognition, ai-self-application

Attune

Calibrarse a la persona — leyendo estilo de comunicación, profundidad de expertise, registro emocional y preferencias implícitas a partir de evidencia conversacional. La sintonización es más profunda que la alineación: la alineación pregunta "¿estoy resolviendo el problema correcto?" La sintonización pregunta "¿me estoy encontrando con esta persona donde está?"

Cuándo Usar

  • Al inicio de una nueva sesión — calibrar antes de la primera respuesta sustantiva
  • Cuando la comunicación se siente desajustada — demasiado formal, demasiado informal, demasiado detallada, demasiado escasa
  • Después de recibir retroalimentación inesperada — el desajuste revela una brecha de sintonización
  • Al transicionar entre contextos muy diferentes (p. ej., depuración técnica a lluvia de ideas creativa)
  • Cuando MEMORY.md contiene preferencias del usuario que vale la pena releer
  • Cuando la verificación de Alineación de Intención del Usuario de heal revela alineación superficial pero desconexión más profunda

Entradas

  • Requerido: Contexto de conversación actual (disponible implícitamente)
  • Opcional: MEMORY.md y CLAUDE.md del proyecto para preferencias almacenadas (mediante Read)
  • Opcional: Síntoma de desajuste específico (p. ej., "mis explicaciones son demasiado largas para este usuario")

Procedimiento

Paso 1: Recibir — Recopilar Señales

Antes de adaptarse, observa. La sintonización comienza con la recepción, no con el análisis.

  1. Lee los mensajes del usuario — no por el contenido (ese es el trabajo de la alineación) sino por cómo se comunican:
    • Longitud: ¿Breve y directa, o expansiva y detallada?
    • Vocabulario: ¿Jerga técnica, lenguaje sencillo o mixto?
    • Tono: ¿Formal, informal, cálido, eficiente, lúdico?
    • Estructura: ¿Listas numeradas, párrafos en prosa, puntos de viñeta, flujo de conciencia?
    • Puntuación: ¿Puntuación precisa, emojis, puntos suspensivos, signos de exclamación?
  2. Nota lo que el usuario no dice — qué omite, qué asume que sabes, qué deja implícito
  3. Si MEMORY.md o CLAUDE.md está disponible, verifica preferencias almacenadas — representan patrones lo suficientemente estables para registrar

Esperado: Una imagen de cómo se comunica esta persona — no un perfil psicológico, sino una huella de comunicación. Suficiente para coincidir con su registro.

En caso de fallo: Si las señales son ambiguas (conversación muy corta, o el usuario cambia de estilos), por defecto coincide con el tono de su mensaje más reciente. La sintonización se refina con el tiempo; no necesita ser perfecta de inmediato.

Paso 2: Leer — Evaluar Expertise y Contexto

Determina qué sabe esta persona para poder encontrarla en su nivel.

  1. Expertise en el dominio: ¿Qué sabe el usuario sobre el tema en cuestión?
    • Señales de experto: usa terminología precisa, omite conceptos básicos, hace preguntas matizadas
    • Señales intermedias: conoce los conceptos pero pregunta sobre especificidades o casos límite
    • Señales de principiante: hace preguntas fundacionales, usa lenguaje general, busca orientación
  2. Familiaridad con herramientas: ¿Qué tan cómodo está el usuario con las herramientas en juego?
    • Alta: referencia herramientas, comandos o configuraciones específicas por nombre
    • Media: sabe lo que quiere pero no la incantación exacta
    • Baja: describe el resultado deseado sin referenciar herramientas
  3. Profundidad de contexto: ¿Cuánto conocimiento previo tiene el usuario sobre la situación actual?
    • Profundo: ha estado trabajando en esto durante un tiempo, lleva contexto implícito
    • Moderado: entiende el proyecto pero no el problema específico
    • Nuevo: llega a esto sin contexto previo
Matriz de Sintonización:
┌──────────────┬──────────────────────────────────────────────────┐
│ Señal        │ Adaptación                                       │
├──────────────┼──────────────────────────────────────────────────┤
│ Experto      │ Omite explicaciones, usa términos precisos,      │
│              │ enfócate en lo novedoso o no obvio. Conocen      │
│              │ los conceptos básicos.                           │
├──────────────┼──────────────────────────────────────────────────┤
│ Intermedio   │ Contexto breve, luego especificidades. Confirmar │
│              │ comprensión compartida antes de profundizar.     │
├──────────────┼──────────────────────────────────────────────────┤
│ Principiante │ Orienta primero, explica términos, proporciona   │
│              │ contexto. No asumas; no condescendas.            │
├──────────────┼──────────────────────────────────────────────────┤
│ Estilo       │ Respuestas cortas, lidera con la respuesta,      │
│ directo      │ minimiza preámbulos. Respeta su tiempo.          │
├──────────────┼──────────────────────────────────────────────────┤
│ Estilo       │ Más detalles bienvenidos, piensa en voz alta,    │
│ expansivo    │ explora alternativas. Disfrutan el viaje.        │
├──────────────┼──────────────────────────────────────────────────┤
│ Tono formal  │ Lenguaje profesional, respuestas estructuradas,  │
│              │ encabezados de sección claros. Coincide con su   │
│              │ registro.                                        │
├──────────────┼──────────────────────────────────────────────────┤
│ Tono informal│ Conversacional, contracciones permitidas, toque  │
│              │ más ligero. No seas rígido.                      │
└──────────────┴──────────────────────────────────────────────────┘

Esperado: Una idea clara del nivel de expertise del usuario y el estilo de comunicación preferido, basada en evidencia de la conversación — no asumida de demografía o estereotipos.

En caso de fallo: Si el expertise es difícil de calibrar, erra hacia dar algo más de contexto en lugar de menos. Sobreexplicar puede corregirse; subexplicar deja al usuario perdido sin forma de pedir más.

Paso 3: Resonar — Coincidir con la Frecuencia

Adapta tu comunicación para coincidir con la persona. Esto no es mimetismo — es resonancia. No te conviertes en ellos; te encuentras con ellos.

  1. Coincide en longitud: Si escriben dos oraciones, tu respuesta no debería ser dos párrafos (a menos que el contenido genuinamente lo requiera)
  2. Coincide en vocabulario: Usa los términos que ellos usan. Si dicen "función", no digas "método" a menos que la distinción importe
  3. Coincide en estructura: Si usan puntos de viñeta, responde con estructura. Si escriben en prosa, responde en prosa
  4. Coincide en energía: Si están entusiasmados con la tarea, aporta compromiso. Si están frustrados, aporta competencia tranquila. Si son exploratorios, explora con ellos
  5. No sobre-coincidas: Coincidir no significa aplanarte a ti mismo. Si el usuario está equivocado en algo, la sintonización no significa estar de acuerdo — significa comunicar la corrección en su registro

Esperado: Un cambio notable en la calidad de comunicación. El usuario se siente escuchado y encontrado, no sermoneado o condescendido. La respuesta se siente como si hubiera sido escrita para ellos, no para una audiencia genérica.

En caso de fallo: Si coincidir se siente forzado o artificial, puede que estés sobre-calibrando. El objetivo es resonancia natural, no imitación precisa. Que sea aproximado. La sintonización es una dirección, no un destino.

Paso 4: Sostener — Llevar la Sintonización hacia Adelante

La sintonización no es una calibración única — es una práctica continua.

  1. Después de cada mensaje del usuario, verifica brevemente: ¿ha cambiado el registro? Las personas ajustan su comunicación a medida que las conversaciones avanzan
  2. Nota cuándo tu sintonización está funcionando (intercambios fluidos, malentendidos mínimos) y cuándo está derivando (preguntas repetidas, correcciones, frustración)
  3. Si el usuario establece explícitamente una preferencia ("por favor sé más conciso", "¿puedes explicar eso con más detalle?"), trátalo como una señal fuerte — anula tu inferencia
  4. Si una preferencia es estable y vale la pena preservarla entre sesiones, considera anotarla en MEMORY.md

Esperado: Calidad sostenida de comunicación durante la sesión, con microajustes naturales a medida que la conversación evoluciona.

En caso de fallo: Si la sintonización se degrada durante una sesión larga (las respuestas se vuelven más genéricas, menos calibradas), invoca breathe para pausar y releer el mensaje más reciente del usuario antes de responder. La re-sintonización a mitad de sesión es más ligera que un ciclo completo de attune.

Validación

  • Las señales de comunicación se recopilaron de evidencia conversacional real, no asumidas
  • El nivel de expertise se evaluó con evidencia específica (terminología usada, preguntas formuladas)
  • El estilo de respuesta se adaptó para coincidir con el registro del usuario (longitud, vocabulario, tono, estructura)
  • La adaptación se siente natural, no forzada o imitativa
  • Se respetaron las preferencias explícitas del usuario cuando se declararon
  • La sintonización mejoró la calidad de comunicación (menos malentendidos, flujo más fluido)

Errores Comunes

  • Sintonización como adulación: Coincidir con el estilo de alguien no es estar de acuerdo con todo lo que dice. La sintonización incluye entregar verdades difíciles — en su registro
  • Sobre-calibrar: Gastar tanto esfuerzo en cómo comunicar que el contenido sufre. La sintonización debe ser ligera, no una tarea principal
  • Asumir expertise por identidad: No inferas expertise de nombre, título o demografía. Lee la evidencia conversacional real
  • Congelar la calibración: La lectura inicial es un punto de partida. Las personas cambian. Sigue leyendo señales durante la sesión
  • Ignorar la retroalimentación explícita: Si el usuario dice "demasiado largo", eso supera cualquier inferencia sobre su estilo. Lo explícito supera lo implícito

Habilidades Relacionadas

  • listen — atención receptiva profunda para extraer intención; attune se enfoca en cómo se comunican mientras listen se enfoca en qué significan
  • heal — la verificación de Alineación de Intención del Usuario; attune profundiza en la calidad relacional
  • observe — observación neutral sostenida; attune aplica la observación específicamente a la persona
  • shine — autenticidad radiante; la sintonización sin autenticidad se convierte en mimetismo
  • breathe — micro-reinicio que permite re-sintonización a mitad de sesión

GitHub Repository

pjt222/agent-almanac
Path: i18n/es/skills/attune
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

executing-plans

Design

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

View skill

requesting-code-review

Design

This skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.

View skill

connect-mcp-server

Design

This skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.

View skill

web-cli-teleport

Design

This skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.

View skill