Agent skill · writing content · aiskillstore
creating-claude-agents
Use when creating or improving Claude Code agents. Expert guidance on agent file structure, frontmatter, persona definition, tool access, model selection, and validation against schema.
Why this skill is useful
Provides specific guidance on agent file structure, validation rules, and best practices that the AI wouldn't reliably generate on its own.
What it needs
About 9k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Creating Claude Code Agents - Expert Skill Use this skill when creating or improving Claude Code agents. Provides comprehensive guidance on agent structure, schema validation, and best practices for building long-running AI assistants. When to Use This Skill Activate this skill when: User asks to create a new Claude Code agent User wants to improve an existing agent User needs help with agent frontmatter or structure User is troubleshooting agent validation issues User wants to understand agent format requirements User asks about agent vs skill vs slash command differences Quick Reference Agent File Structure File Location Required Path: Agents must be placed in .claude/agents/ directory as markdown files. Frontmatter Requirements Required Fields Field Type Description Example ------------- ------ --------------------------------------------- ------------------------------------------------------ name string Agent identifier (lowercase, hyphens only) code-reviewer description string Brief overview of functionality and use cases Reviews code for best practices and potential issues Optional Fields Field Type Description Values --------------- ------ --------------------------------------- ------------------------------------ allowed-tools string Comma-separated list of available tools Read, Write, Bash, WebSearch model string Claude model to use sonnet, opus, haiku, inherit agentType string Explicit marker for format preservation agent Validation Rules Name Field: Pattern: ^[a-z0-9-]+$ (lowercase letters, numbers, hyphens only) Max length: 64 characters Example: ✅ code-reviewer ❌ CodeReviewer Description Field: Max length: 1024 characters Should clearly explain when to use the agent Start with action words: "Reviews...", "Analyzes...", "Helps with..." Allowed Tools: Valid tools: Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch, Task, Skill, SlashCommand, TodoWrite, AskUserQuestion Model Values: sonnet - Balanced, good for most agents (default) opus - Complex r …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/creating-claude-agents