Agent skill

Role Creator

by aiskillstore in aiskillstore/marketplace

Create and update Codex custom agents using standalone custom-agent TOML files.

No licenceAuto-check passed

Install Role Creator

skills CLI
$ npx skills add aiskillstore/marketplace --skill role-creator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aiskillstore/marketplace role-creator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aiskillstore/marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/am-will/role-creator .claude/skills/role-creator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
role-creator
GitHub stars
430
Token cost
~970 tokens
SKILL.md length
305 words
Files
10 (incl. scripts, references)
Skills in repo
1,044
Repo updated
First seen
Licence
None found

At a glance

Create and update Codex custom agents using standalone custom-agent TOML files.

  • Works in 5 steps: Collect and confirm required inputs. → Resolve output path → Create or update the file directly with… → …
  • SKILL.md covers Overview, Non-Negotiable Inputs, Role file contract (current) and Default policy for optional…, plus 4 more sections
  • Runs Shell scripts from its folder; reaches developers.openai.com

What it does

Role Creator is an agent skill from aiskillstore/marketplace. Create and update Codex custom agents using standalone custom-agent TOML files.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts and reference files (for example `references/role-config-reference.md`, `scripts/install_role.sh` and `scripts/validate_role.sh`).

The repository describes itself as: Security-audited skills for Claude, Codex & Claude Code. One-click install, quality verified.

Example prompts

  • “/role-creator”

Requirements

  • A Bash shell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Collect and confirm required inputs.
  2. Resolve output path
  3. Create or update the file directly with required keys.
  4. Validate TOML parse and required keys.
  5. Return a ready-to-run example call

What it can do on your machine

Read from SKILL.md and the folder at commit 755bc35. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • developers.openai.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Role Creator loads about 970 tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 23 tokens; SKILL.md has 305 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~970
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 305 words (~970 tokens).

“Use this skill to author, update, or troubleshoot custom Codex agents as standalone TOML files.”

— opening of SKILL.md by aiskillstore
name
role-creator

Read the full SKILL.md on GitHub

Files

SKILL.md and 9 other files (scripts, references) in skills/am-will/role-creator of aiskillstore/marketplace.

  • SKILL.md
  • references/role-config-reference.md
  • scripts/install_role.sh
  • scripts/validate_role.sh
  • scripts/write_role_config.sh
  • skill-report.json
  • templates/frontend-architecture-role.toml
  • templates/full-role-config.toml
  • templates/minimal-role-config.toml
  • templates/restricted-role-config.toml

Open the folder on GitHubat commit 755bc35

Compare with similar skills

Role Creator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Role Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Role Creator this skillaiskillstore/marketplace430—~970Automated safety check: PassNone
Ansible Role Creatorjeremylongshore/tons-of-skills-marketplace2.8k—~567Automated safety check: PassMIT
Developing StandaloneTriliumNext/Trilium38k—~3.4kAutomated safety check: PassAGPL-3.0
Aria Rolesthedaviddias/Front-End-Checklist74k—~515Automated safety check: PassMIT
Skill Creatoropenclaw/openclaw392k—~576Automated safety check: PassApache-2.0
Azure Role Selectorgithub/awesome-copilot40k2 repos~246Automated safety check: PassMIT

Similar skills

  • Ansible Role Creator

    jeremylongshore/tons-of-skills-marketplace

    Create ansible role creator operations. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~567 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Developing Standalone

    TriliumNext/Trilium

    A skill your agent uses when working on Trilium's standalone in-browser build (apps/standalone, deployed at app.triliumnotes.org and embedded by the mobile app) — the service worker (sw.ts), the…

    38k GitHub stars~3.4k tokensUpdated today
    DatabasesAuto-check passed
  • Aria Roles

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Use valid ARIA role values.

    74k GitHub stars~515 tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed
  • Skill Creator

    openclaw/openclaw

    Author or review AgentSkills: create, repair, validate, or restructure SKILL.md files and bundled resources.

    392k GitHub stars~576 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Azure Role Selector

    github/awesome-copilot

    Official

    When user is asking for guidance for which role to assign to an identity given desired permissions, this agent helps them understand the role that will meet the requirements with least privilege…

    40k GitHub starsUsed in 2 repos~246 tokens
    DevOps & CloudAuto-check passed
  • Content Creator

    alirezarezvani/claude-skills

    Deprecated redirect skill that routes legacy 'content creator' requests to the correct specialist.

    28k GitHub starsUsed in 1 repo~713 tokens
    Writing & ContentAuto-check passed

More from aiskillstore/marketplace

All 1,044 skills in this repo
  • Code Stats

    aiskillstore/marketplace

    Analyze codebase with tokei (fast line counts by language) and difft (semantic AST-aware diffs).

    430 GitHub starsUsed in 1 repo~697 tokens
    Auto-check: notes
  • Data Processing

    aiskillstore/marketplace

    Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~720 tokens
    Auto-check: notes
  • Doc Scanner

    aiskillstore/marketplace

    Scans for project documentation files (AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, CURSOR.md, WARP.md, and 15+ other formats) and synthesizes guidance.

    430 GitHub starsUsed in 1 repo~644 tokens
    Auto-check: notes
  • File Search

    aiskillstore/marketplace

    Modern file and content search using fd, ripgrep (rg), and fzf.

    430 GitHub starsUsed in 1 repo~598 tokens
    Auto-check: notes
  • Find Replace

    aiskillstore/marketplace

    Modern find-and-replace using sd (simpler than sed) and batch replacement patterns.

    430 GitHub starsUsed in 1 repo~527 tokens
    Auto-check: notes
  • Project Planner

    aiskillstore/marketplace

    Detects stale project plans and suggests session commands. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~504 tokens
    Auto-check passed

Questions about Role Creator

What does Role Creator do?

Create and update Codex custom agents using standalone custom-agent TOML files. Role Creator is an agent skill from aiskillstore/marketplace. Create and update Codex custom agents using standalone custom-agent TOML files.

How do I install Role Creator in Claude Code?

Run `npx skills add aiskillstore/marketplace --skill role-creator -a claude-code`. Or copy the skill folder (skills/am-will/role-creator in aiskillstore/marketplace) into .claude/skills/role-creator in your project. Claude Code loads it when a task matches its description.

How do I install Role Creator in Codex?

Run `npx skills add aiskillstore/marketplace --skill role-creator -a codex`. Or copy the skill folder (skills/am-will/role-creator in aiskillstore/marketplace) into .agents/skills/role-creator in your project. Codex loads it when a task matches its description.

Can I use Role Creator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aiskillstore/marketplace --skill role-creator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/role-creator, .gemini/skills/role-creator, .github/skills/role-creator and .opencode/skills/role-creator in your project.

What does Role Creator need to run?

Going by SKILL.md and its folder, Role Creator needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Role Creator access the network?

SKILL.md names 1 domain. In commands or code: developers.openai.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Role Creator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Role Creator use?

No licence was found for Role Creator or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Role Creator use?

About 970 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 828 tokens, read only when the agent opens those files.

What are the alternatives to Role Creator?

Skills that share tags, products or a category with Role Creator: Ansible Role Creator (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Developing Standalone (TriliumNext/Trilium, 38k stars), Aria Roles (thedaviddias/Front-End-Checklist, 74k stars) and Skill Creator (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Role Creator?

aiskillstore (a GitHub organization) maintains it in aiskillstore/marketplace, which has 430 GitHub stars. The repository holds 1,044 skills in this directory. The repository was last updated on October 9, 2026.

Source: aiskillstore/marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.