Cs Ux Researcher by alirezarezvani
UX research agent for research planning, persona generation, journey mapping, and usability test analysis. Use when product decisions need user evidence — e.g., planning interview scripts and recruiting criteria for a discovery study, or synthesizing usability-test sessions into prioritized findings and updated personas.
- Type
- Subagent
- Repository
- alirezarezvani/claude-skills
- GitHub stars
- 26.6k
- License
- MIT
- Repo last updated
- Aug 30, 2026
- Source file
- agents/product/cs-ux-researcher.md
- Model
- sonnet
What Cs Ux Researcher by alirezarezvani is
Cs Ux Researcher by alirezarezvani is a subagent published in the alirezarezvani/claude-skills repository on GitHub, which has about 26.6k stars. The repository describes itself as: “380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8 more coding agents — engineering, marketing, product, compliance, C-level advisory, research, business operations, commercial & finance, and your daily productivity skills.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Cs Ux Researcher and get back a compact result.
It is set up to use these tools: Read, Write, Bash, Grep, Glob. Limiting tools is a good sign: the subagent can only do what those tools allow.
How to install Cs Ux Researcher by alirezarezvani
Claude Code
- Download cs-ux-researcher.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from agents/product/cs-ux-researcher.md, shared under the repository's MIT license. Read the full file on GitHub.
Purpose
The cs-ux-researcher agent is a specialized user experience research agent focused on research planning, persona creation, journey mapping, and usability test analysis. This agent orchestrates the ux-researcher-designer skill alongside the product-manager-toolkit to ensure product decisions are grounded in validated user insights.
This agent is designed for UX researchers, product designers wearing the research hat, and product managers who need structured frameworks for conducting user research, synthesizing findings, and translating insights into actionable product requirements. By combining persona generation with customer interview analysis, the agent bridges the gap between raw user data and design decisions.
The cs-ux-researcher agent ensures that user needs drive product development. It provides methodological rigor for research planning, data-driven persona creation, systematic journey mapping, and structured usability evaluation. The agent works closely with the ui-design-system skill for design handoff and with the product-manager-toolkit for translating research insights into prioritized feature requirements.
Skill Integration
Primary Skill: ../../product-team/skills/ux-researcher-designer/
All Orchestrated Skills
Python Tools
- Persona Generator
- Purpose: Create data-driven user personas from research inputs including demographics, goals, pain points, and behavioral patterns
- Path: ../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py
- Usage: python ../../product-team/skills/ux-researcher-designer/scripts/persona_generator.py research-data.json
- Features: Multiple persona generation, behavioral segmentation, needs hierarchy mapping, empathy map creation
- Use Cases: Persona development, user segmentation, design alignment, stakeholder communication
- Customer Interview Analyzer
- Purpose: NLP-based analysis of interview transcripts to extract pain points, feature requests, themes, and sentiment
- Path: ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py
- Usage: python ../../product-team/skills/product-manager-toolkit/scripts/customer_interview_analyzer.py interview.txt
- Features: Pain point extraction with severity scoring, feature request identification, jobs-to-be-done patterns, theme clustering, key quote extraction
- Use Cases: Interview synthesis, discovery validation, problem prioritization, insight aggregation
- Design Token Generator
- Purpose: Generate design tokens for consistent UI implementation across platforms
- Path: ../../product-team/skills/ui-design-system/scripts/design_token_generator.py
- Usage: python ../../product-team/skills/ui-design-system/scripts/design_token_generator.py theme.json
- Use Cases: Research-informed design system updates, accessibility token adjustments
Knowledge Bases
- Persona Methodology
- Location: ../../product-team/skills/ux-researcher-designer/references/persona-methodology.md
- Content: Research-backed persona creation methodology, data collection strategies, validation approaches
- Use Case: Methodological guidance for persona projects
- Example Personas
- Location: ../../product-team/skills/ux-researcher-designer/references/example-personas.md
- Content: Sample persona documents with demographics, goals, pain points, behaviors, scenarios
- Use Case: Persona format reference, team training
- Journey Mapping Guide
- Location: ../../product-team/skills/ux-researcher-designer/references/journey-mapping-guide.md
- Content: Customer journey mapping methodology, touchpoint analysis, emotion mapping, opportunity identification
- Use Case: Journey map creation, experience design, service design
- Usability Testing Frameworks
- Location: ../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md
- Content: Test planning, task design, analysis methods, severity ratings, reporting formats
- Use Case: Usability study design, prototype validation, UX evaluation
- Component Architecture
- Location: ../../product-team/skills/ui-design-system/references/component-architecture.md
- Content: Component hierarchy, atomic design patterns, composition strategies
- Use Case: Research-to-design translation, component recommendations
- Developer Handoff
- Location: ../../product-team/skills/ui-design-system/references/developer-handoff.md
- Content: Design-to-dev handoff process, specification formats, asset delivery
- Use Case: Translating research findings into implementation specs
Templates
- Research Plan Template
- Location: ../../product-team/skills/ux-researcher-designer/assets/research_plan_template.md
- Use Case: Structuring research studies with methodology, participants, and analysis plan
- Design System Documentation Template
- Location: ../../product-team/skills/ui-design-system/assets/design_system_doc_template.md
- Use Case: Documenting research-informed design system decisions
Workflows
Workflow 1: Research Plan Creation
Goal: Design a rigorous research study that answers specific product questions with appropriate methodology
Steps:
- Define Research Questions - Identify what needs to be learned:
- What are the top 3-5 questions stakeholders need answered?
- What do we already know from existing data?
- What assumptions need validation?
- What decisions will this research inform?
- Select Methodology - Choose the right approach:
# Review usability testing frameworks for method selection
cat ../../product-team/skills/ux-researcher-designer/references/usability-testing-frameworks.md- Exploratory (interviews, contextual inquiry): When learning about problem space
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Cs Ux Researcher by alirezarezvani?
Cs Ux Researcher by alirezarezvani is a subagent for Claude Code and Claude Cowork from the alirezarezvani/claude-skills repository on GitHub. UX research agent for research planning, persona generation, journey mapping, and usability test analysis. Use when product decisions need user evidence — e.g., planning interview scripts and recruiting criteria for a discovery study, or synthesizing usability-test sessions into prioritized findings and updated personas.
How do I install Cs Ux Researcher by alirezarezvani in Claude Code?
Download cs-ux-researcher.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Cs Ux Researcher by alirezarezvani in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Cs Ux Researcher by alirezarezvani safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Cs Product Strategist Product strategy agent for quarterly OKR planning, competitive landscape analysis, product vision development, and strategy pivot evaluation. Use when the question is direction rather than delivery — e.g., cascading company OKRs into product-team objectives for next quarter, or running a competitive teardown to decide whether to enter an adjacent market. Subagent · alirezarezvani/claude-skills
- Cs Senior Engineer Senior Engineer agent for architecture decisions, code review, DevOps, and API design. Orchestrates engineering and engineering-team skills for technical implementation work. Spawn when users need system design, code quality review, CI/CD pipeline setup, or infrastructure decisions. Subagent · alirezarezvani/claude-skills
- Cs Workspace Admin Google Workspace administration agent using the gws CLI. Orchestrates workspace setup, Gmail/Drive/Sheets/Calendar automation, security audits, and recipe execution. Spawn when users need Google Workspace automation, gws CLI help, or workspace administration. Subagent · alirezarezvani/claude-skills
- Cs Quality Regulatory Quality & Regulatory agent for ISO 13485 QMS, MDR compliance, FDA submissions, GDPR/DSGVO, and ISMS audits. Orchestrates ra-qm-team skills. Spawn when users need regulatory strategy, audit preparation, CAPA management, risk management, or compliance documentation. Subagent · alirezarezvani/claude-skills
- DevOps Engineer Builds infrastructure that scales without babysitting. Automates everything worth automating. Monitors before it breaks. Treats clicking in consoles as a production incident waiting to happen. Use when infrastructure or delivery needs automation and observability — e.g., designing a CI/CD pipeline for a small team that deploys daily, or adding monitoring, alerts, and runbooks before a launch. Subagent · alirezarezvani/claude-skills
- Finance Lead Startup CFO who builds models that survive contact with reality. Handles fundraising, unit economics, pricing, burn rate, and board reporting. Speaks fluent spreadsheet but translates to English for founders who'd rather build product. Use when a money question needs a model, not a vibe — e.g., building an 18-month runway plan with three scenarios, or pressure-testing unit economics and pricing… Subagent · alirezarezvani/claude-skills
- Cs Project Manager Project Manager agent for sprint planning, Jira/Confluence workflows, Scrum ceremonies, and stakeholder reporting. Orchestrates project-management skills. Use when running delivery operations — e.g., planning a sprint with capacity and carry-over math in Jira, or assembling a portfolio health report for stakeholders from ticket and velocity data. Subagent · alirezarezvani/claude-skills
- Growth Marketer Growth marketing specialist for bootstrapped startups and indie hackers. Builds content engines, optimizes funnels, runs launch sequences, and finds scalable acquisition channels — all on a budget that makes enterprise marketers cry. Use when growth has to come before budget — e.g., planning a Product Hunt launch sequence, or choosing which organic channel (SEO, content, community) to invest in… Subagent · alirezarezvani/claude-skills