role

joshuacook's avatarfrom joshuacook

Load specific role(s) for focused work. Use when user says "role [name]" or wants to work with specific roles. Supports single or multiple roles.

⭐0stars🔀1forks📁View on GitHub🕐Updated Dec 30, 2025⬇️1downloads

When & Why to Use This Skill

The Role skill is a powerful context-management utility designed to enhance Claude's focus by dynamically loading specific personas and expert configurations. By allowing users to trigger specialized roles—such as 'Architect', 'Technical Writer', or 'Creative Lead'—mid-session, this skill ensures the AI agent maintains the precise domain expertise, tone, and operational constraints required for complex, multi-stage workflows, effectively reducing generic outputs and improving task accuracy.

Use Cases

  • Technical Workflow Transitions: Seamlessly switch from a 'System Architect' role for high-level planning to a 'Senior Developer' role for code implementation without losing conversation history.
  • Multi-Disciplinary Collaboration: Activate multiple roles simultaneously, such as 'SEO Specialist' and 'Content Strategist', to ensure marketing materials are both creative and search-engine optimized.
  • Expert Persona Onboarding: Quickly initialize a session with a specific role like 'Legal Consultant' or 'Financial Analyst' to immediately apply industry-specific frameworks and compliance standards.
  • Dynamic Session Pivoting: Use the 'switch to' command to change the AI's perspective when a project moves from the research phase to the execution phase.
namerole
descriptionLoad specific role(s) for focused work. Use when user says "role [name]" or wants to work with specific roles. Supports single or multiple roles.
allowed-toolsRead

Role (Dynamic Role Loading)

Load specific role(s) for focused work.

When to Activate

  • User says: "role [name]", "take on [role]"
  • User requests specific role by name
  • Mid-session role switching

Flow

1. Parse Request

Single: "role architect" → load architect role Multiple: "role content and technical" → load both

2. Find Role Files

ls roles/*.md

Match requested role name to file. Common patterns:

  • Role name in filename (e.g., architect.md, 01-creative-lead.md)
  • Check role title in frontmatter if unclear

3. Load Role

cat roles/[matched-file].md

4. Activate

Single role:

[Role Name] here.

[1 sentence acknowledgment]

[First question or action]

Multiple roles:

[Primary Role] here, with [Secondary Role].

[How roles work together]

[First question]

Role Switching

User can say "switch to [role]" mid-session:

[Current]: Transitioning to [New Role].

[New Role]: [Pick up context from conversation]

Unknown Roles

If role not found:

I don't recognize that role. Available roles:

[List from roles/ directory]

Which role do you want?

Comparison

  • role: Load specific role on demand
  • start: Ask what to work on, then load relevant role
  • help: Assess system, suggest priorities

Use role when you know exactly which role you need.