mcpField
R
research

research

github.com/openaiDesign & UI56063 installsUpdated 4w ago
Repository

About research

research is a UX research skill that scans current public and, when available, internal sources for evidence-backed product problems. It ranks findings, separates observed evidence from inference, and turns them into a product narrative and opportunities.

Key features

  1. 01Fresh UX research scans
  2. 02Public and available internal sources
  3. 03Problem clustering and ranking
  4. 04Evidence separated from inference
  5. 05Prioritized opportunity map

Use cases

  1. 01Finding friction in onboarding and self-serve flows
  2. 02Investigating documentation or support problems
  3. 03Prioritizing product workflow improvements

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openai/role-specific-plugins --skill research

After installing, type/researchin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

Research

Run a fresh UX research scan for the product the user specifies.

Focus on current, evidence-backed user problems. Prioritize logged-in product experience, self-serve flows, onboarding, docs/help, developer experience, support friction, and product workflows.

Critical Overrides

User Context

Before starting, load $user-context and run its preflight script when local shell access is available.

Use saved product URLs, Figma files, screenshots, reference images, codebase paths, Storybook, tokens, design systems, brand assets, component refs, browser preferences, and share targets as grounding material when relevant.

Do not inspect every saved reference. Inspect only what the current task needs.

Contract

  • Restate the product, audience, time horizon, and research scope before scanning.
  • Use public sources by default. Use internal sources when the connectors are available and the user request allows it.
  • Cite sources wherever available.
  • Separate observed evidence from inference.
  • Do not overclaim from anecdotes.
  • Do not return a dump of complaints. Tell a clear product story.
  • Say clearly when source access is missing or weak.

Workflow

  1. Restate the research scope.

  2. Search public sources:

  • Reddit
  • X/Twitter
  • Hacker News
  • Stack Overflow
  • GitHub issues/discussions
  • forums, blogs, reviews, YouTube comments, and developer communities where relevant
  1. Search internal sources when available:
  • Slack
  • Gong
  • Notion
  • Google Drive/docs
  • Linear/Jira/GitHub
  • support or CRM notes if available

  1. Cluster evidence into the highest-signal UX problems.

  2. Separate:

  • product UI/workflow friction
  • docs/help friction
  • onboarding friction
  • account, billing, permissions, or setup friction
  • developer/API/SDK friction
  • reliability/performance issues
  • feature requests

  1. Rank problems by severity, frequency, confidence, and product leverage.

  2. Tell a clear product story.

Output

Default to an in-chat research brief unless the user asks for another format.

Include:

  • Executive read: the core story in 5-7 sentences.
  • Ranked UX problems: for each problem, include the problem, user goal, surface, what breaks, evidence, severity, frequency signal, confidence, and recommended product move.
  • Source map: what was searched, what each source contributed, and where signal was weak.
  • Opportunity map: group recommendations into fix this week, fix this quarter, and needs deeper research.

Rules

  • Use citations wherever available.
  • Do not overclaim from anecdotes.
  • Separate loud complaints from frequent problems.
  • Separate UX friction from missing features.
  • Separate reliability/performance issues from UX workflow issues.
  • Mark internal-only evidence separately from public evidence.
  • Keep the brief sharp, specific, and easy to consume.

Comments

Markdown supported