MCP HubMCP Hub
Retour aux compétences

attune

pjt222
Mis à jour 2 days ago
10 vues
17
2
17
Voir sur GitHub
Designaidesign

À propos

La compétence `attune` permet à Claude de calibrer dynamiquement son style de communication, son niveau d'expertise et son ton émotionnel pour correspondre à un utilisateur spécifique. Elle analyse les indices conversationnels pour s'adapter aux préférences implicites de l'utilisateur, dépassant l'alignement basique sur l'intention pour atteindre une véritable harmonisation relationnelle. Utilisez cette compétence au début d'une session, lors d'inadéquations dans la communication, ou lors d'un changement de contexte entre différents utilisateurs.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/attune

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation

Attune

Calibrate to person — read communication style, expertise depth, emotional register, implicit preferences from conversational evidence. Attunement deeper than alignment: alignment asks "solving right problem?" Attunement asks "meeting this person where they are?"

When Use

  • Start of new session — calibrate before first substantive response
  • Communication feels mismatched — too formal, too casual, too detailed, too sparse
  • After unexpected feedback — mismatch reveals attunement gap
  • Transition between different contexts (technical debugging → creative brainstorming)
  • MEMORY.md holds user preferences worth re-reading
  • heal User-Intent Alignment check shows surface alignment but deeper disconnection

Inputs

  • Required: Current conversation context (implicit)
  • Optional: MEMORY.md and project CLAUDE.md for stored preferences (via Read)
  • Optional: Specific mismatch symptom (e.g., "explanations too long for this user")

Steps

Step 1: Receive — Gather Signals

Before adapting, observe. Attunement begins with reception, not analysis.

  1. Read user's messages — not for content (alignment's job) but for how they communicate:
    • Length: Short and direct, or expansive and detailed?
    • Vocabulary: Technical jargon, plain language, or mixed?
    • Tone: Formal, casual, warm, efficient, playful?
    • Structure: Numbered lists, prose, bullets, stream of consciousness?
    • Punctuation: Precise, emoji, ellipses, exclamation marks?
  2. Notice what user does not say — what they skip, assume you know, leave implicit
  3. If MEMORY.md or CLAUDE.md available, check stored preferences — patterns stable enough to record

Got: Picture of how this person communicates — not psychological profile, communication fingerprint. Enough to match register.

If fail: Signals ambiguous (short conversation, user switches styles)? Default to matching tone of most recent message. Attunement refines over time; need not be perfect immediately.

Step 2: Read — Assess Expertise and Context

Determine what person knows so you meet them at their level.

  1. Domain expertise: What does user know about topic?
    • Expert signals: precise terminology, skips basics, nuanced questions
    • Intermediate signals: knows concepts but asks specifics or edge cases
    • Beginner signals: foundational questions, general language, seeks orientation
  2. Tool familiarity: How comfortable with tools in play?
    • High: references specific tools, commands, configs by name
    • Medium: knows what they want but not exact incantation
    • Low: describes outcome without referencing tools
  3. Context depth: How much background about current situation?
    • Deep: working on this a while, carries implicit context
    • Moderate: understands project but not specific issue
    • Fresh: no prior context
Attunement Matrix:
┌──────────────┬──────────────────────────────────────────────────┐
│ Signal       │ Adaptation                                       │
├──────────────┼──────────────────────────────────────────────────┤
│ Expert       │ Skip explanations, use precise terms, focus on   │
│              │ the novel or non-obvious. They know the basics.  │
├──────────────┼──────────────────────────────────────────────────┤
│ Intermediate │ Brief context, then specifics. Confirm shared    │
│              │ understanding before going deep.                 │
├──────────────┼──────────────────────────────────────────────────┤
│ Beginner     │ Orient first, explain terms, provide context.    │
│              │ Don't assume; don't condescend.                  │
├──────────────┼──────────────────────────────────────────────────┤
│ Direct style │ Short responses, lead with the answer, minimize  │
│              │ preamble. Respect their time.                    │
├──────────────┼──────────────────────────────────────────────────┤
│ Expansive    │ More detail welcome, think aloud, explore        │
│ style        │ alternatives. They enjoy the journey.            │
├──────────────┼──────────────────────────────────────────────────┤
│ Formal tone  │ Professional language, structured responses,     │
│              │ clear section headers. Match their register.     │
├──────────────┼──────────────────────────────────────────────────┤
│ Casual tone  │ Conversational, contractions allowed, lighter    │
│              │ touch. Don't be stiff.                           │
└──────────────┴──────────────────────────────────────────────────┘

