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.

492 stars 68 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add cosmicstack-labs/mercury-agent-skills --skill ai-agent-design
Manual install
git 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-design

Personal 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 |
Read the full skill on GitHub

Details

Skill name
ai-agent-design
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

492

cosmicstack-labs/mercury-agent-skills

Achieve and maintain WCAG compliance through inclusive design practices, proper ARIA usage, and comprehensive testing methodologies.

Frontend & Design68

Accessibility Testing

492

cosmicstack-labs/mercury-agent-skills

WCAG 2.1/2.2 audit, axe, Lighthouse, manual testing, screen reader testing, and remediation

Testing & QA68

Agent Audit Logging

492

cosmicstack-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.

AI, LLMs & Agents68

Before You Build

492

cosmicstack-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.

AI, LLMs & Agents68

Agent Task Delegation

492

cosmicstack-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.

AI, LLMs & Agents68

Error Recovery Retry

492

cosmicstack-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.

AI, LLMs & Agents68

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.