📦

role-creator

Name: role-creator
Author: am-will

Riesgo bajo 📁 Acceso al sistema de archivos

Crear Roles de Agente Codex Personalizados

Esta habilidad ayuda a los usuarios a crear, instalar y validar roles de agente personalizados para Codex/Claude Code generando archivos de configuración correctamente estructurados y registrándolos en la configuración principal.

Soporta: Claude Codex Code(CC)

🥈 79 Plata

Descargar el ZIP de la skill

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

Activa y empieza a usar

Pruébalo

Usando "role-creator". Create a researcher role

Resultado esperado:

Installed role 'researcher' in ~/.codex/config.toml
Role config file: ~/.codex/agents/researcher.toml
Backup created at: ~/.codex/config.toml.bak.20240315123045

Configured now: model, model_reasoning_effort, developer_instructions

Spawn example: {"agent_type":"researcher","message":"Find all uses of the auth function"}

Usando "role-creator". Validate role configuration

Resultado esperado:

Role validation passed for 'researcher'.
- [agents.researcher] declaration: valid
- Required keys present: model, model_reasoning_effort, developer_instructions
- Top-level keys: validated against schema

Auditoría de seguridad

Riesgo bajo

v1 • 3/6/2026

All 225 static findings are false positives. The skill performs legitimate Codex configuration management. Shell command substitutions use parameterized queries with trusted CLI tools (tomlq, jq). Filesystem access is limited to the standard ~/.codex/config.toml location. The flagged 'cryptographic algorithm' patterns are actually Codex config values (reasoning effort levels). No actual security risks identified.

Archivos escaneados

803

Líneas analizadas

hallazgos

Auditorías totales

Factores de riesgo

📁 Acceso al sistema de archivos (1)

SKILL.md:12-16

Auditado por: claude

Puntuación de calidad

Arquitectura

100

Mantenibilidad

Contenido

Comunidad

Seguridad

Cumplimiento de la especificación

Lo que puedes crear

Crear un Subagente de Investigación

Configurar un rol de investigador de solo lectura que pueda analizar código y documentación sin realizar cambios

Construir un Agente de Revisión de Código

Crear un agente revisor de código dedicado con pautas específicas para retroalimentación y análisis

Configurar Roles de Sandbox Restringidos

Crear roles de agente en sandbox con acceso limitado al sistema de archivos para experimentación segura

Prueba estos prompts

Creación Básica de Roles

Use the role-creator skill to create a new Codex role called 'researcher' with model gpt-5.3-codex, reasoning effort medium, and developer instructions for reading code only. Install it globally.

Rol Restringido con Sandbox

Create a sandboxed code writer role using role-creator. Use model gpt-5.3-codex, high reasoning, and set sandbox_mode to workspace-write with network_access false.

Rol a Nivel de Proyecto

Use role-creator to add a 'frontend-specialist' role to my current project's .codex/config.toml. Use the full-role-config.toml template as a base and customize for React development.

Actualizar Rol Existente

Update the existing 'reviewer' role in my global Codex config to use higher reasoning effort and new developer instructions for security-focused reviews.

Mejores prácticas

Comienza con configuraciones de roles mínimas y solo agrega parámetros opcionales cuando sea necesario
Siempre valida los roles contra el esquema de Codex antes de reportar éxito a los usuarios
Usa roles a nivel de proyecto para configuraciones compartidas del equipo y roles globales para preferencias personales

Evitar

Establecer permisos de sandbox sin solicitud explícita del usuario - esto otorga privilegios elevados por defecto
Omitir la validación - siempre verifica las configuraciones de roles contra el esquema oficial
Crear roles con instrucciones de desarrollador vagas - sé específico sobre el alcance y los límites

Preguntas frecuentes

¿Cuál es la diferencia entre roles globales y roles a nivel de proyecto?

Los roles globales se instalan en ~/.codex/config.toml y están disponibles en todos los proyectos. Los roles a nivel de proyecto van en .codex/config.toml dentro de un proyecto específico y solo funcionan dentro del contexto de ese proyecto.

¿Puedo usar esta habilidad con Claude Code en lugar de Codex?

Esta habilidad está diseñada para Codex pero los patrones de configuración son similares. Claude Code usa una estructura de configuración diferente, por lo que algunas características pueden no aplicarse.

¿Cómo habilito los servidores MCP en mi rol?

Usa las banderas --mcp-enable o --mcp-disable, o comienza desde una plantilla en la carpeta templates/ y agrega manualmente tu configuración de servidor MCP.

¿Qué sucede si intento crear un rol que ya existe?

El instalador rechazará la operación a menos que passes la bandera --update-existing. Esto previene sobrescrituras accidentales de configuraciones de roles existentes.

¿Necesito instalar Codex para usar esta habilidad?

Sí, esta habilidad gestiona archivos de configuración de Codex. Sin Codex instalado, los archivos de configuración se crearían pero no podrían ser validados contra el esquema.

¿Cómo creo un rol de investigación de solo lectura?

Usa la plantilla mínima o especifica sandbox_mode = read-only en tu configuración de rol. Esto previene que el agente realize cambios en el sistema de archivos.