Skip to the usage guide
user-researchby Anthropic

User Research Skill.

A Claude Code and Codex skill for UX research: plans, conducts, and synthesizes user interviews, surveys, and usability tests.

  • UX & Research
  • Research document
anthropics/knowledge-work-plugins · design/skills/user-research/SKILL.mdSKILL.md
--- name: user-research description: Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research. --- ## Research Methods ## Interview Guide Structure ## Analysis Framework ## Deliverables
Front matter and section headings read from the upstream file on 2026-09-14 · 1,751 characters in full

01 What it does

What the user-research Skill Does in Claude Code and Codex

Summary, workflow and outputs, all read from the skill's SKILL.md.

From the SKILL.mdRead 2026-09-14 · not a recorded run

In the Skill's Own Terms

An operating manual for planning, running and synthesizing user research studies. It opens with a six-method comparison table — user interviews, usability testing, surveys, card sorting, diary studies, A/B testing — pairing each with what it is best for, a typical sample size and a duration.

From there it prescribes a five-part interview guide with minute allocations, four analysis frameworks, and the four deliverables a study should end with. It suits designers and developers who need to choose a method, write a guide, or turn session notes into themes and recommendations.

What it produces

  • Research plan covering objectives, methods, timeline and participants.
  • Interview guide with questions, probes and activities.
  • Highlight reel of key quotes and observations from the sessions.
See the example prompt ↗

How It Works

  1. 01
    Choose the Method Before the Plan

    The skill starts with the method rather than the document, so sample size and timing are decided deliberately instead of drifting.

  2. 02
    Run the Interview Against a five-part Agenda

    Warm-up builds rapport, then context, deep dive, reaction and wrap-up follow in order, each with its own allotment of minutes.

  3. 03
    Analyze with a Named Framework

    Analysis frameworks are called out explicitly; journey mapping is the one for visualizing the user experience over time rather than stacking up observations.

  4. 04
    Close with the Standard Artifacts

    A study is meant to end in a research plan, an interview guide, a synthesis report and a highlight reel, with the synthesis report carrying themes, insights and recommendations.

02 Find your fit

When to Use the user-research Skill

Use the user-research skill in Claude Code or Codex when the job is UX research of this kind. Fit and limits below are taken from the skill's own file.

Good Fit

  • You have a specific design or flow to evaluate and want it tested with 5-8 participants in 1-2 weeks.
  • You are making information architecture decisions and can recruit 15-30 people for about a week of card sorting.
  • You need to see behavior over time rather than a single session, and can run 10-15 participants across 2-8 weeks.

    What to Provide

    • Where you are in the study and what you are trying to learnThe skill is positioned around helping at any stage — planning, executing or synthesizing — so state which one you are at and what the research is about.

    03 Inside the skill

    Rules the user-research Skill Gives Claude Code and Codex

    6 concrete instructions, defaults and limits the SKILL.md sets for the agent — the part of the file that changes the result.

    1. Interviews Are 5-8 People Over 2-4 Weeks

      User interviews are scoped for deep understanding of needs and motivations, with a sample of 5-8 and a two to four week window.

    2. Surveys Need 100+ Respondents

      Surveys are for quantifying attitudes and preferences, sized at 100 or more and run in 1-2 weeks.

    3. Do Not Fix a Headcount for A/B Tests

      The A/B testing row sets sample size by statistical significance rather than a number, and allows 1-4 weeks for comparing specific design choices.

    4. Give the Deep Dive the Biggest Slice

      Of the five interview segments, the deep dive takes 20 minutes, double the context and reaction blocks.

    5. Always Ask What Was Missed

      The session closes with 5 minutes reserved for anything the participant thinks was missed, plus a thank-you.

    6. Frame Needs as Jobs to Be Done

      One of the four analysis frameworks is jobs to be done: understanding what users are hiring the product to do.

    04 Put it to work

    Install user-research in Claude Code or Codex

    One npx skills add command, then a first task in your agent and a checklist for the result.

    Add user-research to Claude Code, Codex or Your Agent

    Run in your project; the installer asks which agent to add it to.

    Terminal
    npx skills add https://github.com/anthropics/knowledge-work-plugins --skill user-research

    Generic skills CLI form for design/skills/user-research/SKILL.md; the repository may document its own path.

    Give the Skill a First UX Research Task

    Written in the skill's own terms; replace the bracketed parts with your material.

    Starter prompt
    I'm evaluating [the new onboarding flow] and want to run usability testing. Write me a research plan with objectives, timeline and participants, then a guide with questions and probes for 5-8 sessions across 1-2 weeks. Once the sessions are done I'll paste in the notes and you can turn them into a synthesis report.

    Source: written from the SKILL.md in the skill's own terms.

    Check the First Result

    What the SKILL.md itself says a correct result looks like:

    • The guide should open with a 5-minute warm-up that builds rapport and explains the session.
    • The reaction block should run 10 minutes and be where concepts or prototypes are shown.
    • Findings should be prioritized rather than just listed, using the impact/effort matrix.
    • Observations should be grouped into themes with affinity mapping before any insights are written.

    In OpenDesign import user-research from its SKILL.md link: Plugins → Add → Skill → Import from link, then pick it in the top bar.

    05 Open source, traceable

    Source, License and Verification

    Where this page's facts come from, and when they were last checked.

    Author
    Anthropic
    Skill file
    design/skills/user-research/SKILL.md Content checksum recorded at verification; commit 8f877b6
    License
    Apache-2.0 From LICENSE.
    Repository stars
    24,012 GitHub snapshot taken 2026-09-14 for the whole anthropics/knowledge-work-plugins repository, which contains 7 skills in this catalog. Not a rating or usage count for user-research.
    Verified by OpenDesign
    2026-09-14 Source file, path, license text and star count were checked. Not bundled in OpenDesign main (checked 2026-08-28); a live run has not been recorded on this page.

    Inside the SKILL.md

    1. Research MethodsSix methods compared on best use, sample size and time.
    2. Interview Guide StructureFive timed segments running from warm-up to wrap-up.
    3. Analysis FrameworkFour frameworks for turning observations into themes and priorities.
    4. DeliverablesThe four artifacts a finished study should produce.
    The Skill's Own Description
    “Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.”

    Front-matter description from SKILL.md. The full file is about 1,751 characters. Read the full file on GitHub.

    06 Before you install

    Questions About the user-research Skill

    Answers come from the SKILL.md as read on 2026-09-14, not from a recorded run.

    What kinds of requests can I bring to it?

    Anything that touches understanding users through research. The description triggers on 'user research plan', 'interview guide', 'usability test', 'survey design' and 'research questions', or on any request where you need help with an aspect of understanding your users through research.

    How do I compare the methods on offer?

    They are laid out in a single table with four columns — method, best for, sample size and time — so you can match a method to your goal and to how long you have.

    User Research

    Run user-research on a Real UX Research Task.

    Download OpenDesign, import user-research from its SKILL.md link, paste the prompt above, and read the plan before the result.

    Terminal
    npx skills add https://github.com/anthropics/knowledge-work-plugins --skill user-research

    OpenDesign Desktop

    One design system. Every output unmistakably your brand

    Inside the full Vibe Design Workspace, use the same brand rules across websites, slide decks, interactive prototypes, dashboards, images, and HTML video. Connect Codex, Claude Code, Cursor, and other coding agents already on your computer, then create locally for free.

    • Web, slides, prototypes, dashboards, images, and video
    • 140+ design systems, plus the full template and skill library
    • Connect local Codex and 21+ coding agents · Free to use
    Download free

    Available for macOS and Windows