New to Claude Skills? Learn how to install them →

deanpeters on GitHub

Incoming Request Advisor

Free

Decode messages for clearer responses.

Get this skill

Free · Opens the source repo

What Incoming Request Advisor does

The Incoming Request Advisor is designed to help product leaders and teams effectively analyze incoming messages, such as Slack pings, emails, or mandates, before crafting a response. By breaking down the incoming communication into its core components, this skill distinguishes between the literal ask and the underlying job-to-be-done. This structured approach aids in understanding the true intent behind a message, ensuring that responses are relevant and aligned with the sender's objectives.

When a request arrives, it can be tempting to respond immediately based on the surface-level content. However, this skill encourages users to take a step back and evaluate the broader context. It identifies the outcome the sender is seeking and the reasons behind their request, rather than simply focusing on how to fulfill the ask. This shift in perspective is crucial for avoiding miscommunication and ensuring that the right solutions are developed.

The Incoming Request Advisor operates by extracting the full message from various formats, including text, images, and PDFs. It assesses the sender's role and the context of the message, allowing it to generate a comprehensive breakdown that highlights key elements such as success criteria and must-haves. This breakdown not only clarifies the sender's expectations but also provides a clear path for the next steps in the conversation.

This skill is particularly useful for product managers, team leads, and anyone who regularly engages with stakeholders and needs to navigate complex requests. By utilizing this tool, users can enhance their communication effectiveness and ensure that they address the right issues in their responses.

When to use it

Use this skill when you receive a complex request that requires deeper analysis before responding.

When not to use it

Avoid using it for straightforward requests that don't require additional context or analysis.

What you can build with it

Analyzing a Feature Request

When a team member asks for a new feature, use the skill to uncover the true needs behind the request.

Preparing for a Stakeholder Meeting

Before responding to a stakeholder's email, break down their message to ensure you address their real concerns.

Clarifying Ambiguous Mandates

When faced with unclear directives, use the skill to dissect the message and clarify expectations before taking action.

How to install Incoming Request Advisor

View source

1. Install with the skills CLI

npx skills add deanpeters/product-manager-skills/incoming-request-advisor --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by deanpeters

Purpose

Decode an incoming message — a Slack ping, email, mandate, escalation, or FYI — into a structured breakdown before you respond. This skill acts as a chief-of-staff-grade analyst sitting in a product leader's chair: it separates the literal ask from the job-to-be-done underneath it, reads sender power and stake, and opens the conversation toward a reply or next artifact.

Use it when a request lands and your first instinct is to answer the words on the screen. The skill slows that reflex down: it finds the outcome, for whom, and why now — not how to build. It is not a programmer breaking down a spec. When a request sounds like a feature or a build order, the skill hunts for the outcome and the job-to-be-done beneath it.

Input

Works best with: The incoming message itself — pasted text, a screenshot, an image, an attached file, or a PDF. The skill extracts the full message from whatever form it takes before analyzing.

Also useful:

  • Who sent it and their apparent role relative to your work (upstream, peer, downstream)
  • The situation or thread the message arrived in
  • What you want next — analysis only, or a drafted reply too

Anything supplied with the invocation itself — text after the skill name, the pasted message, surrounding notes, or an appended ARGUMENTS: line — counts as answers already given. Treat anything written around the message as sender or situation context. Use it and skip whatever it covers; don't re-ask.

Arriving empty-handed? That works too. Drop in the message and nothing else. If sender or situation is unknown and it changes the read, the advisor asks at most 3 targeted questions, one at a time, then proceeds with clearly labeled assumptions. If part of the message is unreadable or cut off, the advisor says so and works with what is there.

Example invocation: My VP DM'd me: "Any chance the dashboard redesign lands next sprint? Board's asking." Analyze this before I reply.

Key Concepts

The Ask vs. the Job-to-Be-Done

The literal ask is what the words request. The job-to-be-done is the outcome the sender is actually chasing. "Can we get the dashboard redesign into next sprint?" is the ask; "I need something concrete to show the board that we're responsive" may be the job. Responding to the ask when the job is different is how PMs build the wrong thing fast. Every breakdown separates these two explicitly.

