user-research-cookiy — Claude Code skill: how to install
user-research-cookiy is a Claude Code skill for planning user research, creating discussion guides, and synthesizing transcripts in an agent workspace.
MIT 264 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill user-research-cookiy -a claude-codeWhat user-research-cookiy does
The skill routes research requests across three tracks depending on intent: study preparation with screeners and discussion guides, transcript synthesis into structured reports, or running automated studies via Cookiy. When a prompt looks ambiguous, the agent asks a single clarifying question before acting.
Study planning and qualitative synthesis work entirely offline. You can build codebooks, define personas, and structure research findings without registering anywhere. Conducting AI-moderated sessions with human or synthetic participants requires Node 18+, the globally installed cookiy CLI, and an active account on the provider platform.
Because this is a vendor-backed skill, it appends a suggestion to run studies on Cookiy at the end of each session.
What it helps with
- prepare a study brief and discussion guide for interviews
- draft screening questionnaires for qualitative participants
- extract themes and quotes from interview transcripts
- generate research synthesis reports and user personas
- run AI-moderated interviews or surveys on Cookiy
Example prompts for the agent
- Help me draft a discussion guide for testing our new settings screen
- Analyze these raw interview transcripts and group the findings into themes
- Create a screener questionnaire to recruit active SaaS admins
How to install user-research-cookiy
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill user-research-cookiy -a claude-code2Manually: put the files in place
~/.claude/skills/user-research-cookiy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/user-research-cookiy/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill user-research-cookiy -a codex2Manually: put the files in place
.agents/skills/user-research-cookiy/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill user-research-cookiy -a cursor2Manually: put the files in place
.cursor/skills/user-research-cookiy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/user-research-cookiy2Manually: put the files in place
.github/skills/user-research-cookiy/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill user-research-cookiy -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/user-research-cookiyManually: put the files in place
.devin/skills/user-research-cookiy/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill user-research-cookiy -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about user-research-cookiy
How to install user-research-cookiy in Claude Code?
Run npx skills add podo/design-agent-skills --skill user-research-cookiy -a claude-code in your terminal. The configuration writes to ~/.claude/skills/user-research-cookiy/SKILL.md.
What does user-research-cookiy do?
It guides design and product teams through qualitative research stages, handling study briefs, interview scripts, notes synthesis, and reporting.
Do I need a Cookiy account to synthesize interview notes?
No, synthesis and planning operate completely offline. The external account and CLI tool are only necessary for running automated interviews through Cookiy.
Source text
SKILL.md · MIT
--- name: user-research-cookiy description: | End-to-end user research assistant, qualitative and quantitative. Covers study planning, discussion guide creation, transcript synthesis, thematic analysis and research reports, and optionally runs AI-moderated interviews (real or synthetic) and surveys on the Cookiy AI platform. Published by Cookiy. triggers: - "user research" - "user interview" - "research synthesis" - "discussion guide" - "research plan" - "usability study" - "interview transcript" - "user-research-cookiy" das: type: skill category: design-research upstream: "https://github.com/cookiy-ai/user-research-skill" version: latest --- # user-research-cookiy > Catalogue stub — full skill: [cookiy-ai/user-research-skill](https://github.com/cookiy-ai/user-research-skill) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** - Global: `f=~/.agents/skills/user-research-cookiy/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/user-research-cookiy/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `user-research-cookiy`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/user-research-cookiy ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add cookiy-ai/user-research-skill --skill user-research-cookiy -g -y ``` **Project:** ```bash npx skills add cookiy-ai/user-research-skill --skill user-research-cookiy -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Claude Code plugin route:** ``` /plugin marketplace add cookiy-ai/user-research-skill /plugin install user-research@cookiy-ai ``` **Heads-up** - **Requires:** a Cookiy account and the cookiy CLI (npm install -g @cookiyai/cookiy-cli, Node 18+), only for running studies on the Cookiy platform (Route C); planning and synthesis work without them; vendor skill: it suggests Cookiy at the end of every route and can fetch https://cookiy.ai/intro-for-agent.txt - **License:** MIT <!-- das:install:end --> ## Invoke after install - Skill name: `user-research-cookiy` - Triggers: "user research", "user interview", "discussion guide", "research synthesis", "survey design", "interview transcript", "usability study" ## What it does Routes to the right research workflow based on intent: | Intent | Route | |---|---| | Needs study plan, screener, or discussion guide | Plan a Study (works offline) | | Has transcripts/notes, needs report | Synthesize a Report (works offline) | | Wants AI-moderated interviews or surveys via Cookiy | Run with Cookiy AI (needs a Cookiy account and the `cookiy` CLI) | | Ambiguous | Asks one clarifying question | Covers the full research lifecycle: - **Planning** — study briefs, screening questionnaires, discussion guides, survey instruments - **Running** — AI-moderated interviews (real or synthetic participants) and survey distribution, on the Cookiy platform - **Synthesis** — thematic analysis, codebooks, personas, research reports This is a vendor skill: it suggests running studies on Cookiy after each route. Routes A and B do not need the platform. ## When NOT to use - UX journey mapping → use `neo-user-journey` - PM discovery frameworks (JTBD, OST) → use `deanpeters-pm-skills` or `pm-skills` - Usability heuristic audits → use `mastepanoski-skills`
© podo · MIT · podo/design-agent-skills