feedback-mastery

softaworks/agent-toolkit · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/softaworks/agent-toolkit --skill feedback-mastery
0 commentsdiscussion
summary

Structured frameworks for navigating difficult conversations and delivering constructive feedback effectively.

  • Two core models: Preparation-Delivery-Follow-up (three-phase conversation structure) and Situation-Behavior-Impact (SBI) feedback technique that focuses on observable facts rather than assumptions
  • Covers preparation strategies including issue analysis, goal definition, and emotional regulation to reduce defensiveness and improve outcomes
  • Delivery phase includes neutral openi
skill.md

Feedback Conversations

Overview

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.

When to Use This Skill

Use this skill when:

  • Preparing to give feedback to a colleague or direct report
  • Addressing performance issues or missed expectations
  • Navigating conflict between team members
  • Having 1:1 conversations about sensitive topics
  • Receiving feedback and wanting to respond constructively
  • Managing expectations with stakeholders

Keywords: feedback, difficult conversation, 1:1, one-on-one, performance, conflict, expectations, behavior, confrontation

Core Frameworks

The Preparation-Delivery-Follow-up Model

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?

The SBI Feedback Model

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.

Preparation Phase

Step 1: Understand the Issue

Ask yourself:

  • What exactly is the problem? (Be specific, not vague)
  • How does it impact the team, project, or company?
  • Have I gathered all relevant facts?
  • Is this a pattern or a one-time event?

Step 2: Define Your Goals

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."

Step 3: Manage Your Emotions

High emotional intensity reduces cognitive processing by 30%. Before the conversation:

  • Am I calm and in control?
  • Have I separated facts from personal frustrations?
  • Have I considered their perspective?
  • Can I present this without accusation?

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"

Delivery Phase

The Three-Step Delivery Formula

  1. Open with neutrality and intent
  2. Present the issue using facts, not blame
  3. Encourage dialogue and solutions

Opening Lines That Work

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?"

Facts, Not Blame

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:

  • Use specific examples, not generalizations ("always," "never")
  • Stick to observable behaviors, not assumptions about motives
  • Focus on impact, not character

Encouraging Dialogue

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?"

Follow-up Phase

Even successful conversations need follow-through to create lasting change.

Follow-up Checklist

  • Document agreed-upon action items - What specifically will change?
  • Set check-in dates - When will you revisit this?
  • Provide ongoing support - How will you help them succeed?
  • Celebrate progress - Recognize improvements when they happen

Sample Follow-up Message

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]

SBI Examples for Software Teams

Positive Feedback

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."

Constructive Feedback

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

Common Difficult Scenarios

Scenario: Performance Issue

Situation: A developer consistently delivers code with bugs.

Approach:

  1. Prepare: Gather specific examples (PRs, bug counts, timelines)
  2. Deliver: "I've noticed [X bugs in last Y PRs]. I want to understand what's happening and how I can support you."
  3. Explore: Ask about workload, clarity of requirements, testing confidence
  4. Collaborate: "What would help you feel more confident about code quality?"
  5. Follow-up: Check in after agreed changes, recognize improvements

Scenario: Conflict Between Team Members

Situation: Two engineers disagree on technical approach and it's affecting the team.

Approach:

  1. Meet separately first: Understand each perspective
  2. Find common ground: What do they both want? (Working product, good code, etc.)
  3. Facilitate together: Focus on facts and trade-offs, not personalities
  4. Establish decision process: How will the team decide when there's disagreement?
  5. Follow-up: Check that the solution is working

Scenario: Unrealistic Expectations

Situation: Leadership wants a feature in half the time needed.

Approach:

  1. Prepare: Data on similar past work, breakdown of required tasks
  2. Deliver: "I want to make sure we're aligned on what's realistic. Here's what I'm seeing..."
  3. Present trade-offs: "We can hit that date if we [reduce scope/add people/accept risk]"
  4. Collaborate: "What's most important here - the date or the full feature set?"
  5. Document: Get agreement in writing to avoid future misalignment

For detailed scripts: See references/difficult-conversation-scripts.md

Receiving Feedback Well

When you're on the receiving end:

During the Conversation

  1. Listen fully - Don't prepare your defense while they're talking
  2. Ask clarifying questions - "Can you give me a specific example?"
  3. Paraphrase to confirm - "So what you're saying is..."
  4. Acknowledge impact - Even if intent was different: "I can see how that affected you"
  5. Don't get defensive - Thank them for raising it

After the Conversation

  1. Reflect honestly - Is there truth in the feedback?
  2. Identify actions - What will you do differently?
  3. Follow up - Let them know what you're changing
  4. Ask for ongoing feedback - Show you're committed to growth

Quick Reference: Difficult Conversation Checklist

Before

  • I understand the specific issue
  • I have concrete examples
  • I've defined my goal for the conversation
  • I'm emotionally regulated
  • I've considered their perspective

