Agent skill

Agent Creator

by softspark in softspark/ai-toolkit

Creates new specialized agents with frontmatter, tools, delegation.

Apache-2.0Auto-check: notesAI & LLM Engineering

Install Agent Creator

skills CLI
$ npx skills add softspark/ai-toolkit --skill agent-creator -a claude-code

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

GitHub CLI
$ gh skill install softspark/ai-toolkit agent-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/softspark/ai-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/app/skills/agent-creator .claude/skills/agent-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
agent-creator
GitHub stars
179
Token cost
~1.3k tokens
SKILL.md length
583 words
Files
1
Skills in repo
112
Repo updated
First seen
Licence
Apache-2.0

At a glance

Creates new specialized agents with frontmatter, tools, delegation.

  • Works in 7 steps: Capture role -- what problem space… → Define triggers -- which keywords or… → Choose tools -- minimal tool set, least… → …
  • Tasks that involve Building AI agents
  • SKILL.md covers Workflow, Required Frontmatter, Authoring Rules and Agent Skeleton, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agent Creator is an agent skill from softspark/ai-toolkit. Creates new specialized agents with frontmatter, tools, delegation. Triggers: new agent, create agent, agent scaffold, specialized agent.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Building AI agents. The repository describes itself as: Professional-grade AI coding toolkit: 94 skills, 44 agents, multi-platform (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Antigravity, Codex CLI… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Building AI agents

Example prompts

  • “Use the agent-creator skill to create new specialized agents with frontmatter, tools, delegation”
  • “/agent-creator”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Grep, Glob

Workflow steps

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

  1. Capture role -- what problem space should the agent own?
  2. Define triggers -- which keywords or task types should route to this agent?
  3. Choose tools -- minimal tool set, least privilege first
  4. Choose model -- preserve the approved tier or inherit the parent selection; verify available models and effort controls in the target client
  5. Map supporting skills -- which knowledge skills should the agent reference?
  6. Write instructions -- capabilities, constraints, escalation rules, deliverables
  7. Validate -- frontmatter, naming, skills references, tool whitelist

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml and markdown).

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

  • Network

    No URLs in SKILL.md.

    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

Agent Creator loads about 1.3k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 583 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Grep, Glob

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from softspark/ai-toolkit at commit d64db2b, republished under its Apache-2.0 licence (© softspark). 583 words, ~1,309 tokens.