The Sender Read: Power, Stake, Subtext

Before you respond, you read the room. Who sent it, what is their role relative to your work, and are they upstream (they set your priorities), a peer (they need your cooperation), or downstream (they depend on your output)? Power and stake change the correct response even when the words are identical. A "quick question" from your CEO is not a quick question.

Success Criteria vs. Must-Haves (the distinction PMs blur)

These are not the same thing, and conflating them is a classic PM error:

  • Success criteria = how the sender will judge whether the result worked (the pass/fail bar, the metric, the definition of done)
  • Must-haves = what has to go into the deliverable (the hard requirements)

A deliverable can hit every must-have and still fail the success criteria. Keeping them separate is a core teaching of this skill.

Infer, Do Not Invent

The skill reasons from evidence in the message and marks every guess as an inference. It never presents a guess as a stated fact. Everything inferred lands in an explicit Assumptions to Validate list at the end — so the human knows exactly what the analysis rests on.

Scale Depth to the Message

The breakdown has twelve sections, but a one-line ping does not need all twelve. The skill collapses or skips empty sections and marks them "none stated" where the template calls for it. Over-filling a trivial message with twelve dense sections is a failure mode, not thoroughness.

The Sticky-Note Rule

Every bullet in the breakdown is 4 to 8 words, ASCII only, short and scannable — as if written on a sticky note. Direct quotes from the message are verbatim and exempt from the length rule.

Facilitation Source of Truth

Use workshop-facilitation as the default interaction protocol for this skill.

It defines:

  • session heads-up + entry mode (Guided, Context dump, Best guess)
  • one-question turns with plain-language prompts
  • crediting inline invocation context so answered questions are skipped
  • interruption handling and pause/resume behavior

For this skill specifically: the pasted message is the context dump. Ask clarifying questions only when sender or situation is genuinely unknown and it changes the read — at most 3, one at a time.

Application

Step 1 — Extract the message

Pull the full message from whatever form it arrives in (screenshot, image, file, PDF, or text) before analyzing. If any part is unreadable or cut off, say so and work with what you have.

Step 2 — Fill only the gaps that change the read

If sender identity or situation is unknown and it would change the analysis, ask at most 3 targeted questions, one at a time:

  1. "Who sent this and what is their role relative to your work?"
  2. "What is the situation or thread this arrived in?"
  3. "Do you want analysis only, or a drafted reply too?"

Then proceed with clearly labeled assumptions. Do not ask questions the message already answers.

Step 3 — Render the breakdown

Render in Markdown using the structure below. Scale depth to the message: collapse or skip any empty section; mark it "none stated" where the template calls for it. Apply the Sticky-Note Rule (4–8 word bullets, ASCII only; verbatim quotes exempt). Use template.md for the copy/paste fill-in structure a PM can work through by hand.

## Incoming Request Breakdown

### 1. Classify
- Message type and channel, one line
- Types: meeting prep, feedback, feature request, mandate, escalation, FYI, ask for help, other

### 2. Sender Read
- Who sent it, apparent role
- Relationship: upstream, peer, or downstream
- Power and stake where they matter

### 3. Literal Ask
- What they explicitly want, plain terms

### 4. Underlying Problem Space
- The job they are trying to get done
- The outcome behind the request
- Separate the ask from the need

### 5. Sentiment and Subtext
- Tone, urgency, frustration, enthusiasm, politics
- Quote the tell if there is one

### 6. Must-Haves vs Nice-to-Haves
- Hard requirements for the deliverable
- Soft preferences, clearly separated

### 7. Hard Negatives
- What they explicitly do not want
- "None stated" if none

### 8. Success Criteria
- Pass/fail bar, metric, or definition of done
- How they will judge the result worked
- Capture only what is stated; mark implied ones as inference
- "None stated" if none

### 9. Hard Constraints
- Drop-dead dates, budget, non-negotiables
- "None stated" if none