During

  • I opened with neutrality and intent
  • I stated facts, not blame
  • I used SBI for specific feedback
  • I asked for their perspective
  • I focused on solutions, not just problems
  • I documented agreed actions

After

  • I sent a follow-up summary
  • I scheduled a check-in
  • I'm providing ongoing support
  • I'm recognizing progress

Companion Resources

  • references/feedback-sbi-model.md - Full SBI framework with more examples
  • references/difficult-conversation-scripts.md - Opening lines and responses
  • references/expectation-alignment.md - Managing stakeholder expectations

Recommended Reading

  • "Crucial Conversations" by Kerry Patterson & Joseph Grenny
  • "Difficult Conversations" by Stone, Patton, Heen
  • "Radical Candor" by Kim Scott
  • Amy Edmondson's research on psychological safety

how to use feedback-mastery

How to use feedback-mastery on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add feedback-mastery
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/softaworks/agent-toolkit --skill feedback-mastery

The skills CLI fetches feedback-mastery from GitHub repository softaworks/agent-toolkit and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/feedback-mastery

Reload or restart Cursor to activate feedback-mastery. Access the skill through slash commands (e.g., /feedback-mastery) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

User Story & Requirements Generation

Create detailed user stories, acceptance criteria, and feature specs

Example

Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios

Reduce spec writing time by 50%, ensure comprehensive coverage

Competitive Analysis

Research competitors, compare features, identify gaps

Example

Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities

Complete competitive research in 2 hours instead of 2 days

Roadmap Prioritization

Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs

Example

Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale

Make data-driven prioritization decisions faster

Stakeholder Communication

Draft PRDs, status updates, and stakeholder presentations

Example

Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement

Save 3-5 hours/week on communication overhead

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client
  • Access to product documentation and roadmap tools (Jira, Notion, etc.)
  • Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
  • Stakeholder contact information and communication channels

Time Estimate

30-60 minutes to see productivity improvements

Installation Steps

  1. 1.Install product management skill
  2. 2.Start with user story generation for known feature
  3. 3.Progress to competitive analysis: research 2-3 competitors
  4. 4.Use for roadmap prioritization: apply RICE/ICE scoring
  5. 5.Draft stakeholder communications and refine based on feedback
  6. 6.Build template library for recurring PM tasks
  7. 7.Share effective prompts with product team

Common Pitfalls

  • Not validating competitive research—verify facts before sharing
  • Accepting user stories without involving engineering team
  • Over-relying on frameworks without qualitative judgment
  • Not customizing outputs to company culture and communication style
  • Skipping stakeholder validation of generated requirements

Best Practices

✓ Do

  • +Validate research and competitive analysis with real data
  • +Collaborate with engineering when generating technical requirements
  • +Customize frameworks and templates to your company context
  • +Use skill for first drafts, refine with stakeholder input
  • +Document successful prompt patterns for PM tasks
  • +Combine AI efficiency with human judgment and intuition

✗ Don't

  • Don't publish competitive analysis without fact-checking
  • Don't finalize user stories without engineering review
  • Don't make prioritization decisions solely on AI scoring
  • Don't skip customer validation of generated requirements
  • Don't ignore company-specific context and culture

💡 Pro Tips

  • Provide context: company goals, constraints, customer feedback
  • Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
  • Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
  • Use skill for 70% generation + 30% customization to company needs

When to Use This

✓ Use When

Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.

✗ Avoid When

Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.

Learning Path

  1. 1Basic: user stories, feature specs, status updates
  2. 2Intermediate: competitive analysis, prioritization frameworks, PRDs
  3. 3Advanced: product strategy, go-to-market planning, OKR setting
  4. 4Expert: product vision, market positioning, business model innovation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.645 reviews
  • Jin Jackson· Dec 20, 2024

    Solid pick for teams standardizing on skills: feedback-mastery is focused, and the summary matches what you get after install.

  • Ganesh Mohane· Dec 16, 2024

    Registry listing for feedback-mastery matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Charlotte Choi· Dec 8, 2024

    feedback-mastery has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Aditi Martinez· Nov 27, 2024

    Solid pick for teams standardizing on skills: feedback-mastery is focused, and the summary matches what you get after install.

  • Omar Martinez· Nov 11, 2024

    feedback-mastery has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Sakshi Patil· Nov 7, 2024

    feedback-mastery reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Chaitanya Patil· Oct 26, 2024

    I recommend feedback-mastery for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Omar Martin· Oct 18, 2024

    We added feedback-mastery from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Omar Smith· Oct 2, 2024

    Keeps context tight: feedback-mastery is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Alexander Anderson· Sep 25, 2024

    feedback-mastery reduced setup friction for our internal harness; good balance of opinion and flexibility.

showing 1-10 of 45

1 / 5