workshop-facilitation
deanpeters/product-manager-skills
Canonical facilitation pattern for structured, interactive workshops with progress tracking and adaptive recommendations.
What is workshop-facilitation?
This skill defines the standard protocol for running interactive workshop sessions one step at a time, with clear progress visibility and decision-point recommendations. Use it as the foundation for any guided, multi-turn workshop or interactive skill that needs consistent pacing and predictable interruption handling.
- Runs sessions one targeted question per turn with plain-language prompts
- Offers three entry modes: Guided (step-by-step), Context Dump (paste known info), or Best Guess (infer missing details)
- Displays progress labels (e.g., 'Context Q2/8') so users know how much remains
- Provides numbered quick-select options for regular questions and enumerated recommendations only at decision points
- Accepts flexible multi-select responses (e.g., '1,3' or '1 and 3') and synthesizes choices
- Handles interruptions safely: answers meta questions directly, restates status, then resumes
How to install workshop-facilitation
npx skills add https://github.com/deanpeters/product-manager-skills --skill workshop-facilitationHow to use workshop-facilitation
- 1.Invoke the skill with optional session context (e.g., 'Facilitate a 45-minute retro on our failed beta launch')
- 2.Choose your entry mode: 1 (Guided), 2 (Context Dump), or 3 (Best Guess)
- 3.Answer one question per turn; the facilitator will show progress and move to the next question
- 4.At decision points, select from numbered recommendations or provide custom choices
- 5.If interrupted, ask meta questions directly—the facilitator will restate status and resume
- 6.Review the final summary, decisions made, and any assumptions to validate
Use cases
- Run a structured positioning workshop with your product team using consistent facilitation
- Facilitate a discovery sprint kickoff with clear questions, options, and progress tracking
- Conduct a retrospective on a failed launch with one-step-at-a-time pacing and actionable outcomes
- Guide a team through maturity assessment or priority-setting with adaptive recommendations
- Embed this protocol in other interactive skills to ensure uniform session flow and user experience
- Product managers running workshops or guided sessions
- Facilitators designing interactive skills or advisor-style tools
- Teams conducting structured discovery, retros, or decision-making sessions
- Developers building multi-turn interactive experiences that need consistent pacing
workshop-facilitation FAQ
Guided mode asks questions one at a time with no assumptions. Context Dump lets you paste known information upfront to skip redundant questions. Best Guess mode infers missing details and labels assumptions for later validation.
Yes. Text after the skill name, pasted context, or an ARGUMENTS: line counts as answers already given. The facilitator will skip those questions and adjust progress labels accordingly.
Numbered recommendations appear only at decision points (after context synthesis, maturity assessment, or when choosing priorities), not after every answer. Users can select by number, multi-select (e.g., '1,3'), or provide custom text.
The facilitator answers directly (e.g., 'Three questions left'), restates your current progress, and resumes from the pending question.
Both. It defines the canonical facilitation pattern for interactive skills, so other workshop skills reference and apply it. You can also invoke it standalone to facilitate any session by naming the topic and context.
Full instructions (SKILL.md)
Source of truth, from deanpeters/product-manager-skills.
name: workshop-facilitation description: Facilitate workshop sessions in a one-step, multi-turn flow. Use when an interactive skill needs consistent pacing, options, and progress tracking. intent: >- Provide the canonical facilitation pattern for interactive skills: one step at a time, with clear progress, adaptive recommendations at decision points, and predictable interruption handling. type: interactive theme: workshops-facilitation best_for:
- "Adding structured facilitation to any PM workshop or guided session"
- "Running interactive sessions with numbered recommendations and progress tracking"
- "Ensuring your workshops stay on track and end with actionable choices" scenarios:
- "I want to run a structured positioning workshop with my product team — set up the facilitation protocol"
- "Help me facilitate a discovery sprint kickoff with clear questions, options, and progress labels" estimated_time: "varies by workshop"
Purpose
Provide the canonical facilitation pattern for interactive skills: one step at a time, with clear progress, adaptive recommendations at decision points, and predictable interruption handling.
Input
Nothing required — this skill defines the facilitation protocol other interactive skills follow. Also useful: If invoked standalone, name the session you want facilitated and any context for it; that context carries into the session as answers already given.
Anything supplied with the invocation itself — text after the skill name, a pasted context dump, or an appended ARGUMENTS: line — counts as answers already given. Use it and skip whatever it covers; don't re-ask.
Arriving empty-handed? That works too. When another skill references this protocol, that skill's Input section governs what to provide.
Example invocation: Facilitate a 45-minute retro on our failed beta launch using this protocol.
Key Concepts
- One-step-at-a-time: Ask a single targeted question per turn.
- Session heads-up + entry mode: Start by setting expectations and offering
Guided,Context dump, orBest guessmode. - Progress visibility: Show user-facing progress labels like
Context Qx/8andScoring Qx/5. - Decision-point recommendations: Use enumerated options only when a choice is needed, not after every answer.
- Quick-select response options: For regular context/scoring questions, provide concise numbered answer options plus
Other (specify)when useful. - Flexible selection parsing: Accept
#1,1,1 and 3,1,3, or custom text, then synthesize multi-select choices. - Context-aware progression: Build on previous answers and avoid re-asking resolved questions.
- Interruption-safe flow: Answer meta questions directly (for example, "how many left?"), restate status, then resume.
- Fast path: If the user requests a single-shot output, skip multi-turn facilitation and deliver a condensed result.
Application
- Start with a brief heads-up on estimated time and number of questions.
- Ask the user to choose an entry mode:
1Guided mode (one question at a time)2Context dump (paste known context; skip redundancies)3Best guess mode (infer missing details and label assumptions)
- Run one question per turn and wait for an answer before continuing.
- Keep questions plain-language; include a short example response format when helpful.
- Show progress each turn:
Context Qx/8during context collectionScoring Qx/5during assessment/scoring
- Ask follow-up clarifications only when they materially improve recommendation quality.
- For regular context/scoring questions, offer quick-select numbered response options when practical:
- Keep options concise and mutually exclusive when possible.
- Include
Other (specify)if likely answers are open-ended. - Accept multi-select responses like
1,3or1 and 3.
- Provide numbered recommendations only at decision points:
- after context synthesis,
- after maturity/profile synthesis,
- during priority/action-plan selection.
- Accept numeric or custom choices, synthesize multi-select choices, and continue.
- If interrupted by a meta question, answer directly, then restate progress and pending question.
- If the user says stop/pause, halt immediately and wait for explicit resume.
- End with a clear summary, decisions made, and (if best guess mode was used) an
Assumptions to Validatelist.
Examples
Opening: "Quick heads-up: this should take about 7-10 minutes and around 10 questions. How do you want to start?
- Guided mode
- Context dump
- Best guess mode"
User: "2"
Facilitator: "Paste what you already know. I’ll skip answered areas and ask only what’s missing."
Decision point after synthesis:
- Prioritize Context Design (Recommended)
- Prioritize Agent Orchestration
- Prioritize Team-AI Facilitation
User: "1 and 3"
Facilitator: "Great. We’ll run Context Design first, with Team-AI Facilitation in parallel."
Inline input at invocation: when the user supplies context with the invocation itself, credit it as answers, open at the first unanswered question, and keep progress labels honest (start at Context Q2/6 if Q1 was covered). Full transcript, including the re-asking anti-pattern: examples/inline-input-flow.md.
Common Pitfalls
- Asking multiple questions in the same turn.
- Offering recommendations after every answer (creates interaction drag).
- Using shorthand labels without plain-language questions.
- Hiding progress, so users don't know how much remains.
- Ignoring the user's chosen option or custom direction.
- Failing to label assumptions when running in best-guess mode.
References
- Use as the source of truth for interactive facilitation behavior.
- Apply alongside workshop skills in
skills/*-workshop/SKILL.mdand advisor-style interactive skills.
Related skills
More from deanpeters/product-manager-skills and the wider catalog.

acquisition-channel-advisor
Evaluate acquisition channels by unit economics, customer quality, and scalability to make scale/test/kill decisions.

ai-shaped-readiness-advisor
Assess whether your product work is AI-first (faster tasks) or AI-shaped (fundamentally redesigned operations).

altitude-horizon-framework
Mental model for PM-to-Director transition: understand altitude (scope) and horizon (time) shifts.

business-health-diagnostic
Diagnose SaaS business health across growth, retention, unit economics, and capital efficiency.

tanstack-integration-best-practices
Best practices for coordinating TanStack Query, Router, and Start in full-stack applications.

tanstack-query-best-practices
TanStack Query best practices for optimized data fetching, caching, and server state management in React.