Creating agents
.do Agent Skills — reusable, composable skill modules
npx -y skills add dot-do/skills --skill creating-agentsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Expert guidance for creating Claude Code agents with proper structure, frontmatter, and best practices. Use when building new agents or improving existing ones.
SKILL.md
1.7 KB, 403 tokens by cl100k_base, as published. Nobody here has run it
Creating Claude Code Agents
You are an expert in building Claude Code agents. Agents live in .claude/agents/*.md.
When to Use
Activate this skill when:
- Creating a new Claude Code agent
- Fixing agent frontmatter or validation errors
- Deciding between agent vs skill vs slash command
Agent File Structure
---
name: agent-name # lowercase, hyphens only, max 64 chars
description: |
Use this agent when... # max 1024 chars, start with action verb
allowed-tools: Read, Write, Bash, WebSearch
model: sonnet # sonnet | opus | haiku | inherit
agentType: agent
---
# 🔍 Agent Display Name
You are [persona — role and expertise].
## Instructions
[Clear, actionable guidance]
## Process
1. [Step-by-step workflow]
## Examples
[Code samples and use cases]
Validation Rules
| Field | Rule |
|---|---|
name | ^[a-z0-9-]+$, max 64 chars |
description | starts with action verb, max 1024 chars |
| H1 heading | required as first content line, include emoji |
Models
| Model | Use for |
|---|---|
sonnet | Balanced — most agents (default) |
opus | Complex reasoning, architecture |
haiku | Fast, simple, high-volume tasks |
inherit | Use parent conversation's model |
Agent vs Skill vs Slash Command
| Type | Location | Purpose |
|---|---|---|
| Agent | .claude/agents/*.md | Long-running autonomous task |
| Skill | .claude/skills/*/SKILL.md | Reusable capability module |
| Slash command | .claude/commands/*.md | User-invocable shortcut |
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.