Home / github / awesome-copilot · skills/agent-architecture/SKILL.md · GitHub

agent-architecture skillA

agent-architecture is agent-read markdown (skill) from github/awesome-copilot: Design AI agent architectures through requirements discovery, or audit and diagnose architectural flaws in existing agents. Architecture only; excludes implementation and general code review..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# 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 |
…

Read the whole file at its exact version.

How to install

Latest version
mdr add github/awesome-copilot/agent-architecture@git:20260920.9bf465b
Exact content
mdr add github/awesome-copilot/agent-architecture@sha256:914b3d476f06017a

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_pnyjptoz26h3kk2e.svg)](https://markdownregistry.com/a/art_pnyjptoz26h3kk2e)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260920.9bf465b latest2026-09-20 9bf465b 10,048 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10048 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

github/awesome-copilot · 39,368 stars · license MIT · pushed 2026-09-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pnyjptoz26h3kk2e
GET https://markdownregistry.com/api/v1/resolve?ref=github/awesome-copilot/agent-architecture
GET https://markdownregistry.com/api/v1/blob/914b3d476f06017a43d2f616f034d34df40bdea7d6656d0e01db32eab57ef5ca

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from github/awesome-copilot

agentic-workflows skill
github/awesome-copilot · .github/skills/agentic-workflows/SKILL.md · Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.
git:20260923.d7e4ad9 · audit A · 39,368 stars
code-review skill
github/awesome-copilot · .github/skills/code-review/SKILL.md · Review pull requests for repository fit, meaningful value, trustworthy provenance, differentiation, and maintainability…
git:20260923.d7e4ad9 · audit A · 39,368 stars
create-canvas-extension skill
github/awesome-copilot · .github/skills/create-canvas-extension/SKILL.md · Create or register a canvas extension in the awesome-copilot repository. Use when asked to scaffold a new canvas…
git:20260824.37dcfd2 · audit A · 39,368 stars
AGENTS.md agents
github/awesome-copilot · AGENTS.md
git:20260908.a93a83b · audit A · 39,368 stars
acquire-codebase-knowledge skill
github/awesome-copilot · skills/acquire-codebase-knowledge/SKILL.md · Use this skill when the user explicitly asks to map, document, or onboard into an existing codebase. Trigger for…
v1.3 · audit B · 39,368 stars
acreadiness-assess skill
github/awesome-copilot · skills/acreadiness-assess/SKILL.md · Run the AgentRC readiness assessment on the current repository and produce a static HTML dashboard at…
git:20260504.ebd2249 · audit A · 39,368 stars
acreadiness-generate-instructions skill
github/awesome-copilot · skills/acreadiness-generate-instructions/SKILL.md · Generate tailored AI agent instruction files via AgentRC instructions command. Produces .github/copilot-instructions.md…
git:20260504.ebd2249 · audit A · 39,368 stars
acreadiness-policy skill
github/awesome-copilot · skills/acreadiness-policy/SKILL.md · Help the user pick, write, or apply an AgentRC policy. Policies customise readiness scoring by disabling irrelevant…
git:20260504.ebd2249 · audit A · 39,368 stars
ad-campaign-analyzer skill
github/awesome-copilot · skills/ad-campaign-analyzer/SKILL.md · Use this skill when the user shares ad campaign performance data and asks what to cut, scale, or test. Trigger for…
v1.0 · audit A · 39,368 stars
add-educational-comments skill
github/awesome-copilot · skills/add-educational-comments/SKILL.md · Add educational comments to the file specified, or prompt asking for file to comment if one is not provided.
git:20260224.caab1f6 · audit A · 39,368 stars
adobe-illustrator-scripting skill
github/awesome-copilot · skills/adobe-illustrator-scripting/SKILL.md · Write, debug, and optimize Adobe Illustrator automation scripts using ExtendScript (JavaScript/JSX). Use when creating…
git:20260528.9bdb742 · audit A · 39,368 stars
agent-governance skill
github/awesome-copilot · skills/agent-governance/SKILL.md · Patterns and techniques for adding governance, safety, and trust controls to AI agent systems. Use this skill when: -…
git:20260316.55d3bf6 · audit A · 39,368 stars

Every file in github/awesome-copilot

Browse by kind, by grade A, or by owner.