📦

role-creator

Name: role-creator
Author: am-will

Risque faible 📁 Accès au système de fichiers

Créer des rôles d'agent Codex personnalisés

Cette compétence aide les utilisateurs à créer, installer et valider des rôles d'agent personnalisés pour Codex/Claude Code en générant des fichiers de configuration correctement structurés et en les enregistrant dans la configuration principale.

Prend en charge: Claude Codex Code(CC)

🥉 74 Bronze

Télécharger le ZIP du skill

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

Activez et commencez à utiliser

Tester

Utilisation de "role-creator". Create a researcher role

Résultat attendu:

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"}

Utilisation de "role-creator". Validate role configuration

Résultat attendu:

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

Audit de sécurité

Risque faible

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.

Fichiers analysés

803

Lignes analysées

résultats

Total des audits

Facteurs de risque

📁 Accès au système de fichiers (1)

SKILL.md:12-16

Audité par: claude

Score de qualité

Architecture

100

Maintenabilité

Contenu

Communauté

Sécurité

Conformité aux spécifications

Ce que vous pouvez construire

Créer un sous-agent de recherche

Configurer un rôle de recherche en lecture seule capable d'analyser le code et la documentation sans apporter de modifications

Construire un agent de revue de code

Créer un agent de revue de code dédié avec des lignes directrices spécifiques pour les commentaires et l'analyse

Configurer des rôles sandbox restreints

Créer des rôles d'agent en sandbox avec un accès au système de fichiers limité pour une expérimentation sécurisée

Essayez ces prompts

Création de rôle basique

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.

Rôle restreint avec 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.

Rôle au niveau du projet

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.

Mettre à jour un rôle existant

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

Bonnes pratiques

Commencez par des configurations de rôle minimales et n'ajoutez des paramètres optionnels que lorsque c'est explicitement nécessaire
Validez toujours les rôles par rapport au Codex schéma avant de signaler le succès aux utilisateurs
Utilisez les rôles au niveau du projet pour les configurations partagées en équipe et les rôles globaux pour les préférences personnelles

Éviter

Définir les permissions sandbox sans demande explicite de l'utilisateur - cela accorde des privilèges élevés par défaut
Ignorer la validation - vérifiez toujours les configurations de rôle par rapport au schéma officiel
Créer des rôles avec des instructions développeur vagues - soyez précis concernant la portée et les limites

Foire aux questions

Quelle est la différence entre les rôles globaux et les rôles au niveau du projet ?

Les rôles globaux sont installés dans ~/.codex/config.toml et disponibles dans tous les projets. Les rôles au niveau du projet vont dans .codex/config.toml au sein d'un projet spécifique et ne fonctionnent que dans le contexte de ce projet.

Puis-je utiliser cette compétence avec Claude Code au lieu de Codex ?

Cette compétence est conçue pour Codex mais les motifs de configuration sont similaires. Claude Code utilise une structure de configuration différente, donc certaines fonctionnalités peuvent ne pas s'appliquer.

Comment activer les serveurs MCP dans mon rôle ?

Utilisez les drapeaux --mcp-enable ou --mcp-disable, ou partez d'un modèle dans le dossier templates/ et ajoutez manuellement votre configuration de serveur MCP.

Que se passe-t-il si j'essaie de créer un rôle qui existe déjà ?

L'installateur rejettera l'opération sauf si vous passez le flag --update-existing. Cela empêche les écrasements accidentels des configurations de rôle existantes.

Dois-je installer Codex pour utiliser cette compétence ?

Oui, cette compétence gère les fichiers de configuration Codex. Sans Codex installé, les fichiers de configuration seraient créés mais ne pourraient pas être validés par rapport au schéma.

Comment créer un rôle de recherche en lecture seule ?

Utilisez le modèle minimal ou spécifiez sandbox_mode = read-only dans votre configuration de rôle. Cela empêche l'agent de faire des modifications système de fichiers.