Senior Architect
alirezarezvani/claude-skills
This skill should be used when the user asks to "design system architecture", "evaluate microservices vs monolith", "create architecture diagrams", "analyze dependencies", "choose a database", "plan…
System architecture design and review. An agent skill from borghei/Claude-Skills.
Install Senior Architect
$ npx skills add borghei/Claude-Skills --skill senior-architect -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install borghei/Claude-Skills senior-architect --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/senior-architect .claude/skills/senior-architect && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "senior-architect" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/senior-architect into .claude/skills/senior-architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "senior-architect", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/borghei/Claude-Skills/tree/main/engineering/senior-architectType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add borghei/Claude-Skills --skill senior-architect -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install borghei/Claude-Skills senior-architect --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/engineering/senior-architect .agents/skills/senior-architect && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "senior-architect" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/senior-architect into .agents/skills/senior-architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "senior-architect", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill senior-architect -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install borghei/Claude-Skills senior-architect --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/engineering/senior-architect .cursor/skills/senior-architect && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "senior-architect" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/senior-architect into .cursor/skills/senior-architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "senior-architect", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/borghei/Claude-Skills.git --path engineering/senior-architect--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add borghei/Claude-Skills --skill senior-architect -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install borghei/Claude-Skills senior-architect --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/engineering/senior-architect .gemini/skills/senior-architect && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "senior-architect" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/senior-architect into .gemini/skills/senior-architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "senior-architect", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install borghei/Claude-Skills senior-architectInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add borghei/Claude-Skills --skill senior-architect -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/engineering/senior-architect .github/skills/senior-architect && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "senior-architect" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/senior-architect into .github/skills/senior-architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "senior-architect", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill senior-architect -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install borghei/Claude-Skills senior-architect --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/engineering/senior-architect .opencode/skills/senior-architect && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "senior-architect" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/senior-architect into .opencode/skills/senior-architect/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "senior-architect", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
senior-architect- GitHub stars
- 886
- Token cost
- ~1.8k tokens
- SKILL.md length
- 698 words
- Files
- 9 (incl. scripts, references)
- Skills in repo
- 354
- Repo updated
- First seen
- Licence
- MIT
At a glance
System architecture design and review. An agent skill from borghei/Claude-Skills.
- Designing architecture
- SKILL.md covers Core Capabilities, When to Use, Clarify First and Tools, plus 3 more sections
- Runs Python scripts from its folder; calls python
- Evaluating microservices vs monolith
What it does
Senior Architect is an agent skill from borghei/Claude-Skills. System architecture design and review. Use when designing architecture, evaluating microservices vs monolith, writing ADRs, choosing a database, planning for scalability, reviewing system design, or generating architecture diagrams.
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and reference files (for example `references/architecture_patterns.md`, `references/decision_workflows.md` and `references/system_design_workflows.md`).
It sits in Development, covering Diagrams, Microservices and Architecture decision records. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.
When your agent uses it
- Designing architecture
- Evaluating microservices vs monolith
- Choosing a database
- Planning for scalability
Example prompts
- “/senior-architect”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit 4a698e8. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 3 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Senior Architect loads about 1.8k tokens when it runs, and up to ~16k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 698 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 698 words, ~1,759 tokens.
Download SKILL.mdSave it as
.claude/skills/senior-architect/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.- name
- senior-architect
- description
- System architecture design and review. Use when designing architecture, evaluating microservices vs monolith, writing ADRs, choosing a database, planning for scalability, reviewing system design, or generating architecture diagrams.
- license
- MIT + Commons Clause
- metadata.version
- 1.1.0
- metadata.author
- borghei
- metadata.category
- engineering
- metadata.domain
- system-design
- metadata.updated
- 2026-06-17
- metadata.tags
- system-design, distributed-systems, architecture, adr, scalability
Senior Architect
Architecture design and analysis tools for making informed technical decisions: visualize system structure, analyze dependencies and coupling, detect architectural patterns, and run decision workflows for databases, patterns, and monolith-vs-microservices trade-offs.
Core Capabilities
- Diagram generation — produce component, layer, and deployment diagrams in Mermaid, PlantUML, or ASCII from a project directory.
- Dependency analysis — map the dependency tree, score coupling (0-100), and detect circular dependencies across npm, pip, Poetry, Go modules, and Cargo.
- Pattern detection — assess an existing codebase for layered/MVC/hexagonal/clean/microservices patterns, layer violations, god classes, and mixed concerns.
- Database selection — match data characteristics, scale, and consistency needs to SQL/NoSQL options with an ADR template.
- Pattern & topology selection — choose an architecture pattern by team size, deployment, and data-boundary requirements.
- Monolith vs microservices — apply decision checklists and a modular-monolith-first hybrid strategy.
When to Use
- Designing a new system or refactoring existing architecture.
- Evaluating microservices vs monolith, or choosing a database.
- Writing an ADR, planning for scalability, or reviewing a system design.
- Generating architecture diagrams for documentation or team review.
Clarify First
Before generating diagrams or an assessment, confirm these inputs. If any is unknown or vague, ASK — do not assume:
- Project root — the codebase directory to analyze (drives pattern detection, dependency scoring, and diagram contents)
- Diagram type & format — component / layer / deployment in Mermaid / PlantUML / ASCII (sets what the generator emits)
- Architecture decision in question — e.g. database choice or monolith vs microservices (selects the decision workflow and ADR)
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Tools
| Tool | Purpose | Command |
|---|---|---|
architecture_diagram_generator.py | Generate component/layer/deployment diagrams from project structure | python scripts/architecture_diagram_generator.py ./project --format mermaid --type component |
dependency_analyzer.py | Score coupling and find circular dependencies across package managers | python scripts/dependency_analyzer.py ./project --output json --check circular |
project_architect.py | Detect architecture pattern, layer violations, and code smells | python scripts/project_architect.py ./project --check layers --verbose |
Run any script with --help for full flags.
References
Load the reference that matches the task — keep this file lean and pull detail on demand:
- references/architecture_patterns.md — 9 architecture patterns (monolith, modular monolith, microservices, event-driven, CQRS, event sourcing, hexagonal, clean, API gateway) with trade-offs and code examples. Read when asked "which pattern?", "microservices vs monolith", "event-driven", or "CQRS".
- references/system_design_workflows.md — 6 step-by-step workflows: design interview, capacity planning, API design, database schema design, scalability assessment, migration planning. Read when asked "how to design?", "capacity planning", "API design", or "migration".
- references/tech_decision_guide.md — decision frameworks and comparison matrices for database, caching, message queue, auth, frontend framework, cloud provider, and API style. Read when asked "which database/framework/cloud/cache?".
- references/decision_workflows.md — the database-selection, architecture-pattern-selection, and monolith-vs-microservices decision workflows with matrices, checklists, and the ADR template. Read when making a documented architecture decision.
- references/tools-and-usage.md — detailed per-tool usage, example outputs, full flag tables, common-command catalog, tech-stack coverage, troubleshooting table, and success criteria. Read when running the scripts or interpreting their output.
Show full SKILL.md (225 more words)Show less
Scope & Limitations
Covers: system-level architecture analysis (pattern detection, layer validation, component diagramming) for existing codebases; technology-agnostic dependency analysis across npm, pip, Poetry, Go modules, and Cargo; architecture decision workflows (database, pattern, monolith-vs-microservices); diagram generation in Mermaid, PlantUML, and ASCII.
Does NOT cover:
- Runtime performance profiling or load testing — use
senior-devops(capacity planning) andsenior-qa(performance test harnesses). - Security vulnerability scanning of dependencies — use
senior-securityorsenior-secopsfor CVE/SAST/DAST. - Frontend component architecture and design-system auditing — use
senior-frontendanddesign-auditor. - CI/CD pipeline design and deployment orchestration — use
senior-devopsandrelease-orchestrator.
Integration Points
| Skill | Integration | Data Flow |
|---|---|---|
senior-backend | Architecture patterns inform backend service boundaries and API contract design | Architect assessment output (detected pattern, layer assignments) feeds into backend module scaffolding |
senior-devops | Deployment diagrams and technology detection drive infrastructure-as-code decisions | Deployment diagram type output + detected technologies list consumed by DevOps for Terraform/K8s config |
senior-security | Dependency analysis surfaces packages that need security review | Dependency list JSON (--output json) passed to security scanning for CVE correlation |
senior-fullstack | Architecture pattern selection determines which fullstack scaffold template to use | Pattern selection workflow result (e.g., modular monolith) maps to project_scaffolder.py --type flag |
code-reviewer | Layer violation and god-class findings become review checklist items | project_architect.py --output json issues array integrated into code review checklists |
tech-stack-evaluator | Technology detection results feed tech stack evaluation for upgrade/migration decisions | Detected technologies list and dependency versions inform stack evaluation decision matrices |
© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 8 other files (scripts, references) in engineering/senior-architect of borghei/Claude-Skills.
- SKILL.md
- references/architecture_patterns.md
- references/decision_workflows.md
- references/system_design_workflows.md
- references/tech_decision_guide.md
- references/tools-and-usage.md
- scripts/architecture_diagram_generator.py
- scripts/dependency_analyzer.py
- scripts/project_architect.py
Open the folder on GitHubat commit 4a698e8
Compare with similar skills
Senior Architect next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Senior Architect this skillborghei/Claude-Skills | 886 | — | ~1.8k | Automated safety check: Pass | MIT | |
| Senior Architectalirezarezvani/claude-skills | 28k | 4 repos | ~2.7k | Automated safety check: Pass | MIT | |
| Evolutionary Modular Architecturetech-leads-club/agent-skills | 7k | — | ~3.7k | Automated safety check: Pass | CC-BY-4.0 | |
| Design Doc MermaidSpillwaveSolutions/design-doc-mermaid | 176 | 1 repos | ~5.6k | Automated safety check: Pass | None | |
| Architecture Decisions and ADRsfirst-fluke/oh-my-agent | 1.3k | — | ~2.6k | Automated safety check: Pass | MIT | |
| Opencharttryopendata/skills | 142 | — | ~11k | Automated safety check: Pass | MIT |
Similar skills
Evolutionary Modular Architecture
tech-leads-club/agent-skills
Guides design of modular-monolith platforms with DDD, flat-by-aggregate modules, anti-corruption layers, outbox events and resilience, plus an architecture document with SVG diagrams.
Design Doc Mermaid
SpillwaveSolutions/design-doc-mermaid
Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.
Architecture Decisions and ADRs
first-fluke/oh-my-agent
Evaluates system boundaries and tradeoffs and writes architecture recommendations, option comparisons or ADRs, with a Mermaid diagram when structure changes.
Openchart
tryopendata/skills
Generates OpenChart (https://github.com/tryopendata/openchart) chart, table, graph, sankey, tilemap, and geo map specs from data, and guides editorial design decisions.
Architecture Design
shawnpang/startup-founder-skills
When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis.
More from borghei/Claude-Skills
All 354 skills in this repoAgent Harness
borghei/Claude-Skills
Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.
Agents In The Team
borghei/Claude-Skills
Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.
AI Content Disclosure
borghei/Claude-Skills
Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.
AI Prototyping
borghei/Claude-Skills
Idea to AI-generated prototype to customer validation to engineering handoff.
Analytics Engineer
borghei/Claude-Skills
Analytics engineering across data modeling, dbt, transformation, and semantic layers.
Ansoff Matrix
borghei/Claude-Skills
Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.
Related
Categories
Questions about Senior Architect
What does Senior Architect do?
System architecture design and review. An agent skill from borghei/Claude-Skills. Senior Architect is an agent skill from borghei/Claude-Skills. System architecture design and review.
When should I use Senior Architect?
Senior Architect fits situations like: designing architecture; evaluating microservices vs monolith; choosing a database; planning for scalability.
How do I install Senior Architect in Claude Code?
Run `npx skills add borghei/Claude-Skills --skill senior-architect -a claude-code`. Or copy the skill folder (engineering/senior-architect in borghei/Claude-Skills) into .claude/skills/senior-architect in your project. Claude Code loads it when a task matches its description.
How do I install Senior Architect in Codex?
Run `npx skills add borghei/Claude-Skills --skill senior-architect -a codex`. Or copy the skill folder (engineering/senior-architect in borghei/Claude-Skills) into .agents/skills/senior-architect in your project. Codex loads it when a task matches its description.
Can I use Senior Architect in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill senior-architect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/senior-architect, .gemini/skills/senior-architect, .github/skills/senior-architect and .opencode/skills/senior-architect in your project.
What does Senior Architect need to run?
Going by SKILL.md and its folder, Senior Architect needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Senior Architect access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Senior Architect safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Senior Architect use?
Senior Architect is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Senior Architect use?
About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 14k tokens, read only when the agent opens those files.
What are the alternatives to Senior Architect?
Skills that share tags, products or a category with Senior Architect: Senior Architect (alirezarezvani/claude-skills, 28k stars), Evolutionary Modular Architecture (tech-leads-club/agent-skills, 7k stars), Design Doc Mermaid (SpillwaveSolutions/design-doc-mermaid, 176 stars) and Architecture Decisions and ADRs (first-fluke/oh-my-agent, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Senior Architect?
borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.
Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.