Back to list
joshuacook

role

by joshuacook

Filesystem-first knowledge management for Claude Code. Context Lake pattern with MCP integration.

1🍴 1📅 Jan 23, 2026

SKILL.md


name: role description: 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. allowed-tools: Read

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.

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon