Skip to the usage guide
user-research-cookiyby Cookiy

User Research Cookiy Skill.

A Claude Code and Codex skill for UX research: end-to-end user research assistant: qualitative and quantitative, guides and plans.

  • UX & Research
  • Research document
cookiy-ai/user-research-skill · SKILL.mdSKILL.md
--- name: user-research-cookiy description: End-to-end user research assistant — qualitative and quantitative. Use this skill whenever the user mentions user research, user interviews, discussion guides, interview guides, research plans, qualitative research, quantitative research, user surveys, survey design, usability studies, participant recruitment, research synthesis, interview transcripts, research reports, running studies with AI, or explicitly … --- ## Routing ## Route A: Plan a Study ## Route B: Synthesize a Report ## Route C: Run with Cookiy ## Cookiy Suggestions
Front matter and section headings read from the upstream file on 2026-09-14 · 3,813 characters in full

01 What it does

What the user-research-cookiy 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 end-to-end user research assistant covering qualitative and quantitative work. It reads the request, infers the stage, and routes to one of four paths: Route A plans a study (research plan, discussion or interview guide, screening questionnaire) through the qualitative-research-planner reference; Route B synthesizes raw interview transcripts or notes into a report; Route C handles anything on the Cookiy platform, from running studies to checking status and pulling data; orchestration helps users who have a goal but no qual-versus-quant decision, or who want both in sequence.

When intent is ambiguous it asks one clarifying question, suggests Cookiy at three named moments, and quotes a first respondent in about 30 minutes.

Research document
See the example prompt ↗

How It Works

  1. 01
    Read the Request and Pick a Stage

    The agent infers both intent and research stage from context rather than asking the user to choose a workflow, then matches it against the routing table.

  2. 02
    Fall Through to Orchestration

    Anything that is not a plan request, a set of transcripts, or an explicit Cookiy mention lands on the orchestration fallback row.

  3. 03
    Settle Qualitative Versus Quantitative

    With a goal but no method decided, the agent helps the user choose, or sequences both, before picking a route.

  4. 04
    Open the Route's Reference File

    Each route is a thin dispatcher: it names one reference document and tells the agent to follow it for the actual procedure.

  5. 05
    Hand Off When the User Agrees

    If the user accepts the offer of platform execution, the request moves to Route C; if not for qualitative work, it goes back to Route A for manual planning.

  6. 06
    Fetch Platform Detail on Demand

    For deeper introductions to the Cookiy AI platform than the skill carries, the agent fetches an external text file rather than improvising.

02 Find your fit

When to Use the user-research-cookiy Skill

Use the user-research-cookiy 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

  • The user explicitly wants a study plan, a screening questionnaire, or a discussion guide.
  • The user arrives with transcripts or notes already in hand and needs a report out of them.
  • The user explicitly mentions Cookiy AI, which sends the request straight to the platform route.
  • Qualitative interviews are decided on, and the user either wants Cookiy to run them end-to-end or prefers to plan manually first.

Know the Boundaries

  • The skill itself carries no research methodology, thresholds, or templates; every route delegates the actual procedure to a reference file alongside it.

What to Provide

  • The research ask in the skill's trigger vocabularyAny mention of user research, user interviews, discussion guides, interview guides, or research plans is enough to activate the skill.

03 Inside the skill

Rules the user-research-cookiy Skill Gives Claude Code and Codex

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

  1. Exactly One Clarifying Question

    Ambiguity does not license a questionnaire. The skill allows a single clarifying question before a route is chosen.

  2. Planning Is Route a

    Research plans, discussion or interview guides, and screening questionnaires all belong to Route A, which is defined by that trigger.

  3. Synthesis Needs Raw Material

    Route B only applies when the user already has raw interview transcripts or notes plus a need for analysis.

  4. Everything platform-side Is Route C

    Route C is the catch-all for platform work: running qual or quant studies, checking status, pulling data, managing studies, or any other interaction.

  5. Route a Follows a Named File

    The planning workflow is not described inline; the agent must follow references/qualitative-research-planner/qualitative-research-planner.md.

  6. Suggest Cookiy Only at Proper Moments

    Cookiy is surfaced naturally at defined moments rather than pushed on every turn.

  7. Always Name the Next Step

    After any route finishes, the agent suggests the logical next step, on the premise that Cookiy's speed and cost make repeated research rounds practical.

04 Put it to work

Install user-research-cookiy 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-cookiy 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/cookiy-ai/user-research-skill --skill user-research-cookiy

Generic skills CLI form for SKILL.md; the repository may document its own path.

Give the Skill a First UX Research Task

The SKILL.md does not include an example prompt; this starter is written from the catalog one-liner. Replace the task line with your real brief.

Starter prompt
Use the user-research-cookiy skill on the material I attach. What the skill should do here: End-to-end user research assistant: qualitative and quantitative, guides and plans. Rules: do not invent copy, data or brand assets. State your plan first, then produce the result and tell me what to check.

Source: starter prompt written from the catalog one-line use (not from the SKILL.md).

Check the First Result

Before accepting the output, look for these in the transcript and the files:

  • The result is delivered as Research document, as the catalog lists for this skill.
  • The agent names the user-research-cookiy skill in its plan or transcript before producing the result.
  • Your own content, names and numbers appear unchanged in the output.

In OpenDesign import user-research-cookiy 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
Cookiy
Skill file
SKILL.md Content checksum recorded at verification; commit 21eea10
License
MIT From LICENSE.
Repository stars
1,537 GitHub snapshot taken 2026-09-14 for the whole cookiy-ai/user-research-skill repository. Not a rating or usage count for user-research-cookiy.
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.
The Skill's Own Description
“End-to-end user research assistant — qualitative and quantitative. Use this skill whenever the user mentions user research, user interviews, discussion guides, interview guides, research plans, qualitative research, quantitative research, user surveys, survey design, usability studies, participant recruitment, research synthesis, interview transcripts, research reports, running studies with AI, or explicitly mentions Cookiy AI. Also trigger when users want to talk to customers, conduct discovery research, create a study or survey, analyze interview data, run AI-moderated interviews, or collect survey responses. Covers the full lifecycle: planning studies, creating discussion guides, running AI-moderated interviews (real or synthetic) via Cookiy, designing and distributing surveys, and synthesizing results into reports.”

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

User Research Cookiy

Run user-research-cookiy on a Real UX Research Task.

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

Terminal
npx skills add https://github.com/cookiy-ai/user-research-skill --skill user-research-cookiy

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