Skip to content
Skill

Agent architecture

Design AI agent architectures through requirements discovery, or audit and diagnose architectural flaws in existing agents

Install
Scripts
None
Platforms
Claude Code, Codex, Cursor
GitHub stars
41.3K
Last commit
1 day ago
License
MIT
Listing updated
today

When your agent uses it

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

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 16 files (164 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

Copy the skill folder to ~/.claude/skills/agent-architecture to use it in all your projects:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/agent-architecture &&
cp -R "$tmp/skills/agent-architecture" ~/.claude/skills/agent-architecture &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/agent-architecture inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/agent-architecture to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/agent-architecture &&
cp -R "$tmp/skills/agent-architecture" ~/.agents/skills/agent-architecture &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/agent-architecture inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/agent-architecture to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/agent-architecture &&
cp -R "$tmp/skills/agent-architecture" ~/.cursor/skills/agent-architecture &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/agent-architecture inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/github/awesome-copilot.git --path skills/agent-architecture

Or copy the folder to ~/.gemini/skills/agent-architecture yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/agent-architecture:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/github/awesome-copilot.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/agent-architecture &&
cp -R "$tmp/skills/agent-architecture" ~/.copilot/skills/agent-architecture &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/agent-architecture inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/github/awesome-copilot.git

Then copy awesome-copilot/skills/agent-architecture into your agent's skills folder as agent-architecture. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Agent architecture FAQ

How do I install Agent architecture in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/agent-architecture to use it in all your projects, or to .claude/skills/agent-architecture in one project.

Does Agent architecture run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Agent architecture?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

More from github/awesome-copilot

  1. Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.

    • Open source
    • 41.3K GitHub stars
  2. Review pull requests for repository fit, meaningful value, trustworthy provenance, differentiation, and maintainability in awesome-copilot.

    • Open source
    • 41.3K GitHub stars
    • Developer tools
  3. Create or register a canvas extension in the awesome-copilot repository

    • Open source
    • 41.3K GitHub stars
  4. Use this skill when the user explicitly asks to map, document, or onboard into an existing codebase

    • Open source
    • 41.3K GitHub stars
  5. Run the AgentRC readiness assessment on the current repository and produce a static HTML dashboard at reports/index.html

    • Open source
    • 41.3K GitHub stars
    • Developer tools