Installation
Via Clawdhub:
clawdhub install research-planner
Manual Installation:
CODEBLOCK1
Research Planner
Market and user research planning skill focused on research design and documentation, not on data analysis.
This skill is inspired by systematic frameworks from:
- Erika Hall,
Just Enough Research (research strategy, scoping, stakeholder alignment)
- Steve Portigal,
Interviewing Users (study design and interview materials)
- C. J. Hoefflich & Jeff Sauro,
Quantifying the User Experience (quantitative UX measures and study design – used here for planning, not analysis)
- - Market research and consulting
- Naresh Malhotra,
Marketing Research (problem definition → research design → data collection plan)
- McKinsey-style
hypothesis-driven, MECE research framing (issue trees, key questions, assumptions)
- Nielsen Norman Group research-planning guidance (
research plans,
research methods overview)
- Practice-oriented UX research strategy guides such as
The Ultimate Guide to Research Strategy
This skill helps the agent:
- - Select appropriate research methods given the user's goal, constraints, and audience
- Turn a chosen method into concrete research artifacts (screeners, questionnaires, discussion guides, task lists, etc.)
- Structure research projects into clear phases and deliverables
Data analysis (qualitative coding, statistical analysis, report writing) is explicitly out of scope and should be delegated to analysis-focused skills (for example, interview-analysis skills such as Interview Analyst).
Scope
- Clarifying research objectives and hypotheses
- Choosing suitable research methods (e.g., in-depth interviews, usability tests, surveys, diary studies, field research, concept tests)
- Designing multi-method research plans (mixed methods)
- Drafting all research materials needed to run the study:
- Recruitment screeners and eligibility criteria
- Participant invitation text and consent wording
- Interview and discussion guides
- Usability test task scripts and success criteria
- Survey questionnaires and question wording
- Moderator notes and observation templates
- Structuring timelines, milestones, and required roles for execution
- Cleaning, transforming, or aggregating collected data
- Coding qualitative data or running statistical tests
- Creating insights decks, final research reports, or recommendations
- Any task that belongs to the separate analysis/reporting skills
Phase Model
Use this phase model for every project. This skill covers only the planning and documentation phases.
CODEBLOCK2
How to Use This Skill
For each user request:
- 1. Clarify the research need
- Choose appropriate research approach(es)
- Turn the approach into a concrete study plan
- Generate the necessary research materials
- Package everything into an execution-ready bundle
Always keep analysis out of scope and gently point users to analysis skills once data is collected.
Step 1: Clarify the Research Need
Before suggesting methods, derive a clear, consulting-style problem framing.
- - Clarify business and research goals
- What decision will this research inform?
- What would success look like for stakeholders?
- What hypotheses or assumptions are we testing?
- - Define target users and context
- Which segment(s), roles, geographies, or usage patterns matter?
- In what context does the behavior occur (device, channel, environment)?
- Timeframe, budget, required sample size or coverage
- Access to participants (existing users, prospects, internal staff)
Output for this step:
- - A short Problem Statement
- 3–7 Key Questions (MECE where possible)
- A list of Assumptions / Hypotheses to probe
Step 2: Choose Research Approach(es)
Use a small set of canonical user and market research methods. Combine methods when appropriate (mixed methods).
Method-Selection Matrix
| Primary goal | Typical method(s) | Notes |
|---|
| Explore unknown problem space | 1:1 in-depth interviews, contextual inquiry, diary | Discovery / generative research |
| Evaluate usability of an experience |
Moderated usability tests, unmoderated remote tests | Task-based, scenario-driven |
| Measure attitudes or behaviors at scale| Structured survey, poll, simple experiment | Requires clear constructs and metrics |
| Compare concepts or ideas | Concept testing sessions, preference tests, card sorts | May combine with interview or survey |
| Understand real-world context | Field visits, observation, shadowing, diary study | Higher logistics cost |
Method choice should balance:
- - Stage (discovery vs validation vs evaluation)
- Decision type (go/no-go, prioritization, design iteration, positioning)
- Practical constraints (timeline, recruiting, tools already in use)
When recommending methods:
- - Propose 1–2 primary methods plus any lightweight secondary methods
- Briefly justify each method in terms of the user’s goals and constraints
Step 3: Turn the Approach into a Study Plan
Following both classic marketing-research texts and NN/g research-plan guidance, every study plan should cover at least:
- - Background & Objectives
- Context, problem statement, business goals
- Research objectives and key questions
- Chosen methods and rationale
- Study type (exploratory, descriptive, causal; formative vs summative)
- Target population and segments
- Inclusion / exclusion criteria
- Planned sample size and justification
- Study phases (pilot, main fieldwork)
- Session format (remote vs in-person, moderated vs unmoderated)
- High-level flow or timeline
- - Roles and Responsibilities
- Researcher, moderator, note-taker, stakeholders
- - Risks and Ethical Considerations
- Consent, privacy, incentives, sensitive topics
When the user asks for a plan, structure your answer in these sections and keep wording concise enough that it can be copy-pasted into a research plan document.
Step 4: Generate Research Materials
For each chosen method, generate concrete artifacts. Keep templates modular so they can be reused across projects.
4.1 Recruitment Screener
Structure:
- - Study title and short purpose (participant-facing)
- Eligibility questions
- Must-have criteria (knock-out logic)
- Nice-to-have criteria (for quota balancing)
- - Disqualification rules (e.g., professional researchers, competitors)
- Demographic / firmographic questions only as necessary
Make the screener:
- - Simple enough for non-researchers to administer
- Explicit about inclusion/exclusion logic
4.2 Participant Invitation & Consent Wording
Include:
- - Plain-language description of the study’s purpose
- What participation involves (time, activities, recording)
- Incentive and payment process
- Privacy and confidentiality statement
- Contact for questions or withdrawal
Ensure consent text is non-legalistic but clear; defer to the user’s legal or compliance team for final approval.
4.3 Interview / Discussion Guide
For qualitative interviews, base structure on best practices from interview-focused texts:
- - Introduction and warm-up
- Core sections aligned to key questions or themes
- Probing prompts and follow-ups (avoid leading questions)
- Wrap-up, closing questions, and thanks
Organize the guide as:
- - Section headings (themes)
- Bullet-point questions and probes
- Optional timing guidance per section
4.4 Usability Test Script
Components:
- - Study intro (purpose, disclaimers, think-aloud instructions)
- Task list
- Realistic scenarios framed in user language
- Clear success criteria per task
- Space for observers to note observations
- - Closing questions (short interview or satisfaction questions)
Include simple moderator cues (what to read verbatim, when to stay silent, when to probe).
4.5 Survey Questionnaire
When planning surveys, follow quantitative UX and survey-design guidance:
- - Map each construct (e.g., satisfaction, trust, task success) to specific items
- Prefer simple, unambiguous wording
- Choose scale types consistently (e.g., 5- or 7-point Likert, yes/no, NPS)
- Keep survey as short as possible while still answering key questions
Output:
- - Ordered list of questions
- Response options and scale labels
- Any skip logic or branching described in plain language
Step 5: Package an Execution-Ready Output
Default response format for this skill:
CODEBLOCK3
Populate each section with concrete, copy-paste-ready content tailored to the user’s situation.
Phases Overview
For more detailed step-by-step guidance, this skill includes phase files under phases/:
- Use when you need to deeply clarify the
research need, decisions, target users, and constraints.
- Expands
Step 1 into a full workflow for:
- Business context and decisions.
- Research objectives and key questions.
- Target users and context.
- Constraints and a one-page Phase 1 summary.
- Use when moving from clarified need to
method selection and a full research plan.
- Expands
Steps 2–3 into:
- Mapping objectives to research types (exploratory, descriptive, evaluative, causal).
- Selecting single or mixed methods.
- Drafting a structured research plan (background, methodology, participants, procedure, risks).
- Use when turning the approved plan into
research materials and an operational schedule.
- Expands
Steps 4–5 into:
- Mapping plan components to required artifacts (screener, guide, script, survey, etc.).
- Drafting and refining materials using the templates.
- Creating timelines, roles, and operational checklists.
When a user task is complex (e.g., multi-method study, multiple stakeholders, long timeline), prefer:
- 1. Following the relevant
phases/ file(s) for process and structure. - Using the
templates/ files for concrete artifact formats.
Templates Overview
This skill is bundled with detailed templates under templates/. Use them as follows:
- - Research planning and alignment
- When the user asks for a
research plan or
study proposal, read:
-
templates/research-plan-template.md
- When the user needs
stakeholder alignment or a kickoff agenda, read:
-
templates/stakeholder-kickoff-template.md
-
templates/stakeholder-walkthrough-template.md
- When scoping what is
out of scope and defining future research needs, read:
-
templates/out-of-scope-and-research-needs-template.md
- When grounding a study in existing knowledge with a
desk/literature review, read:
- INLINECODE11
- For any study involving human participants (interviews, usability tests, diary studies, etc.), read:
- INLINECODE12
- - Interview- and workshop-based methods
- For
qualitative interviews or discussions, read:
-
templates/interview-guide-template.md
- For
focus groups, read:
-
templates/focus-group-template.md
- For
persona workshops and persona documentation, read:
-
templates/persona-workshop-and-template.md
- For
stakeholder discovery sessions, read:
-
templates/stakeholder-walkthrough-template.md
- For
brainstorming/ideation sessions, read:
- INLINECODE17
- - Usability and UX evaluation
- For
moderated usability testing, read:
-
templates/usability-test-script-template.md
- For
expert reviews of flows or UI, read:
-
templates/expert-review-template.md
- For
heuristic evaluations, read:
-
templates/heuristic-evaluation-template.md
- For
rapid iterative testing (RITE), read:
-
templates/rapid-iterative-testing-rite-template.md
- For
eye-tracking studies, read:
-
templates/eye-tracking-template.md
- For
A/B tests / online experiments, read:
- INLINECODE23
- - Information architecture and navigation
- For
card sorting (mental models, IA exploration), read:
-
templates/card-sorting-template.md
- For
tree testing (validating IA structure), read:
- INLINECODE25
- - Surveys and satisfaction measurement
- For
customer satisfaction surveys (CSAT, NPS + drivers), read:
-
templates/customer-satisfaction-surveys-template.md
- For
recruitment screeners and survey structures, read:
- INLINECODE27
- - Contextual and longitudinal methods
- For
contextual inquiry / field visits, read:
-
templates/contextual-inquiry-template.md
- For
diary studies, read:
-
templates/diary-study-template.md
- For
shadowing and associated note-taking, read:
-
templates/shadowing-template.md
-
templates/shadowing-notes-template.md
- For
ethnographic or deep contextual work, read:
- INLINECODE32
- - Strategy, jobs, and journeys
- For
Jobs to Be Done (JTBD) framing, read:
-
templates/jobs-to-be-done-template.md
- For
gap analyses (current vs desired experience or capability), read:
-
templates/gap-analysis-template.md
- For
user journeys / experience maps, read:
-
templates/journey-map-template.md
- For
competitive or comparative analysis, read:
-
templates/competitive-analysis-template.md
- For
Kano analysis of feature satisfaction, read:
- INLINECODE37
- - Visualization and empathy tools
- For
empathy maps, read:
-
templates/empathy-map-template.md
- For
storyboards to visualize key moments, read:
- INLINECODE39
When generating any concrete artifact (plan, screener, guide, script, survey, etc.), first:
- 1. Identify the relevant method(s) based on the user’s goal.
- Read the corresponding template file(s) from
templates/. - Adapt the structure and fill in project-specific details.
Future Extensions
To keep SKILL.md concise, move heavier content into separate files when needed:
- -
phases/ directory for more detailed, phase-by-phase instructions (similar to interview-analysis skills) - INLINECODE43 for long-form templates and examples
Link to those files from this skill when they exist, and keep this core document focused on the high-level framework and standard response structures.
安装
通过 Clawdhub:
bash
clawdhub install research-planner
手动安装:
bash
npx skills add https://github.com/NKZ55/research-planner/tree/main/skills/research-planner
研究规划器
市场和用户研究规划技能,专注于研究设计与文档编制,而非数据分析。
该技能灵感来源于以下系统性框架:
- Erika Hall,《恰到好处的研究》(研究策略、范围界定、利益相关者对齐)
- Steve Portigal,《访谈用户》(研究设计与访谈材料)
- C. J. Hoefflich 与 Jeff Sauro,《量化用户体验》(定量用户体验测量与研究设计——此处用于规划,而非分析)
- Naresh Malhotra,《营销研究》(问题定义 → 研究设计 → 数据收集计划)
- 麦肯锡式
假设驱动、MECE 研究框架(议题树、关键问题、假设)
- Nielsen Norman Group 研究规划指南(
研究计划、
研究方法概览)
- 实践导向的用户体验研究策略指南,例如
研究策略终极指南
该技能帮助智能体:
- - 根据用户的目标、约束和受众,选择合适的研究方法
- 将选定的方法转化为具体的研究产物(筛选问卷、调查问卷、讨论指南、任务清单等)
- 将研究项目结构化为清晰的阶段和可交付成果
数据分析(定性编码、统计分析、报告撰写)明确不在范围内,应委托给专注于分析的技能(例如,访谈分析技能,如访谈分析师)。
范围
- 明确研究目标和假设
- 选择合适的研究方法(例如,深度访谈、可用性测试、调查、日记研究、实地研究、概念测试)
- 设计多方法研究计划(混合方法)
- 起草开展研究所需的所有研究材料:
- 招募筛选问卷和资格标准
- 参与者邀请文本和同意书措辞
- 访谈和讨论指南
- 可用性测试任务脚本和成功标准
- 调查问卷和问题措辞
- 主持人笔记和观察模板
- 构建时间线、里程碑和所需执行角色
- 清理、转换或汇总收集到的数据
- 对定性数据进行编码或运行统计检验
- 创建洞察报告、最终研究报告或建议
- 任何属于独立分析/报告技能的任务
阶段模型
对每个项目使用此阶段模型。该技能仅涵盖规划和文档编制阶段。
text
问题框架
↓
研究策略与方法选择
↓
研究计划与后勤
↓
研究材料(筛选问卷、指南、调查、脚本)
↓
实地工作 / 数据收集 [范围外]
↓
分析与报告 [范围外 – 使用分析技能]
如何使用此技能
针对每个用户请求:
- 1. 明确研究需求
- 选择合适的研究方法
- 将方法转化为具体的研究计划
- 生成必要的研究材料
- 将所有内容打包成一个可执行的交付包
始终将分析排除在范围之外,并在数据收集完成后,温和地引导用户使用分析技能。
第一步:明确研究需求
在建议方法之前,推导出清晰的、咨询风格的问题框架。
- 这项研究将为哪些决策提供信息?
- 对利益相关者而言,成功是什么样的?
- 我们在测试哪些假设或前提?
- 哪些细分市场、角色、地区或使用模式是重要的?
- 行为发生在什么背景下(设备、渠道、环境)?
- 时间框架、预算、所需样本量或覆盖范围
- 参与者获取途径(现有用户、潜在用户、内部员工)
此步骤的输出:
- - 简短的问题陈述
- 3–7 个关键问题(尽可能 MECE)
- 需要探究的假设/前提列表
第二步:选择研究方法
使用一小套规范的用户和市场研究方法。在适当时组合方法(混合方法)。
方法选择矩阵
| 主要目标 | 典型方法 | 备注 |
|---|
| 探索未知问题空间 | 一对一深度访谈、情境调查、日记研究 | 发现 / 生成性研究 |
| 评估体验的可用性 |
有主持的可用性测试、无主持的远程测试 | 基于任务、场景驱动 |
| 大规模测量态度或行为| 结构化调查、投票、简单实验 | 需要清晰的构念和指标 |
| 比较概念或想法 | 概念测试会议、偏好测试、卡片分类 | 可与访谈或调查结合 |
| 了解现实世界背景 | 实地访问、观察、影子工作、日记研究 | 后勤成本较高 |
方法选择应平衡:
- - 阶段(发现 vs 验证 vs 评估)
- 决策类型(通过/不通过、优先级排序、设计迭代、定位)
- 实际约束(时间线、招募、已使用的工具)
在推荐方法时:
- - 提出 1–2 种主要方法以及任何轻量级的次要方法
- 根据用户的目标和约束简要说明每种方法的理由
第三步:将方法转化为研究计划
遵循经典营销研究文本和 NN/g 研究规划指南,每个研究计划至少应涵盖:
- 背景、问题陈述、业务目标
- 研究目标和关键问题
- 所选方法及理由
- 研究类型(探索性、描述性、因果性;形成性 vs 总结性)
- 目标人群和细分市场
- 纳入/排除标准
- 计划样本量及理由
- 研究阶段(试点、主要实地工作)
- 会议形式(远程 vs 现场,有主持 vs 无主持)
- 高层流程或时间线
- 研究员、主持人、记录员、利益相关者
- 同意书、隐私、激励措施、敏感话题
当用户要求制定计划时,按这些部分组织你的回答,并保持措辞简洁,以便可以直接复制粘贴到研究计划文档中。
第四步:生成研究材料
针对每种选择的方法,生成具体的产物。保持模板模块化,以便在项目间重复使用。
4.1 招募筛选问卷
结构:
- 必备标准(淘汰逻辑)
- 加分标准(用于配额平衡)
- - 取消资格规则(例如,专业研究人员、竞争对手)
- 仅在必要时询问人口统计/公司统计问题
使筛选问卷:
- - 足够简单,非研究人员也能管理
- 明确包含/排除逻辑
4.2 参与者邀请与同意书措辞
包括:
- - 研究目的的通俗语言描述
- 参与内容(时间、活动、录音)
- 激励措施和支付流程
- 隐私和保密声明
- 问题或退出的联系方式
确保同意文本非法律化但清晰;最终批准请参考用户的法律或合规团队。
4.3 访谈/讨论指南
对于定性访谈,基于访谈重点文本的最佳实践构建结构:
- - 介绍和热身
- 与关键问题或主题对齐的核心部分
- 探究提示和追问(避免引导性问题)
- 结束、收尾问题和感谢
将指南组织为:
- - 部分标题(主题)
- 要点问题和提示
- 每部分的可选时间指导
4.4 可用性测试脚本
组成部分:
- - 研究介绍(目的、免责声明、出声思维指示)
- 任务列表
- 以用户语言构建的现实场景
- 每个任务的明确成功标准
- 供观察者记录观察结果的空间
包含简单的主持人提示(逐字阅读的内容、何时保持沉默、何时探究)。
4.5 调查问卷
在规划调查时,遵循定量用户体验和调查设计指南:
- - 将每个构念(例如,满意度、信任度、任务成功率)映射到具体项目
- 优先使用简单、无歧义的措辞
- 一致选择量表类型(例如,5 点或 7 点李克特量表、是/否、NPS)
- 在回答关键问题的前提下,尽可能保持调查简短
输出: