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.
Install
/plugin marketplace add frankxai/claude-skills-libraryThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add frankxai/claude-skills-library --skill ai-architect-reviewgit 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-reviewPersonal 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**Details
- Skill name
ai-architect-review- Repository
- frankxai/claude-skills-library
- 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
48frankxai/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.
Acos Visual Gen
48frankxai/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.
Agent Harness Construction
48frankxai/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 Architecture
48frankxai/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 Architect Newsletter
48frankxai/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.
Arcanea Meta
48frankxai/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.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.