Skip to content
Development
Skill

/role-help

Guide for choosing the right role. Trigger with "which role should I use?", "show role list", "how to use roles?", "recommend a role".

From plugin
claude-code-cookbook
1.1k39 skills9 agents39 commands8 MCP

Claude Code

$ npx -y skills add wasabeef/claude-code-cookbook --skill role-help --agent claude-code

SKILL.md

role-help.SKILL.md
description: 'Guide for choosing the right role. Trigger with "which role should I use?", "show role list", "how to use roles?", "recommend a role".'

Guide for choosing the right role

A selection guide and help system when you're unsure which role to use.

Usage

/role-help                      # General role selection guide
/role-help <situation/problem>  # Recommended roles for specific situations
/role-help compare <Role 1>,<Role 2> # Compare roles

Basic Examples

# General guidance
/role-help
→ List of available roles and their characteristics

# Situation-specific recommendation
/role-help "Concerned about API security"
→ Recommendation and usage of security role

# Role comparison
/role-help compare frontend,mobile
→ Differences and appropriate usage between frontend and mobile roles

Situation-Based Role Selection Guide

Security-Related

Use security role for:
✅ Implementation of login/authentication functions
✅ Security vulnerability checks for APIs
✅ Data encryption and privacy protection
✅ Security compliance verification
✅ Penetration testing

Usage: /role security

🏗️ Architecture & Design

Use architect role for:
✅ Evaluation of overall system design
✅ Microservices vs monolith decisions
✅ Database design and technology selection
✅ Scalability and extensibility considerations
✅ Technical debt assessment and improvement planning

Usage: /role architect

⚡ Performance Issues

Use performance role for:
✅ Slow applications
✅ Database query optimization
✅ Web page loading speed improvement
✅ Memory and CPU usage optimization
✅ Scaling and load countermeasures

Usage: /role performance

🔍 Problem Root Cause Investigation

Use analyzer role for:
✅ Root cause analysis of bugs and errors
✅ Investigation of system failures
✅ Structural analysis of complex problems
✅ Data analysis and statistical research
✅ Understanding why problems occur

Usage: /role analyzer

🎨 Frontend & UI/UX

Use frontend role for:
✅ User interface improvements
✅ Accessibility compliance
✅ Responsive design
✅ Usability and ease of use enhancement
✅ General web frontend technologies

Usage: /role frontend

📱 Mobile App Development

Use mobile role for:
✅ iOS and Android app optimization
✅ Mobile-specific UX design
✅ Touch interface optimization
✅ Offline support and synchronization functions
✅ App Store and Google Play compliance

Usage: /role mobile

👀 Code Review & Quality

Use reviewer role for:
✅ Code quality checks
✅ Readability and maintainability evaluation
✅ Coding convention verification
✅ Refactoring proposals
✅ PR and commit reviews

Usage: /role reviewer

🧪 Testing & Quality Assurance

Use qa role for:
✅ Test strategy planning
✅ Test coverage evaluation
✅ Automated test implementation guidelines
✅ Bug prevention and quality improvement measures
✅ Test automation in CI/CD

Usage: /role qa

When Multiple Roles Are Needed

🔄 multi-role (Parallel Analysis)

Use multi-role for:
✅ Evaluation from multiple professional perspectives
✅ Creating integrated improvement plans
✅ Comparing evaluations from different fields
✅ Organizing contradictions and overlaps

Example: /multi-role security,performance

🗣️ role-debate (Discussion)

Use role-debate for:
✅ Trade-offs between specialized fields
✅ Divided opinions on technology selection
✅ Making design decisions through discussion
✅ Hearing debates from different perspectives

Example: /role-debate security,performance

🤖 smart-review (Automatic Proposal)

Use smart-review for:
✅ Uncertainty about which role to use
✅ Wanting to know the optimal approach for current situation
✅ Choosing from multiple options
✅ Beginner indecision

Example: /smart-review

Role Comparison Table

Security Category

| Role | Main Use | Strengths | Weaknesses | | -------- | ---------------------------------------- | -------------------------------------- | ------------------------------------ | | security | Vulnerability and attack countermeasures | Threat analysis, authentication design | UX, performance | | analyzer | Root cause analysis | Logical analysis, evidence collection | Preventive measures, future planning |

Design Category

| Role | Main Use | Strengths | Weaknesses | | --------- | ------------- | ------------------------------------------- | --------------------------------------------- | | architect | System design | Long-term perspective, overall optimization | Detailed implementation, short-term solutions | | reviewer | Code quality | Implementation level, maintainability | Business requirements, UX |

Performance Category

| Role | Main Use | Strengths | Weaknesses | | ----------- | ---------------------------------- | -------------------------------------- | -------------------- | | performance | Speed improvement and optimization | Measurement, bottleneck identification | Security, UX | | qa | Quality assurance | Testing, automation | Design, architecture |

User Experience Category

| Role | Main Use | Strengths | Weaknesses | | -------- | --------- | ---------------------- | ---------------- | | frontend | Web UI/UX | Browser, accessibility | Server-side, DB | | mobile | Mobile UX | Touch, offline support | Server-side, Web |

Decision Flowchart When Unsure

What is the nature of the problem?
├─ Security-related → security
├─ Performance issues → performance
├─ Bug/failure investigation → analyzer
├─ UI/UX improvement → frontend or mob
Read more
@wasabeef
Ships withclaude-code-cookbook

A collection of commands, roles, and automation scripts for Claude Code. Automate your workflow without unnecessary confirmations, allowing you to focus on what matters.

1.1k39 skills9 agents8 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
1.1k
Star history of wasabeef/claude-code-cookbook on GitHub, a chart by star-history.com

Other skills on claude-code-cookbook.

check-fact

check-fact

Verify information accuracy against codebase and documentation. Trigger with "is this correct?", "fact check", "verify this", "is…

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react5d252k
@facebook@facebookInstall Skill

Questions about role-help.

Which coding agents can use role-help?
role-help installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.