Download SKILL.mdSave it as .claude/skills/agent-creator/SKILL.md (or your agent's skills folder).
name
agent-creator
description
Creates new specialized agents with frontmatter, tools, delegation. Triggers: new agent, create agent, agent scaffold, specialized agent.
allowed-tools
Read, Write, Edit, Bash, Grep, Glob
effort
high
disable-model-invocation
true
argument-hint
[agent name or role]

Agent Creator

$ARGUMENTS

<!-- CLAUDE_CODE_ONLY_START -->

Only in Claude Code, apply the model-routing-patterns skill when choosing executors or creating agent definitions. Delegate to codex:codex-rescue only when its plugin is installed, enabled and callable in this session. Otherwise use the installed native agents and their configured models. A context without the Agent tool returns the dispatch decision to its supervisor; it does not invent a tool or bypass the client. Preserve explicit user choices and verify actual completion before accepting a delegated result.

<!-- CLAUDE_CODE_ONLY_END -->

Create a new specialized agent following ai-toolkit conventions.

Workflow

  1. Capture role -- what problem space should the agent own?
  2. Define triggers -- which keywords or task types should route to this agent?
  3. Choose tools -- minimal tool set, least privilege first
  4. Choose model -- preserve the approved tier or inherit the parent selection; verify available models and effort controls in the target client
  5. Map supporting skills -- which knowledge skills should the agent reference?
  6. Write instructions -- capabilities, constraints, escalation rules, deliverables
  7. Validate -- frontmatter, naming, skills references, tool whitelist

Required Frontmatter

yaml
---
name: agent-name
description: "When to use this agent. Triggers: keyword1, keyword2."
tools: Read, Write, Edit
model: inherit
skills: skill-one, skill-two
---

Authoring Rules

  • MUST match filename and name: using lowercase-hyphen format — drift breaks routing
  • MUST include an explicit Triggers: list in the description so the router can dispatch deterministically
  • NEVER reference skills that do not exist — either create the dependency first or drop the reference
  • NEVER grant write access to .claude/agents/ — that authority belongs to meta-architect alone
  • CRITICAL: avoid tool bloat. Every extra tool widens blast radius; start from Read and justify additions one by one
  • Give the agent a clear boundary: what it owns and what it must escalate
  • Prefer specialized, narrow responsibility over generic "do everything" agents
  • inherit and Claude aliases are Claude Code choices, not cross-provider IDs. An explicit tier needs a workload reason and an approved budget. Verify the provider's current alias resolution instead of assuming a fixed model version. Codex and Copilot generators preserve the host's selection unless a native configuration explicitly overrides it; do not copy Claude model/effort fields.

Agent Skeleton

markdown
---
name: {agent-name}
description: "When to use this agent. Triggers: keyword1, keyword2."
tools: Read, Edit
model: inherit
skills: relevant-skill
---

You are a specialized agent for {domain}.

## Responsibilities
- Responsibility one
- Responsibility two

## Constraints
- Do not edit files outside owned scope unless required
- Escalate security, data-loss, or architecture risks

## Deliverables
- Clear findings
- Specific edits or recommendations
- Validation notes

Validation Checklist

  • Filename matches name: in frontmatter
  • Description includes trigger words and use cases
  • Tools are from the approved Claude Code tool set
  • Referenced skills exist
  • Model choice and supported effort match the approved workload and client
  • scripts/validate.py passes after adding the agent
Show full SKILL.md (213 more words)Show less

Gotchas

  • The description is the only content the model sees at routing time (progressive disclosure, tier 1). Adding triggers to the body without putting them in description means the agent is invisible to the router.
  • tools: parser acceptance varies between Claude Code, ai-toolkit adapters, and downstream consumers — some accept comma-separated, some space-separated, some YAML lists. Stick to one style consistent with neighbouring agents in the repo and let scripts/validate.py catch drift.
  • Agent name is capped at 64 chars; some consumers silently truncate longer names, which then fail to match the filename at load time. Keep names short and unambiguous.
  • skills: can reference skills inside plugin packs; if the user has not enabled that pack, the agent fails on first invocation with an opaque "skill not found" error. Either reference only in-tree skills, or document the plugin prerequisite in the agent body.

When NOT to Use

  • For a skill (slash command or knowledge doc) — use /skill-creator instead
  • For a slash command that is not an agent delegate — use /command-creator
  • For a plugin pack bundling multiple agents and skills — use /plugin-creator
  • To modify an existing agent — delegate to the meta-architect agent; this skill is create-only
  • When the task is really a workflow (orchestrator + N specialists) — reach for /orchestrate or /workflow before minting a new agent

© softspark, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in app/skills/agent-creator of softspark/ai-toolkit.

Open the folder on GitHubat commit d64db2b

Compare with similar skills

Agent 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.

Agent Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Creator this skillsoftspark/ai-toolkit179—~1.3kAutomated safety check: NotesApache-2.0
Agent BuildershareAI-lab/learn-claude-code78k6 repos~1.2kAutomated safety check: PassMIT
Azure AI Projects Python SDKmicrosoft/skills3.1k6 repos~2.8kAutomated safety check: PassMIT
Paperclip Create Agentpaperclipai/paperclip98k1 repos~2.1kAutomated safety check: PassMIT
Senior Prompt Engineermaslennikov-ig/claude-code-orchestrator-kit2594 repos~1.4kAutomated safety check: PassCustom licence
Create Agentgnekt/My-Brain-Is-Full-Crew3.9k—~3.1kAutomated safety check: PassCustom licence

Similar skills

  • Agent Builder

    shareAI-lab/learn-claude-code

    Design and build AI agents for any domain. An agent skill from shareAI-lab/learn-claude-code.

    78k GitHub starsUsed in 6 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Reference for building on Microsoft Foundry with the azure-ai-projects Python SDK: project clients, versioned agents, evaluations, connections, datasets and indexes.

    3.1k GitHub starsUsed in 6 repos~2.8k tokens
    AI & LLM EngineeringAuto-check passed
  • Paperclip Create Agent

    paperclipai/paperclip

    Create new agents in Paperclip with governance-aware hiring.

    98k GitHub starsUsed in 1 repo~2.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Senior Prompt Engineer

    maslennikov-ig/claude-code-orchestrator-kit

    Provides reference guides and Python scripts for prompt optimization, RAG evaluation, and agent orchestration when building or tuning LLM systems.

    259 GitHub starsUsed in 4 repos~1.4k tokens
    AI & LLM EngineeringAuto-check passed
  • Create Agent

    gnekt/My-Brain-Is-Full-Crew

    Create a new custom agent from scratch. An agent skill from gnekt/My-Brain-Is-Full-Crew.

    3.9k GitHub stars~3.1k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Ms Agent Framework RAG

    shuyu-labs/WebCode

    Comprehensive guide for building Agentic RAG systems using Microsoft Agent Framework in C.

    278 GitHub stars~1.1k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed

More from softspark/ai-toolkit

All 112 skills in this repo
  • Prepare Test Env

    softspark/ai-toolkit

    Prepare or verify a project QA environment with source identity, readiness, browser access, evidence paths and owned cleanup.

    179 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check: notes
  • A11y Validate

    softspark/ai-toolkit

    Accessibility validator: WCAG 2.1 AA, EN 301 549, EAA. An agent skill from softspark/ai-toolkit.

    179 GitHub stars~3.8k tokensUpdated yesterday
    Auto-check: notes
  • Analyze

    softspark/ai-toolkit

    Analyzes code quality, complexity, patterns across codebase.

    179 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Autonomous Dev

    softspark/ai-toolkit

    Drives a brief, specification, issue or existing PR through implementation, review, tests and QA to a ready PR.

    179 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check: notes
  • Brand Voice

    softspark/ai-toolkit

    Direct technical voice for docs, README, user-facing text. An agent skill from softspark/ai-toolkit.

    179 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • CI

    softspark/ai-toolkit

    Detect/generate/debug CI pipeline config (GitHub Actions, GitLab CI).

    179 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check: notes

Questions about Agent Creator

What does Agent Creator do?

Creates new specialized agents with frontmatter, tools, delegation. Agent Creator is an agent skill from softspark/ai-toolkit. Creates new specialized agents with frontmatter, tools, delegation.

When should I use Agent Creator?

Agent Creator fits situations like: tasks that involve Building AI agents.

How do I install Agent Creator in Claude Code?

Run `npx skills add softspark/ai-toolkit --skill agent-creator -a claude-code`. Or copy the skill folder (app/skills/agent-creator in softspark/ai-toolkit) into .claude/skills/agent-creator in your project. Claude Code loads it when a task matches its description.

How do I install Agent Creator in Codex?

Run `npx skills add softspark/ai-toolkit --skill agent-creator -a codex`. Or copy the skill folder (app/skills/agent-creator in softspark/ai-toolkit) into .agents/skills/agent-creator in your project. Codex loads it when a task matches its description.

Can I use Agent 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 softspark/ai-toolkit --skill agent-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/agent-creator, .gemini/skills/agent-creator, .github/skills/agent-creator and .opencode/skills/agent-creator in your project.

What does Agent Creator need to run?

SKILL.md names no scripts, command-line tools or credentials: Agent Creator is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Grep, Glob.

Does Agent Creator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Agent Creator safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Agent Creator use?

Agent Creator is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agent Creator use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Agent Creator?

Skills that share tags, products or a category with Agent Creator: Agent Builder (shareAI-lab/learn-claude-code, 78k stars), Azure AI Projects Python SDK (microsoft/skills, 3.1k stars), Paperclip Create Agent (paperclipai/paperclip, 98k stars) and Senior Prompt Engineer (maslennikov-ig/claude-code-orchestrator-kit, 259 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agent Creator?

softspark (a GitHub user) maintains it in softspark/ai-toolkit, which has 179 GitHub stars. The repository holds 112 skills in this directory. The repository was last updated on October 7, 2026.

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