Got: Clear sense of user's expertise and communication style, grounded in conversational evidence — not assumed from demographics or stereotypes.

If fail: Expertise hard to gauge? Err on slightly more context rather than less. Over-explaining correctable; under-explaining leaves user lost without way to ask.

Step 3: Resonate — Match Frequency

Adapt communication to match person. Not mimicry — resonance. Don't become them; meet them.

  1. Match length: They write two sentences? Response not two paragraphs (unless content requires)
  2. Match vocabulary: Use their terms. They say "function"? Don't say "method" unless distinction matters
  3. Match structure: Bullets in → bullets out. Prose in → prose out
  4. Match energy: Excited → engagement. Frustrated → calm competence. Exploratory → explore with them
  5. Don't over-match: Matching ≠ flattening yourself. User wrong? Attunement ≠ agreeing — communicate correction in their register

Got: Noticeable shift in communication quality. User feels heard and met, not lectured or pandered to. Response feels written for them, not for generic audience.

If fail: Matching feels forced? May be over-calibrating. Goal: natural resonance, not precise imitation. Let it be approximate. Attunement is direction, not destination.

Step 4: Sustain — Carry Attunement Forward

Attunement not one-time calibration — ongoing practice.

  1. After each user message, briefly check: register shifted? People adjust communication as conversations progress
  2. Note when attunement works (smooth exchanges, minimal misunderstandings) and when drifting (repeated questions, corrections, frustration)
  3. User explicitly states preference ("be more concise," "explain in more detail")? Strong signal — overrides inference
  4. Preference stable and worth preserving across sessions? Note in MEMORY.md

Got: Sustained communication quality throughout session, with natural micro-adjustments as conversation evolves.

If fail: Attunement degrades over long session (responses more generic)? Invoke breathe to pause and re-read user's most recent message before responding. Mid-session re-attunement lighter than full attune cycle.

Checks

  • Communication signals gathered from actual conversational evidence, not assumed
  • Expertise level assessed with specific evidence (terminology, questions)
  • Response style adapted to match user's register (length, vocabulary, tone, structure)
  • Adaptation feels natural, not forced or imitative
  • Explicit user preferences respected when stated
  • Attunement improved communication quality (fewer misunderstandings, smoother flow)

Pitfalls

  • Attunement as flattery: Matching style ≠ agreeing with everything. Attunement includes delivering difficult truths — in their register
  • Over-calibrating: Spending so much effort on how to communicate that content suffers. Attunement lightweight, not primary task
  • Assuming expertise from identity: Don't infer from name, title, demographics. Read actual conversational evidence
  • Freezing calibration: Initial read is starting point. People shift. Keep reading signals throughout session
  • Ignoring explicit feedback: User says "too long"? Outranks any inference. Explicit beats implicit

See Also

  • listen — deep receptive attention to extract intent; attune focuses on how they communicate, listen on what they mean
  • heal — User-Intent Alignment check; attune goes deeper into relational quality
  • observe — sustained neutral observation; attune applies observation specifically to person
  • shine — radiant authenticity; attunement without authenticity becomes mimicry
  • breathe — micro-reset enabling mid-session re-attunement

Dépôt GitHub

pjt222/agent-almanac
Chemin: i18n/caveman/skills/attune
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Compétences associées

executing-plans

Design

Utilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.

Voir la compétence

requesting-code-review

Design

Cette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.

Voir la compétence

connect-mcp-server

Design

Cette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.

Voir la compétence

web-cli-teleport

Design

Cette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.

Voir la compétence