Cookiy Skill

Official skill package for Cookiy — AI-powered user research through natural language.

Cookiy gives your AI agent user-research capabilities: create studies, design interview guides, conduct AI-moderated interviews with real or simulated participants, and generate insight reports.

Quick Install

Claude Code

Install as a plugin directly in Claude Code:

claude plugin add cookiy-ai/cookiy-skill

Or install the MCP server standalone:

npx cookiy-mcp --client claude-code -y

Codex

npx skills add cookiy-ai/cookiy-skill

Or install the MCP server directly:

npx cookiy-mcp --client codex -y

OpenClaw

clawhub install cookiy

Or install the MCP server directly:

npx cookiy-mcp --client openclaw

Cursor

Install from the Cursor Marketplace, or manually:

npx cookiy-mcp --client cursor -y

Any platform with Node.js

npx cookiy-mcp

The installer auto-detects installed AI clients and configures them.

What's in this repo

cookiy-skill/
├── .claude-plugin/plugin.json     # Claude Code plugin manifest
├── .cursor-plugin/plugin.json     # Cursor plugin manifest
├── .mcp.json                      # MCP server auto-registration
├── assets/
│   └── logo.svg                   # Cookiy logo
├── rules/
│   └── cookiy-basics.mdc          # Cursor rules for MCP interaction
├── skills/
│   └── cookiy/                    # Single unified skill
│       ├── SKILL.md               # Setup + intent router + universal rules
│       └── references/
│           ├── tool-contract.md   # Cross-workflow behavior contract
│           ├── study-creation.md  # Create studies from research goals
│           ├── ai-interview.md    # Simulate interviews with AI personas
│           ├── guide-editing.md   # Edit discussion guides
│           ├── recruitment.md     # Recruit real participants
│           └── report-insights.md # Generate and share reports
├── scripts/
│   └── install-mcp.sh            # Universal install script
├── README.md
└── LICENSE

Skill Overview

The cookiy skill handles both setup and workflow orchestration in a single package:

• Setup — Detects environment, installs the MCP server, handles OAuth, verifies connection
• Workflows — Routes user intents to the correct tool chain with enforced sequencing

Capability	Tools Used
Study Creation	cookiy_media_upload → cookiy_study_create → cookiy_guide_status → cookiy_guide_get
AI Interview	cookiy_simulated_interview_generate → cookiy_simulated_interview_status → cookiy_interview_list → cookiy_interview_playback_get
Guide Editing	cookiy_guide_get → cookiy_guide_impact → cookiy_guide_patch
Recruitment	cookiy_recruit_create (preview) → cookiy_recruit_create (confirm) → cookiy_recruit_status
Report & Insights	cookiy_report_status → cookiy_report_generate (when allowed) → cookiy_report_share_link_get (payment may be required here)

Platform Distribution

This single repository serves multiple distribution platforms:

Platform	What it reads	How users install
Claude Code Plugins	.claude-plugin/, .mcp.json, skills/	claude plugin add cookiy-ai/cookiy-skill
skills.sh (Codex, etc.)	skills/	npx skills add cookiy-ai/cookiy-skill
ClawHub (OpenClaw)	skills/	clawhub install cookiy
Cursor Marketplace	.cursor-plugin/, rules/, .mcp.json	Cursor marketplace UI

MCP Server

The skill orchestrates Cookiy's MCP server, which exposes 20 atomic tools for user research operations. The MCP server handles OAuth 2.1 authentication, billing, and all backend operations.

For MCP server installation without skills, see the cookiy-mcp npm package.

License

MIT