AI Agent Design
Comprehensive guide to designing, building, and operating AI agents. Covers agent architecture, tool use patterns, memory systems, orchestration strategies, planning approaches, error recovery, and safety guardrails for production-grade agent systems.
Install
npx skills add cosmicstack-labs/mercury-agent-skills --skill ai-agent-designgit clone --depth 1 https://github.com/cosmicstack-labs/mercury-agent-skills.git /tmp/mercury-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/mercury-agent-skills/categories/ai-ml/ai-agent-design ~/.claude/skills/ai-agent-designPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# AI Agent Design ## Core Principles ### 1. Agents Are Tools, Not Teammates An AI agent is a system that uses an LLM to reason and take actions. It is not a person — it has no goals, desires, or understanding. Design agents as tools with clear boundaries, not as autonomous collaborators. ### 2. Autonomy is a Spectrum Full autonomy is rarely the goal. The best agents operate on a spectrum: more human oversight for critical actions, more autonomy for routine tasks. Design for the level of autonomy that matches the risk. ### 3. Cache Everything, Guess Nothing Agents have no memory between calls unless you design it. Every interaction, tool result, and decision must be explicitly stored and retrieved. Assume the agent remembers nothing unless you program it to. ### 4. Fail Predictably Every agent will fail. The question is how it fails. Design for graceful degradation: when uncertain, ask for help. When stuck, escalate. When broken, stop safely. ### 5. Safety First, Speed Second A fast agent that takes unauthorized actions is worse than a slow agent that double-checks. Build guardrails before building features. --- ## Agent Maturity Model | Level | Name | Characteristics | Tool Use | Memory | Autonomy | |-------|------|----------------|----------|--------|----------| | **L1** | Reactive | Single-turn, no context retention, deterministic responses | None or hardcoded | None | None |
Details
- Skill name
ai-agent-design- Repository
- cosmicstack-labs/mercury-agent-skills
- Path
categories/ai-ml/ai-agent-design/SKILL.md- License
- MIT
- Repo updated
- 25 August 2026
FAQ
What does the AI Agent Design skill do?
Comprehensive guide to designing, building, and operating AI agents. Covers agent architecture, tool use patterns, memory systems, orchestration strategies, planning approaches, error recovery, and safety guardrails for production-grade agent systems.
How do I install the AI Agent Design skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add cosmicstack-labs/mercury-agent-skills --skill ai-agent-design. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is AI Agent Design popular?
It lives in cosmicstack-labs/mercury-agent-skills, which has 492 GitHub stars and 68 forks.
Related skills
Accessibility
492cosmicstack-labs/mercury-agent-skills
Achieve and maintain WCAG compliance through inclusive design practices, proper ARIA usage, and comprehensive testing methodologies.
Accessibility Testing
492cosmicstack-labs/mercury-agent-skills
WCAG 2.1/2.2 audit, axe, Lighthouse, manual testing, screen reader testing, and remediation
Agent Audit Logging
492cosmicstack-labs/mercury-agent-skills
Implement comprehensive audit logging and reporting for multi-agent systems. Covers event capture, structured logging, traceability, compliance reporting, forensic analysis, and real-time monitoring dashboards for agent actions and decisions.
Before You Build
492cosmicstack-labs/mercury-agent-skills
Use this before implementing a product, feature, SaaS, AI app, or side project to score product risk and choose the smallest validation step.
Agent Task Delegation
492cosmicstack-labs/mercury-agent-skills
Design and operate task delegation systems for multi-agent fleets. Covers workload distribution, load balancing, queue management, priority scheduling, and dynamic agent scaling for production agent systems.
Error Recovery Retry
492cosmicstack-labs/mercury-agent-skills
Design robust error recovery, retry logic, and fallback strategies for production AI agents. Covers transient failure handling, circuit breakers, exponential backoff, state recovery, graceful degradation, and dead-letter queues for agent systems.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.