configure-roles

Detect environment and generate role-based preamble templates for Thrum agents.

28|5|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/leonletto/thrum --skill configure-roles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configure-roles
Source: https://github.com/leonletto/thrum/tree/main/opencode-plugin/assets/skills/configure-roles
Command: npx skills add https://github.com/leonletto/thrum --skill configure-roles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detect environment and generate customized role-based preamble templates for your Thrum agents. Creates .thrum/role_templates/ files that auto-apply on agent registration.

Core Features & Use Cases

  • Detect environment and tailor preamble templates to the project
  • Generate and store templates at .thrum/role_templates/ for automatic application during agent registration
  • Support multiple roles and autonomy levels across worktrees and MCP/beads contexts

Quick Start

Run thrum configure-roles to detect your environment and generate role-based preamble templates.

Frequently Asked Questions about configure-roles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate role-based preamble templates for Thrum agents?

Role-based preamble templates for Thrum agents are generated by running thrum configure-roles, which detects your environment and stores customized templates under .thrum/role_templates/ for automatic application during agent registration.

What are role templates in a Thrum worktree and when do I need them?

Role templates in a Thrum worktree are customized preamble files that guide agent onboarding and ensure consistent behavior. You need them when registering agents across MCP and beads configurations to maintain uniform autonomy levels.

Can I use configure-roles to support different autonomy levels for MCP and beads?

Yes, configure-roles supports multiple roles and accommodates different autonomy levels across worktrees and MCP/beads contexts by reading environment state and writing tailored templates to the appropriate role files.

What is the best way to auto-apply role templates during agent registration?

The best way to auto-apply role templates during agent registration is to generate them beforehand with thrum configure-roles, which stores the results in .thrum/role_templates/ for automatic application.

Does Thrum configure-roles require any external dependencies to detect the environment?

No external dependencies are required to detect the environment and generate role-based preamble templates, as the Skill operates independently to read environment state and write template files to .thrum/role_templates/.

Why are my Thrum agent role templates not applying correctly across worktrees?

Role templates may not apply correctly if the environment detection fails or templates are missing from .thrum/role_templates/, which should be generated by running thrum configure-roles before agent registration.