How do I install the System Architect skill?

Run npx skillmds@latest add batterfried-philosophy172/system-architect in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is System Architect safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with System Architect?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is System Architect free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published System Architect?

batterfried-philosophy172 (@batterfried-philosophy172) published this skill. Their other Agent Skills are listed on their SkillMD profile.

System Architect by batterfried-philosophy172

Name: System Architect
Author: batterfried-philosophy172

System Architect

System architecture agent that designs tech stack, folder structure, API contracts, and external service integrations. Triggers on: system design, tech stack, architecture, API design, folder structure, choose framework.

File contents

System Architect — Design Agent

Purpose

Design a complete, justified system architecture before any code is written. Prevent "spaghetti architecture" by making deliberate, documented choices.

When to Use

After MVP scope is approved
When choosing a tech stack for a new project
When designing API contracts or system structure

Process

Step 1: Tech Stack Selection

For each layer, recommend a technology with a one-line justification:

Layer	Choice	Why
Frontend	e.g., Next.js	SSR for SEO, React ecosystem
Backend	e.g., Next.js API Routes	Unified codebase, serverless-ready
Database	e.g., PostgreSQL	Relational data, free tier on Supabase
Auth	e.g., NextAuth.js	Free, supports OAuth providers
Hosting	e.g., Vercel	Free tier, zero-config deploys

Constraint: Prefer free-tier-friendly technologies unless the user specifies a budget.

Step 2: System Architecture

Describe the architecture in plain text or a mermaid diagram:

How do the frontend, backend, and database connect?
What is the request flow for the core user action?
Where does authentication happen?

Step 3: Project File Structure

Present the complete folder/file tree:

project-root/
├── src/
│   ├── app/           # Pages and routes
│   ├── components/    # Reusable UI components
│   ├── lib/           # Business logic and utilities
│   ├── api/           # API route handlers
│   └── db/            # Database schema and migrations
├── tests/             # Test files
├── public/            # Static assets
├── .env.example       # Environment variable template
├── package.json
└── README.md

Step 4: API Endpoint Inventory

List every API endpoint the MVP needs:

Method	Endpoint	Description	Auth Required
POST	/api/auth/register	Create new user	No
POST	/api/auth/login	Authenticate user	No
GET	/api/[resource]	List resources	Yes

Step 5: External Services

List any third-party services required:

What it does, why it's needed, what it costs, and the free tier limits

Output

Produce an architecture.md file with all sections above.

Exit Criteria

Every tech choice has a documented justification
File structure is complete (no "etc." or "...")
All API endpoints are listed with methods and auth requirements
External service costs are identified

---name: system-architectdescription: System architecture agent that designs tech stack, folder structure, API contracts, and external service integrations. Triggers on: system design, tech stack, architecture, API design, folder structure, choose framework.---# System Architect — Design Agent## PurposeDesign a complete, justified system architecture before any code is written.Prevent "spaghetti architecture" by making deliberate, documented choices.## When to Use- After MVP scope is approved- When choosing a tech stack for a new project- When designing API contracts or system structure## Process### Step 1: Tech Stack SelectionFor each layer, recommend a technology with a one-line justification:| Layer | Choice | Why ||---|---|---|| Frontend | e.g., Next.js | SSR for SEO, React ecosystem || Backend | e.g., Next.js API Routes | Unified codebase, serverless-ready || Database | e.g., PostgreSQL | Relational data, free tier on Supabase || Auth | e.g., NextAuth.js | Free, supports OAuth providers || Hosting | e.g., Vercel | Free tier, zero-config deploys |**Constraint:** Prefer free-tier-friendly technologies unless the user specifies a budget.### Step 2: System ArchitectureDescribe the architecture in plain text or a mermaid diagram:- How do the frontend, backend, and database connect?- What is the request flow for the core user action?- Where does authentication happen?### Step 3: Project File StructurePresent the complete folder/file tree:```project-root/├── src/│ ├── app/ # Pages and routes│ ├── components/ # Reusable UI components│ ├── lib/ # Business logic and utilities│ ├── api/ # API route handlers│ └── db/ # Database schema and migrations├── tests/ # Test files├── public/ # Static assets├── .env.example # Environment variable template├── package.json└── README.md```### Step 4: API Endpoint InventoryList every API endpoint the MVP needs:| Method | Endpoint | Description | Auth Required ||---|---|---|---|| POST | /api/auth/register | Create new user | No || POST | /api/auth/login | Authenticate user | No || GET | /api/[resource] | List resources | Yes |### Step 5: External ServicesList any third-party services required:- What it does, why it's needed, what it costs, and the free tier limits### OutputProduce an `architecture.md` file with all sections above.## Exit Criteria- Every tech choice has a documented justification- File structure is complete (no "etc." or "...")- All API endpoints are listed with methods and auth requirements- External service costs are identified

Frequently asked questions