Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
日本語の概要は準備中です。原文の説明を表示しています。
Navigate difficult conversations and deliver constructive feedback using structured frameworks. Covers the Preparation-Delivery-Follow-up model and Situation-Behavior-Impact (SBI) feedback technique. Use when preparing for difficult conversations, giving feedback, or managing conflicts.
インストール方法を見るインストールする前に、エージェントに与えられる指示の中身を確認できます。
This skill provides frameworks for navigating difficult workplace conversations and delivering effective feedback. Whether you're addressing performance issues, resolving conflicts, or giving constructive feedback, these structured approaches lead to better outcomes.
Core insight: Research shows that employees who approach difficult conversations with preparation and a clear framework are 60% more likely to reach a positive resolution than those who engage without a plan.
Use this skill when:
Keywords: feedback, difficult conversation, 1:1, one-on-one, performance, conflict, expectations, behavior, confrontation
A three-part structure for difficult conversations:
| Phase | Focus | Key Questions |
|---|---|---|
| Preparation | Understand the issue, define goals, manage emotions | What's the problem? What outcome do I want? Am I calm? |
| Delivery | Open neutrally, use facts not blame, encourage dialogue | How do I start? What evidence do I have? How do I involve them? |
| Follow-up | Document actions, set check-ins, provide support | What did we agree to? When will we check in? How do I support? |
Situation-Behavior-Impact (SBI) structures feedback to be specific, objective, and actionable:
| Component | Description | Example |
|---|---|---|
| Situation | Describe the specific context | "During yesterday's code review..." |
| Behavior | State the observable action (not interpretation) | "...you interrupted Sarah three times while she was explaining her approach..." |
| Impact | Explain the effect on team/project/person | "...which made her hesitate to share ideas and slowed down our discussion." |
Why it works: SBI removes assumptions and focuses on observable facts, reducing defensiveness.
Ask yourself:
Before the conversation, clarify what you're seeking:
| Goal Type | Example |
|---|---|
| Behavior change | "I want them to submit code reviews on time" |
| Mutual understanding | "I want to understand what's blocking them" |
| Expectation setting | "I want to clarify what 'done' means for features" |
| Problem solving | "I want to find a solution together" |
Tip: Use if-then statements to clarify stakes:
"If this behavior continues, then the project timeline will suffer, leading to missed deliverables."
High emotional intensity reduces cognitive processing by 30%. Before the conversation:
Reframing technique:
| Accusatory | Constructive |
|---|---|
| "You always miss deadlines and it slows everyone down" | "I've noticed some recent delays and want to understand any challenges you're facing" |
| "You never test your code properly" | "I've seen a few bugs slip through recently. Let's talk about our testing process" |
| Context | Opening |
|---|---|
| General | "I want to talk about something important to our team's success, and I'd love to hear your perspective." |
| Performance | "I've noticed some patterns I'd like to discuss. My goal is to support you, not criticize." |
| Conflict | "I sense there might be some tension, and I'd like to understand what's happening from your side." |
| Expectations | "I want to make sure we're aligned on expectations. Can we talk through how this project is going?" |
| Blaming | Factual |
|---|---|
| "You're not committed to this project" | "I've noticed your updates have been brief in our last three meetings. Is something affecting your workload?" |
| "You don't care about code quality" | "This PR had 12 bugs caught in QA. Let's talk about what happened and how we can improve" |
| "You're always late" | "The standup started at 9:00 and you joined at 9:15 the last three days. What's going on?" |
Key principles:
After stating your observation, shift to collaboration:
| Situation | Dialogue Prompt |
|---|---|
| Understanding barriers | "What's been challenging about this?" |
| Seeking their view | "How do you see the situation?" |
| Finding solutions | "What would help you succeed here?" |
| Checking alignment | "Does this match your understanding of what happened?" |
Even successful conversations need follow-through to create lasting change.
Hi [Name],
Thanks for the conversation yesterday. I appreciated your openness.
**What we agreed to:**
- [Action item 1] - [Timeline]
- [Action item 2] - [Timeline]
**Check-in:** Let's reconnect [date] to see how things are going.
I'm here if you need any support. Thanks for working through this with me.
Best,
[Your name]
Code Review:
Situation: "During Tuesday's code review for the authentication module..." Behavior: "...you provided detailed comments on potential security vulnerabilities and suggested efficient fixes..." Impact: "...which strengthened our security posture and saved the team hours of debugging later."
Collaboration:
Situation: "In yesterday's architecture discussion..." Behavior: "...you asked clarifying questions and built on others' ideas instead of pushing your own solution..." Impact: "...which helped us reach consensus faster and made everyone feel heard."
Missed Deadlines:
Situation: "When we were finalizing the API deployment last Thursday..." Behavior: "...your testing results came in two hours after our agreed cutoff..." Impact: "...which delayed the release, risked our SLA, and caused the QA team to work overtime."
Meeting Behavior:
Situation: "In our sprint planning yesterday..." Behavior: "...you were on your phone for most of the discussion and didn't contribute when we asked for estimates..." Impact: "...which left the team without your expertise on the backend stories and made others feel their time wasn't valued."
For more examples: See references/feedback-sbi-model.md
Situation: A developer consistently delivers code with bugs.
Approach:
Situation: Two engineers disagree on technical approach and it's affecting the team.
Approach:
Situation: Leadership wants a feature in half the time needed.
Approach:
For detailed scripts: See references/difficult-conversation-scripts.md
When you're on the receiving end:
references/feedback-sbi-model.md - Full SBI framework with more examplesreferences/difficult-conversation-scripts.md - Opening lines and responsesreferences/expectation-alignment.md - Managing stakeholder expectationsまだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.
日本語の概要は準備中です。原文の説明を表示しています。
Create API handoff documentation for frontend developers. Use when backend work is complete and needs to be documented for frontend integration, or user says 'create handoff', 'document API', 'frontend handoff', or 'API documentation'.
日本語の概要は準備中です。原文の説明を表示しています。
Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure, create C4 diagrams, or generate context/container/component/deployment diagrams. Triggers include "architecture diagram", "C4 diagram", "system context", "container diagram", "component diagram", "deployment diagram", "document architecture", "visualize architecture".
日本語の概要は準備中です。原文の説明を表示しています。
Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing. Uses GPT-5.2 by default for state-of-the-art software engineering.
日本語の概要は準備中です。原文の説明を表示しています。
This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.
日本語の概要は準備中です。原文の説明を表示しています。
Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits.
日本語の概要は準備中です。原文の説明を表示しています。