Individual skill

agent-architecture

Design AI agent architectures through requirements discovery, or audit and diagnose architectural flaws in existing agents. Architecture only; excludes implementation and general code review.

skills/agent-architecture/SKILL.md

Read pinned source

Source commit edbecfa9099c4addae1f500cca1ac067204b30fd

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: No
Observed behavior: Network or broad shell
Last checked: Nov 4, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 40,901
Repository last updated: Nov 6, 2026
License: MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

ai Repository topic
github-copilot Repository topic
prompt-engineering Repository topic
hacktoberfest Repository topic
agent-skills Repository topic
agents Repository topic
awesome Repository topic
custom-agents Repository topic
engineering Derived category
design Derived category
security Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

LICENSE.txtdoc · 1,077 bytes
SKILL.mdcore · 10,048 bytes
SKILL.mdcore · 10,048 bytes
agents/openai.yamlasset · 309 bytes
references/architecture-contract.mddoc · 20,754 bytes
references/architecture-selection.mddoc · 7,436 bytes
references/audit.mddoc · 9,748 bytes
references/capability-design.mddoc · 6,241 bytes
references/design.mddoc · 10,479 bytes
references/diagnostic-review.mddoc · 13,270 bytes
references/discovery-protocol.mddoc · 8,836 bytes
references/evaluation-design.mddoc · 7,718 bytes
references/execution-continuity.mddoc · 13,771 bytes
references/result-delivery.mddoc · 7,619 bytes
references/scenarios.mddoc · 25,276 bytes
references/source-map.mddoc · 18,862 bytes
references/validation-loop.mddoc · 7,001 bytes

Read excerpt


# AI Agent Architecture

Help the user obtain a justified architecture for their task or an evidence-based audit of an existing agent. Deliver architectural decisions and ways to verify them, without implementing the agent. By default, completed work includes a PDF report and a visualization of the results. An “ideal architecture” fits the requirements, cost of failure, and team resources; it does not maximize the number of components.

## Choose a route

| Request | Route | Read |
|---|---|---|
| New agent, requirements are not yet clear | Design: working cases → early design → requirements and decision coverage → delivery | [design.md](references/design.md), [architecture-contract.md](references/architecture-contract.md) |
| Architecture from an existing specification | Design: fill in what is known and clarify only gaps | The same files; do not restart the interview |
| Review an agent already written | Audit: reconstruct actual paths → verify → deliver findings | [audit.md](references/audit.md), and [architecture-contract.md](references/architecture-contract.md) as criteria |
| Agent makes mistakes, has degraded, or falsely reports “done” | Diagnosis within the audit: case → hypotheses → discriminating checks → correction and closure criterion | audit.md and [diagnostic-review.md](references/diagnostic-review.md) |
| Review and redesign | Audit first; its demonstrated problems become design inputs | audit.md first, then design.md |