ambiguity-resolver
$
npx mdskill add mohitagw15856/pm-claude-skills/ambiguity-resolverTurn vague briefs and half-formed opportunities into structured, actionable problem statements — so you can reply with clarity instead of asking for three more meetings.
SKILL.md
.github/skills/ambiguity-resolverView on GitHub ↗
--- name: ambiguity-resolver description: "Structure vague opportunities and unclear briefs into actionable one-page problem statements. Use when asked to clarify a vague brief, frame an undefined problem, make sense of an unclear opportunity, or when the user says 'we need to figure out what to do about X' or 'I've been asked to look into Y'. Produces a structured problem brief with reframed questions, scoped boundaries, and a minimum viable research plan." --- # Ambiguity Resolver Skill Turn vague briefs and half-formed opportunities into structured, actionable problem statements — so you can reply with clarity instead of asking for three more meetings. ## Required Inputs Ask the user for these if not provided: - **The vague brief or opportunity description** (even a single sentence is enough) - **Who asked for this** (stakeholder context shapes the framing) - **Known constraints** (timeline, budget, team size — if any are known) ## Three-Stage Process ### Stage 1: Reframe - Restate the vague input as 3-5 explicit questions that need answering - Identify the unstated assumptions hidden in the brief - Surface the real decision this feeds into (what will someone do differently once this is resolved?) ### Stage 2: Scope - Define what is explicitly IN scope - Define what is explicitly OUT of scope (equally important) - Identify the deadline pressure: is this urgent/important, important/not urgent, or unclear? - Name who owns the final decision and who needs to be consulted ### Stage 3: Action - Define the minimum viable research: 2-3 activities maximum that would give enough signal to move forward with confidence - Time estimate for each activity - What each activity would tell you (and what it wouldn't) - Proposed check-in point: when to regroup before committing to more **Validate** — Confirm every reframed question maps to at least one research activity. Verify scope boundaries are specific enough to say "no" to something concrete. ## Output Structure ### Problem Brief: [Opportunity Area] **Restated as questions:** 1. [Question 1] 2. [Question 2] 3. [Question 3] **Unstated assumptions we should surface:** - [Assumption 1] - [Assumption 2] **In scope:** [Clear boundary] **Out of scope:** [Clear boundary] **Decision owner:** [Name/role] **Timeline:** [Real deadline if known, or "unclear — recommend setting one"] **Minimum viable research:** | Activity | Time required | What it tells us | What it won't tell us | |----------|--------------|------------------|-----------------------| | [activity] | [time] | [insight] | [limitation] | **Proposed check-in:** After [activity], regroup to decide whether to proceed or pivot. ## Example (Partial) Input: *"We need to figure out what to do about our enterprise customers."* **Restated as questions:** 1. Are enterprise customers churning, underperforming on expansion, or both? 2. Is this a product gap, a support/service gap, or a pricing/packaging issue? 3. What does "do something" look like — a new initiative, a policy change, or a resource shift? **In scope:** Enterprise accounts ($50K+ ARR) showing declining health scores in the last two quarters **Out of scope:** SMB segment, new enterprise acquisition strategy ## Quality Checks - [ ] Every reframed question is specific enough to research (not "how do we improve things?") - [ ] Scope boundaries name something concrete that is excluded - [ ] Research activities are achievable within the stated timeline - [ ] Decision owner is identified (not "leadership" — a specific person or role)
More from mohitagw15856/pm-claude-skills
- 360-feedback-templateDesign a 360-degree feedback survey or write a structured 360 feedback report. Use when asked to build a 360 feedback process, write 360 feedback for a colleague, design a feedback survey, or produce a feedback report. Produces either a complete survey instrument with rating scales and open-ended questions, or a structured narrative feedback report with themes, strengths, and development areas.
- ab-test-plannerDesign statistically rigorous A/B tests for product features, UI changes, onboarding flows, and pricing experiments. Use when asked to set up an experiment, design an A/B test, calculate sample size, or interpret test results. Produces a complete test plan with hypothesis, variant definitions, sample size, duration estimate, guardrail metrics, and a results interpretation guide.
- accessibility-auditGenerate a WCAG 2.2 accessibility audit checklist and remediation suggestions for any UI or design. Use when asked to audit for accessibility, check WCAG compliance, review a design for a11y issues, or create an accessibility remediation plan. Produces a prioritised checklist with pass/fail assessments and specific fixes.
- account-planBuild a structured account plan for any key customer or target account. Use when asked to create an account plan, key account strategy, strategic account review, or territory plan. Produces a complete account plan with relationship map, growth opportunities, risks, and 90-day action plan.
- aeo-optimizerOptimize an article for Answer Engine Optimization (AEO) — restructuring content so AI engines like ChatGPT, Perplexity, and Claude can extract, quote, and cite it. Rewrites headings as questions, drops 50-80 word answer capsules, audits paragraph length, and flags trust signals. Use when asked to AEO-optimize, make content AI-readable, improve AI citation chances, or adapt an article for answer engines.
- ai-ethics-reviewConduct an ethical review of an AI or ML feature, model, or product. Use when asked to run an AI ethics review, assess AI risks, audit a model for bias, or produce an AI impact assessment. Produces a structured ethics review covering fairness, transparency, privacy, safety, accountability, and societal impact with prioritised mitigations.
- ai-product-canvasStructure AI and ML product decisions with the rigour of any product decision. Use when building AI-powered features, evaluating LLM integrations, designing AI products, or assessing AI readiness. Produces a complete AI product canvas covering problem definition, model approach, data requirements, evaluation framework, UX design, responsible AI checklist, and launch monitoring plan.
- api-docs-writerWrite clear, developer-facing API documentation. Use when asked to document an API endpoint, write API reference docs, create a developer guide, or turn a raw spec/Postman collection into documentation. Produces endpoint documentation with descriptions, parameters, request/response examples, and error codes.
- api-versioning-strategyWrite an API versioning strategy document for a service or API platform. Use when asked to define versioning policy, plan API deprecation, classify breaking changes, or document version lifecycle. Produces a complete versioning strategy with breaking-change classification table, deprecation timeline, migration guide template, and client communication template.
- architecture-decision-recordCreate an Architecture Decision Record (ADR) for any technical decision. Use when asked to document a technical decision, write an ADR, record an architecture choice, or capture why a technology or approach was selected. Produces a structured ADR with context, decision, consequences, and tradeoffs.