Discovery Workshop
by johnkmcleod9
Guide synthesis of Action Mapping workshop outputs into structured discovery documents. Use when processing workshop notes, creating needs analysis, building learner personas, summarizing discovery sessions, or preparing design briefs from stakeholder meetings.
Skill Details
Repository Files
8 files in this skill directory
name: discovery-workshop description: Guide synthesis of Action Mapping workshop outputs into structured discovery documents. Use when processing workshop notes, creating needs analysis, building learner personas, summarizing discovery sessions, or preparing design briefs from stakeholder meetings. allowed-tools: Read, Write, Edit, Grep, Glob, AskUserQuestion model: claude-opus-4-5-20251101 user-invocable: true
Discovery Workshop Synthesis
Transform your Action Mapping workshop outputs into all four key discovery documents through a guided interview process.
What This Skill Does
After you've facilitated a discovery workshop with stakeholders and SMEs, this skill helps you:
- Synthesize raw workshop notes into structured insights
- Generate four key deliverables:
- Meeting Summary
- Formal Needs Analysis
- Action Map Summary
- Design Brief
- Create Learner Persona(s)
- Ensure all documents align with your adapted Action Mapping methodology
Your Adapted Action Mapping Process
This skill follows your team's adapted methodology:
1. Content Audit → Review existing training/content BEFORE stakeholder sessions
2. Business Goal → Define measurable business outcome with stakeholders
3. Behaviors + Obstacles → Map both what people should do AND why they're not doing it
4. Practice Activities → Design realistic scenarios for behavior change
5. Knowledge Pull → Identify what info learners need during activities
For detailed methodology reference, see adapted-action-mapping.md
How to Use This Skill
Option 1: Full Guided Process
Say: "Help me process my discovery workshop outputs" or invoke /discovery-workshop
I will interview you through each phase:
- Content audit findings
- Business goal identification
- Behaviors and obstacles mapping
- Target audience insights
- Document generation
Option 2: Specific Document
If you only need one output:
- "Create a needs analysis from my workshop notes"
- "Generate a design brief for this project"
- "Build a learner persona for [audience]"
- "Summarize my workshop into a meeting summary"
Option 3: Process Raw Notes
Paste your workshop notes and say: "Synthesize these into discovery documents"
Interview Process
I'll guide you through these questions:
Phase 1: Content Audit
- What existing training or content did you review before the workshop?
- What were the key findings? (What's good? What's outdated? What's missing?)
- Is any existing content reusable?
Phase 2: Business Goal
- What business problem are we trying to solve?
- How is this problem currently measured?
- What does success look like? What metrics will change?
- Who requested this training and why now?
Phase 3: Behaviors + Obstacles
- What specific actions should people be doing on the job?
- Which behaviors have the highest impact on the business goal?
- Why aren't people performing these behaviors now?
- Knowledge gaps?
- Skill gaps?
- Environmental barriers?
- Motivation issues?
Phase 4: Target Audience
- Who exactly needs this training?
- What do they already know?
- What's their attitude toward this training?
- What constraints do they have (time, technology, environment)?
Phase 5: Constraints & Context
- What's the timeline?
- What technology/platform will be used?
- Are there compliance or accessibility requirements?
- Who are the key stakeholders?
Output Documents
1. Meeting Summary
Quick reference document capturing:
- Key decisions made
- Action items with owners
- Open questions
- Notable quotes and insights
Template: meeting-summary-template.md
2. Formal Needs Analysis
Comprehensive discovery document including:
- Business goal and success metrics
- Current vs. desired state gap analysis
- Target audience profile
- Key behaviors and obstacles
- Content requirements
- Constraints and considerations
- Recommended solution
Template: needs-analysis-template.md
3. Action Map Summary
Text representation of your action map:
- Business goal at center
- Priority behaviors listed
- Obstacles mapped to each behavior
- Practice activity ideas
Template: action-map-template.md
4. Design Brief
Concise document for handoff to design phase:
- One-sentence project summary
- Business goal
- Target audience summary
- Key behaviors to address
- Proposed solution overview
- Success metrics
- Constraints
Template: design-brief-template.md
5. Learner Persona(s)
Detailed fictional profiles:
- Demographics and background
- Goals and motivations
- Challenges and pain points
- Learning preferences
- Technology profile
- Design implications
Template: learner-persona-template.md
Tips for Better Discovery
Before the Workshop
- Review existing content/training first
- Prepare a clear agenda
- Identify who needs to be in the room
During the Workshop
- Focus on behaviors, not content
- Capture specific examples and quotes
- Challenge assumptions ("How do you know that?")
- Note disagreements—they reveal important tensions
After the Workshop
- Process notes within 24-48 hours while fresh
- Send meeting summary for validation
- Flag open questions that need follow-up
Examples
See examples/sample-discovery-outputs.md for sample outputs from a completed discovery process.
Related Commands
/objectives- Generate learning objectives from behaviors/synthesize-notes- Quick note synthesis without full workflow/learner-persona- Generate a single persona quickly/bloom-verbs- Reference for objective writing
Getting Started
Ready to process your workshop? Tell me:
- What project is this for? (client/project name)
- Do you have raw notes to share? (paste them or reference a file)
- Which outputs do you need? (all four, or specific documents)
Or just paste your workshop notes and I'll guide you through the process.
Related Skills
Team Composition Analysis
This skill should be used when the user asks to "plan team structure", "determine hiring needs", "design org chart", "calculate compensation", "plan equity allocation", or requests organizational design and headcount planning for a startup.
Kpi Dashboard Design
Design effective KPI dashboards with metrics selection, visualization best practices, and real-time monitoring patterns. Use when building business dashboards, selecting metrics, or designing data visualization layouts.
Dbt Transformation Patterns
Master dbt (data build tool) for analytics engineering with model organization, testing, documentation, and incremental strategies. Use when building data transformations, creating data models, or implementing analytics engineering best practices.
Sql Optimization Patterns
Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries. Use when debugging slow queries, designing database schemas, or optimizing application performance.
Clinical Decision Support
Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug develo
Senior Data Scientist
World-class data science skill for statistical modeling, experimentation, causal inference, and advanced analytics. Expertise in Python (NumPy, Pandas, Scikit-learn), R, SQL, statistical methods, A/B testing, time series, and business intelligence. Includes experiment design, feature engineering, model evaluation, and stakeholder communication. Use when designing experiments, building predictive models, performing causal analysis, or driving data-driven decisions.
Scientific Schematics
Create publication-quality scientific diagrams using Nano Banana Pro AI with smart iterative refinement. Uses Gemini 3 Pro for quality review. Only regenerates if quality is below threshold for your document type. Specialized in neural network architectures, system diagrams, flowcharts, biological pathways, and complex scientific visualizations.
Mermaid Diagrams
Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams (domain modeling, object-oriented design), sequence diagrams (application flows, API interactions, code execution), flowcharts (processes, algorithms, user journeys), entity relationship diagrams (database schemas), C4 architecture diagrams (system context, containers, components), state diagrams, git graphs, pie charts,
Ux Researcher Designer
UX research and design toolkit for Senior UX Designer/Researcher including data-driven persona generation, journey mapping, usability testing frameworks, and research synthesis. Use for user research, persona creation, journey mapping, and design validation.
Supabase Postgres Best Practices
Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.