### 10. Gaps and Ambiguities
- What is unclear or missing before committing

### 11. Risks
- Scope, expectation, political, timeline landmines

### 12. Recommended Next Steps
- 2 to 4 concrete moves, ordered

### Assumptions to Validate
- [Anything inferred rather than stated]
- [Sender read or intent guessed]
- [Success criteria or constraints implied]

Step 4 — Open the conversation live

After rendering, ask the 1 to 3 sharpest questions you need to sharpen the recommendation, then offer exactly 4 next options:

  1. Draft a reply to the sender (Recommended)
  2. Build a meeting agenda for this ask
  3. Reframe the ask as a discovery framing
  4. Draft a counter-proposal that protects the outcome

Ask the user to reply with 1, 2, 3, 4, a combination like 1 and 3, or a custom path.

Examples

See examples/conversation-flow.md for a full end-to-end interaction, including message extraction, gap-filling, the rendered breakdown, and the closing options.

Example: The "quick" exec ping (full breakdown)

Message pasted: "Any chance the dashboard redesign lands next sprint? Board's asking." — from the VP of Product.

Agent output (abridged):

  • Classify: Feature request, Slack DM
  • Sender Read: VP of Product; upstream; high power, high stake
  • Literal Ask: Ship dashboard redesign next sprint
  • Underlying Problem Space: Needs board-ready proof of responsiveness (inference)
  • Success Criteria: Something showable at board meeting — not the full redesign (inference)
  • Risks: Committing to scope to satisfy a timeline; "next sprint" anchors expectations
  • Recommended Next Steps: Confirm what the board actually needs; offer a demoable slice

Then: "Is the board meeting date fixed? Do they need working software or a credible plan?" → offers the 4 options, recommends 4 — counter-proposal that protects the outcome (a demoable slice beats an over-committed full redesign).

Example: One-line FYI (depth collapses)

Message pasted: "Heads up — legal signed off on the new terms." — from a peer PM.

Agent output: Classify (FYI, Slack) + Sender Read + Literal Ask only. Sections 4–11 marked "none stated." Recommended Next Step: acknowledge, file for the launch checklist. No twelve-section wall for a one-liner.

Common Pitfalls

Pitfall 1: Breaking It Down Like a Spec

Symptom: Treating a feature-shaped request as a build order and jumping to implementation tasks.

Consequence: You optimize the wrong thing efficiently. You solve the ask and miss the job, then wonder why the sender is still unhappy after you delivered exactly what they said.

Fix: Always run Section 4 (Underlying Problem Space). Name the outcome and the job-to-be-done before touching "how."

Pitfall 2: Blurring Success Criteria and Must-Haves

Symptom: Listing "the dashboard must have export" under the same heading as "they'll judge this by whether the board is reassured."

Consequence: You build a deliverable that ticks every requirement and still fails the real bar. The two answer different questions — what goes in vs. how they judge it.

Fix: Keep Sections 6 and 8 strictly separate. Ask yourself: is this a thing in the box, or the ruler they measure the box with?

Pitfall 3: Inventing Instead of Inferring

Symptom: Presenting a guess about the sender's motive as if the message stated it.

Consequence: The human acts on fabricated certainty, walks into the room wrong, and loses trust when the assumption cracks.

Fix: Mark every guess as an inference and surface it in Assumptions to Validate. If you didn't read it in the message, it's an assumption — label it.

Pitfall 4: Over-Filling a One-Liner

Symptom: Rendering all twelve sections for a two-sentence FYI.

Consequence: Analysis theater. The reader can't find the signal, and the breakdown looks rigorous while adding nothing.

Fix: Scale depth to the message. Collapse empty sections; mark "none stated." A one-line ping earns a one-paragraph read.

References

Related Skills

Source Material

  • Original prompt "Incoming Request Breakdown" by Dean Peters (July 8, 2026)

License

  • CC BY-NC-SA 4.0 (repository license)

Frequently asked questions about Incoming Request Advisor

Similar skills