role
- Repo stars 330
- License MIT
- Author repo claude-skill-registry
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.
- Fluxly category
- Data
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 94 / 100 · heuristic scan, not runtime safety proof
- Author / version / license
- @majiayu000 · MIT
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Plug-and-play
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. User says: "role [name]", "take on [role]" User requests specific role by name Mid-session role switching
Flow
Single: "role architect" → load architect role Multiple: "role content and technical" → load both
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
Single role: Multiple roles:
# 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
```bash
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
```bash
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. Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> When to Activate → Flow → 1. Parse Request → 2. Find Role Files → 3. Load Role → 4. Activate
terms -> Single · Multiple · Single role · Multiple roles · role · start · help
files/cmd -> architect.md · 01-creative-lead.md · role
body sha256 -> 6641b70d8475
Decide Fit First
Design Intent
How To Use It
Boundaries And Review