AI Architect Review

Review the architecture of a system that calls a language model. Use when adding an agent loop, a retrieval path, a tool surface, or an MCP server to a codebase; when a system that worked in a demo is being prepared for production; or when asked to audit, review, or plan AI/agent architecture. Checks the four decisions that are expensive to reverse, then the seven planes and their boundaries.

48 stars 6 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add frankxai/claude-skills-library

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add frankxai/claude-skills-library --skill ai-architect-review
Manual install
git clone --depth 1 https://github.com/frankxai/claude-skills-library.git /tmp/claude-skills-library
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills-library/free-skills/ai-architect-review ~/.claude/skills/ai-architect-review

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 architecture review

Most AI system choices are reversible in an afternoon. Four are not. This skill
checks those four first, then walks the planes for anything unowned.

Run it against a real codebase. Every check below names something you can grep,
measure, or point at. If you cannot produce the evidence, the check fails — an
architecture review with no evidence is an opinion.

---

## Step 1 — the four decisions

Work these in order. Each one asks for evidence, not a judgement.

### 1. Where does the model call go?

The question is not which model. It is whether exactly one place in the system
knows a model provider's name.

**Evidence:** grep for the provider SDK import across the repo.

```
rg -l "from ['\"](openai|@anthropic-ai/sdk|@google/gen|@aws-sdk/client-bedrock)" --type-add 'src:*.{ts,tsx,js,py,go,rb,java}' -tsrc
```

- One module → decision made. Note where the seam is.
- More than one → **deferred, not made.** Every call site is a migration cost
  that grows monotonically. Say this plainly and give the count.

What a single seam buys, that scattered calls cannot: routing by task, fallback
when a provider degrades, a cache with a coherent key, and one line item for
spend. A system with no fallback path has no fallback path at *every* layer,
whatever the layers above it do.

### 2. What shape is the loop?

Four shapes. Three questions pick one.

1. Can you name every step before the request arrives? → **fixed workflow**
Read the full skill on GitHub

Details

Skill name
ai-architect-review
Path
free-skills/ai-architect-review/SKILL.md
License
MIT
Repo updated
18 November 2026

FAQ

What does the AI Architect Review skill do?

Review the architecture of a system that calls a language model. Use when adding an agent loop, a retrieval path, a tool surface, or an MCP server to a codebase; when a system that worked in a demo is being prepared for production; or when asked to audit, review, or plan AI/agent architecture. Checks the four decisions that are expensive to reverse, then the seven planes and their boundaries.

How do I install the AI Architect Review skill?

Claude Code plugin: /plugin marketplace add frankxai/claude-skills-library. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is AI Architect Review popular?

It lives in frankxai/claude-skills-library, which has 48 GitHub stars and 6 forks.

Related skills

Acos Meta

48

frankxai/claude-skills-library

ACOS self-description and configuration skill. Documents how ACOS works, how to extend it, how to add new skills/commands/agents, and how to debug the hook system. Use when building new ACOS capabilities, understanding the system architecture, or onboarding to ACOS for the first time.

Software Development

Acos Visual Gen

48

frankxai/claude-skills-library

Generate research-grounded visuals using the InfoGenius pipeline. Use when creating infographics, diagrams, educational visuals, or any image that benefits from factual accuracy. Supports 8 visual styles (3D, technical, minimalist, photorealistic, futuristic, vintage, cartoon, standard) and 4 audience levels.

Images, Video & Audio

Agent Harness Construction

48

frankxai/claude-skills-library

Shape an agent's tools, observations, and recovery without adding a second coordinator. Use when defining a tool, a skill, a hook, or a worktree lane.

AI, LLMs & Agents

AI Architecture

48

frankxai/claude-skills-library

Expert guidance on multi-cloud architecture, cost analysis, and technical decision-making for AI platforms across AWS, GCP, Azure, and OCI. Use when comparing clouds, estimating infra cost, or making build-vs-buy and architecture trade-off decisions for an AI product.

AI, LLMs & Agents

AI Architect Newsletter

48

frankxai/claude-skills-library

Generate high-quality AI Architect newsletters with latest AI news, research integration, and visual design. Use when creating newsletters, researching AI developments, synthesizing AI news for architects, or distributing intelligence reports. Covers AI model releases, research papers, tool launches, architecture patterns, production systems, and enterprise AI trends. Integrates with FrankX research hub and supports both daily briefs and weekly deep-dives.

AI, LLMs & Agents

Arcanea Meta

48

frankxai/claude-skills-library

Arcanea ecosystem self-description. Use when asked about the system map, where things live, canonical locations, how to add a skill/command/agent/hook, how to absorb a repo, or what's installed. Trigger phrases: arcanea meta, system map, where does X live, add a skill, absorb a repo, what's installed, ecosystem inventory.

AI, LLMs & Agents

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