Create Role

Create Role

Use this skill to design and create a role that follows the workspace ROLE.md convention, and to decide how that role relates to reusable skills.

What this creates

This workflow is for two related assets:

1. A role definition:

   • .teamclu/roles/<role-slug>/ROLE.md

2. Optional role-specific skills:

   • .teamclu/roles/skills/<skill-slug>/SKILL.md

The role is the routing layer. It is disclosed first and helps the model decide when a capability cluster should be used.

The skill is the execution layer. It is disclosed only after the role is loaded or when a normal skill is used directly.

Directory model

Always reason from this structure:

.teamclu/
  roles/
    config.json
    <role-slug>/
      ROLE.md
    skills/
      <skill-slug>/
        SKILL.md

Key rules:

• ROLE.md describes the role and references role skills in ## Available role skills
• SKILL.md keeps the same shape as a normal agent skill
• The role should explain responsibility and routing
• The skill should hold reusable procedural instructions

Goal

Help the user define a role that:

• has a stable slug-style name
• has a short description suitable for <available_roles>
• includes clear Role, When to use, and Working style sections
• optionally lists role-specific skills in ## Available role skills
• is ready to save as .teamclu/roles/<role-slug>/ROLE.md
• includes a clear plan for whether related skills should be reused, migrated, copied, or newly created

Collect the minimum role definition

Before writing the role, gather or infer:

1. The role's routing name
2. A short description for progressive disclosure
3. The role's responsibility boundary
4. When the model should pick this role
5. The desired working style or review style
6. Whether the role should include role-specific skills now or leave that empty
7. Whether there are existing skills that already cover the role's execution needs
8. Whether those existing skills should remain normal skills, be copied into role skills, or be migrated into role skills
9. Whether any new role-specific skill must be created because no suitable skill already exists

Ask only for the missing pieces. If the user already provided enough context, do not ask redundant questions.

Skill relationship decisions

You must explicitly reason about the relationship between the new role and skills.

Before finalizing the role, determine:

1. Does the role need dedicated role skills at all?
2. If yes, are there already existing skills that can be used?
3. For each existing relevant skill:
   • keep it as a normal skill
   • copy it into .teamclu/roles/skills/<skill-slug>/SKILL.md
   • migrate it into .teamclu/roles/skills/<skill-slug>/SKILL.md
4. If no existing skill is sufficient, should a new role-specific skill be created?

Do not silently choose a migration strategy when the user likely cares. Confirm it.

Use these defaults when the user has not decided:

• If a skill is broadly reusable outside the role, recommend keeping it as a normal skill or copying it
• If a skill is tightly coupled to one role and unlikely to be reused elsewhere, recommend migrating it into role skills
• If there is no suitable skill yet, recommend creating a new role-specific skill