agent-creator

Author Claude Code subagent markdown definitions with YAML frontmatter and delegation triggers.

3|Updated May 11, 2026
One-click install
npx skills add https://github.com/anilcancakir/claude-code --skill agent-creator-anilcancakir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-creator
Source: https://github.com/anilcancakir/claude-code/tree/main/plugins/ac/skills/agent-creator
Command: npx skills add https://github.com/anilcancakir/claude-code --skill agent-creator-anilcancakir

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines authoring custom Claude Code subagents by providing a complete, correct playbook for producing a well-structured agent definition that reliably triggers, has the right tool permissions, and returns output in a predictable shape.

Core Features & Use Cases

  • Agent definitions that actually work: Guides you to set the minimal frontmatter (name, description) plus optional capabilities like tools, model/effort, memory, skills preloading, and isolation.
  • Tool restriction and safety alignment: Helps you choose allowlists/denylists and understand how permission mode interacts with tool access so the agent can’t do the wrong thing.
  • Correct agent body structure: Teaches the five-section system-prompt format (Identity, Execution, Output Format, Failure Conditions, Constraints) so downstream orchestration can parse results.
  • Scoping and storage routing: Covers where the agent should live (project, user, or plugin distribution) and what that implies for sharing and security boundaries.
  • Debugging under-triggering and shape errors: Provides a decision flow and failure-mode guidance for agents that fail to fire or return the wrong output shape.

Quick Start

Use the agent-creator skill to design a new subagent when you need an isolated worker to handle a recurring task, such as creating or editing a custom subagent under .claude/agents/ with the correct tool restrictions, model/effort, and a locked output format.

Frequently Asked Questions about agent-creator

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

FAQPage Schema
How do I create a custom Claude Code subagent with the correct tool permissions?

A custom subagent requires a markdown definition with YAML frontmatter fields like name and description, plus tool allowlists or denylists to enforce permission mode restrictions and prevent unauthorized actions.

Why does my custom subagent fail to trigger during orchestrator delegation?

Under-triggering in subagent delegation typically occurs when the description field lacks specific keywords. Debug the delegation triggers by refining the description to match the exact vocabulary the orchestrator uses when routing tasks.

What structure should a system prompt body have for a custom subagent?

A subagent system prompt body should follow a five-section structure: Identity, Execution, Output Format, Failure Conditions, and Constraints. This ensures downstream orchestration can parse results and handle errors predictably.

How do I configure model effort and memory preloading for Claude Code agents?

Configure model effort and memory preloading by setting optional capabilities in the agent's YAML frontmatter. This allows the subagent to load specific skills and memory context when initialized by the orchestrator.

Where should I store custom subagents for project isolation and sharing?

Store custom subagents based on their required security boundary: project-level for local isolation, user-level for personal reuse, or plugin distribution for sharing. Scoping determines access and sharing boundaries.

How do I fix incorrect output shape errors from a delegated worker agent?

Incorrect output shape errors occur when the system prompt lacks a locked output format. Fix this by enforcing the Output Format section in the agent body and adding constraint gates to ensure parseable results.