agent-design
Design AI agents with recommended patterns and architectures
npx skills add majiayu000/claude-skill-registry --skill agent-design --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Agent Design Skill for designing high-performance AI agents following 2025 patterns. ## Documentation - [patterns.md](docs/patterns.md) - Multi-agent architecture patterns - [workflows.md](docs/workflows.md) - Recommended workflows ## Fundamental Distinction ### Workflows vs Agents | Type | Control | When to use | |------|---------|-------------| | **Workflow** | Code orchestrates LLM | Predictable tasks, need for control | | **Agent** | LLM directs its actions | Flexibility, adaptive decisions | **Golden rule:** Start simple, add complexity if necessary. ## Agent Architecture ### Minimal Structure ```yaml Agent: identity: Who am I? capabilities: What can I do? tools: What tools do I have? constraints: What are my limits? workflow: How should I proceed? ``` ### Complete Structure (Production) ```markdown --- name: my-agent description: Short description model: sonnet|opus tools: [list of tools] skills: [associated skills] --- # Identity [Who the agent is] # Capabilities [What it can do] # Workflow [Steps to follow] # Tools [How to use each tool] # Constraints [Limits and rules] # Examples [Use cases] # Forbidden [What it must NEVER do] ``` ## Agent Patterns ### 1. Single Agent (S
- Documentation
- Fundamental Distinction
- Workflows vs Agents
- Agent Architecture
- Minimal Structure
- Complete Structure (Production)
- Agent Patterns
- 1. Single Agent (Simple)
- 2. Agent + Tools
- 3. Orchestrator + Subagents
- 4. Sequential Pipeline
- Fresh Eyes Principle
- Design Checklist
- Before creating an agent
What does the agent-design skill do?
Design AI agents with recommended patterns and architectures
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agent-design --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.