thrum-configure-roles

Generate and update Codex role templates in .thrum/role_templates/ for the project environment.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates environment-aware generation and updating of Codex agent role templates for Thrum, reducing setup time and ensuring consistent autonomy boundaries across projects.

Core Features & Use Cases

  • Detects project environment and existing role templates.
  • Generates and updates .thrum/role_templates/ with Codex-friendly role definitions.
  • Guides rollout and deployment once agents are registered, ensuring consistency.

Quick Start

Run thrum quickstart to generate and apply Codex-specific role templates for your repository.

Frequently Asked Questions about thrum-configure-roles

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

FAQPage Schema
How do I generate Codex agent role templates for a Thrum project?

To generate Codex agent role templates, run the Thrum quickstart command to detect your project environment and automatically create tailored role definitions in the .thrum/role_templates/ directory.

What are Codex-ready role templates and when do I need them?

Codex-ready role templates are configuration files that define autonomy boundaries for Codex agents within a Thrum project. You need them to ensure consistent agent behavior and reduce setup time across different repositories.

Can I update existing role templates to match my repo's current worktree rules?

Yes, you can update existing role templates. The tool identifies current project environment configurations and existing templates to determine needs, then updates the .thrum/role_templates/ files to align with your repo's worktree rules.

Does Thrum validate generated role templates before agent registration?

Yes, Thrum validates generated templates to ensure they are correctly formatted for Codex integration. It also provides deployment guidance to help you roll out the agents consistently once they are registered.

How do I ensure consistent autonomy boundaries across multiple Thrum projects?

To ensure consistent autonomy boundaries, use environment-aware template generation. The tool detects each project's specific tools and rules to generate tailored role definitions, maintaining consistency across your repositories.