Agent Design Fundamentals

Decision rules for whether to build an LLM agent and how to architect it, distilled from OpenAI's "A Practical Guide to Building Agents": build/no-build criteria, model selection, tool design, single-agent vs multi-agent orchestration (manager pattern vs decentralized handoffs), layered guardrails, and human-in-the-loop triggers. Use when designing, reviewing, or refactoring an agent system — before choosing an architecture, adding more agents, defining tools, or shipping an agent to production without guardrails.

10 stars 2 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Archive228/lab-skills --skill agent-design-fundamentals
Manual install
git clone --depth 1 https://github.com/Archive228/lab-skills.git /tmp/lab-skills
mkdir -p ~/.claude/skills
cp -r /tmp/lab-skills/skills/agent-design-fundamentals ~/.claude/skills/agent-design-fundamentals

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Agent Design Fundamentals

Operating procedure for deciding whether a workflow needs an agent at all, and for architecting it if so: single-agent loop first, multi-agent only on measured failure; manager pattern vs decentralized handoffs; three tool types; layered guardrails; explicit human-intervention triggers. Distilled from OpenAI's 34-page "A Practical Guide to Building Agents" (April 2025).

## When to use

Use this skill when you are:
- Deciding whether a workflow should be an agent, a simpler LLM app, or deterministic code.
- Designing a new agent's architecture: model choice, tool set, instructions, orchestration.
- Deciding whether to split one agent into several, or which multi-agent pattern to use.
- Adding guardrails or human-in-the-loop escalation to an agent before production.

Do NOT use this skill for:
- Apps that merely integrate an LLM without letting it control workflow execution — simple chatbots, single-turn LLMs, sentiment classifiers. Per the source, these are not agents.
- Workflows that deterministic, rule-based automation already handles cleanly — the source says a deterministic solution may suffice; do not agentify them.

## Rules

**Gate: should this be an agent at all?**
Read the full skill on GitHub

Details

Skill name
agent-design-fundamentals
Path
skills/agent-design-fundamentals/SKILL.md
License
MIT
Repo updated
12 August 2026

FAQ

What does the Agent Design Fundamentals skill do?

Decision rules for whether to build an LLM agent and how to architect it, distilled from OpenAI's "A Practical Guide to Building Agents": build/no-build criteria, model selection, tool design, single-agent vs multi-agent orchestration (manager pattern vs decentralized handoffs), layered guardrails, and human-in-the-loop triggers. Use when designing, reviewing, or refactoring an agent system — before choosing an architecture, adding more agents, defining tools, or shipping an agent to production without guardrails.

How do I install the Agent Design Fundamentals skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add Archive228/lab-skills --skill agent-design-fundamentals. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Agent Design Fundamentals popular?

It lives in Archive228/lab-skills, which has 10 GitHub stars and 2 forks.

Related skills

Agent Evals

10

Archive228/lab-skills

Build and maintain evaluation suites for AI agents: bootstrap 20-50 tasks from real failures, pick code-based vs model-based vs human graders by agent architecture (coding, conversational, research, computer-use), write unambiguous tasks with reference solutions, and keep suites alive via ownership and transcript reading. Use when creating evals from zero, adding graders or eval cases, debugging suspicious eval scores, or deciding pass@k vs pass^k metrics for an agent product.

AI, LLMs & Agents

Agent Failure Preflight

10

Archive228/lab-skills

Pre-deployment failure-mode gate for agentic AI systems, distilled from Microsoft AI Red Team's Taxonomy of Failure Modes in Agentic AI Systems v2.0 (grounded in 12 months of red-team engagements). Run it before shipping or materially changing an agent — adding tools/MCP servers/plugins, enabling persistent memory, adding sub-agents or orchestration, enabling computer use, or expanding permissions — to verify concrete controls against memory poisoning, HitL bypass, goal hijacking, supply-chain compromise, session context contamination, capability disclosure, and multi-agent cascade failures.

AI, LLMs & Agents

Agent Improvement Loop

10

Archive228/lab-skills

Operate a trace-driven improvement loop for a deployed agent: capture execution traces, convert human and model feedback into Promptfoo evals, gate the current harness against them, rank harness changes with HALO, and hand off a Codex-ready change set. Use when an agent is live and you need a repeatable cadence for diagnosing failures and shipping harness fixes — not for pre-launch prompt tinkering without traces.

AI, LLMs & Agents

Agent Builder

5

NikolasMarkou/agent-builder

Build, review, troubleshoot, optimize, and extend AI agents — single-agent, multi-agent, RAG, and production systems. Covers framework selection, pattern selection (topology, behavioral, data flow), agent orchestration, state design, and tool design. Defaults to Python with LangChain/LangGraph; also supports CrewAI, Strands, OpenAI Agents SDK, Google ADK, and Mastra. Use whenever the user wants to build, design, scaffold, review, debug, optimize, extend, or migrate an agent or agentic system.

AI, LLMs & Agents

Storyblok Use MCP

9

storyblok/agent-plugin

Use when interacting with Storyblok through the MCP server — the tool model, operation names and payload shapes for stories, assets, components, datasources and every other resource. Load it before calling `mcp__storyblok__` tools, alongside the skill that owns the task.

AI, LLMs & Agents

Recover Semantic Model

9

kr4chinin/skills

Recover a program's minimal semantic model (the state that changes what users see, how its transitions repeat and reorder, what each effect requires). Use when asked to recover or audit that model, to check what is idempotent or order-dependent, or to split a refactor into provably equivalent and "trust me" changes.

AI, LLMs & Agents

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