senior-architect

579 stars 112 forks
0
F

Comprehensive software architecture skill for designing scalable, maintainable systems using ReactJS, NextJS, NodeJS, Express, React Native, Swift, Kotlin, Flutter, Postgres, GraphQL, Go, Python. Includes architecture diagram generation, system design patterns, tech stack decision frameworks, and dependency analysis. Use when designing system architecture, making technical decisions, creating architecture diagrams, evaluating trade-offs, or defining integration patterns.

CommandsAgentsMarketplace
#claude-ai#maintainable systems#claudecode-subagents#claude-ai-skills#practices#claude-skills#claude-code#Postgres

Third-Party Agent Skill: Review the code before installing. Agent skills execute in your AI assistant's environment and can access your files. Learn more about security

Installation for Agentic Skill

View all platforms →
skilz install alirezarezvani/claude-skills/senior-architect
skilz install alirezarezvani/claude-skills/senior-architect --agent opencode
skilz install alirezarezvani/claude-skills/senior-architect --agent codex
skilz install alirezarezvani/claude-skills/senior-architect --agent gemini

First time? Install Skilz: pip install skilz

Works with 22+ AI coding assistants

Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...

View All Agents
Download Agent Skill ZIP

Extract and copy to ~/.claude/skills/ then restart Claude Desktop

1. Clone the repository:
git clone https://github.com/alirezarezvani/claude-skills
2. Copy the agent skill directory:
cp -r claude-skills/engineering-team/senior-architect ~/.claude/skills/

Need detailed installation help? Check our platform-specific guides:

Related Agentic Skills

Agentic Skill Details

Repository
claude-skills
Stars
579
Forks
112
Type
Other
Meta-Domain
Primary Domain
Market Score
0

Agent Skill Grade

F
Score: 28/100 Click to see breakdown

Score Breakdown

Spec Compliance
12/15
PDA Architecture
5/30
Ease of Use
8/25
Writing Style
3/10
Utility
0/20

Areas to Improve

  • Missing Core Reference Files
  • Missing Python Scripts
  • Marketing Language Throughout

Recommendations

  • Focus on improving Pda (currently 5/30)
  • Focus on improving Ease Of Use (currently 8/25)
  • Focus on improving Writing Style (currently 3/10)

Graded: 2026-01-24

Developer Feedback

I noticed your skill focuses on architectural patterns, but the grading came back at 28/100—let me walk through what's holding it back and where we can rebuild this to actually help developers make better design decisions.

Links:

The TL;DR

You're at 28/100, which puts this in F territory. This is based on Anthropic's best practices for skill design. Your strongest area is Spec Compliance (12/15)—the YAML frontmatter is clean—but Utility is completely bottlenecked at 0/20, dragging everything down. The core issue: the skill promises tools and workflows that don't actually exist.

What's Working Well

  • Valid YAML structure - Your frontmatter hits all the required fields with correct hyphen-case naming
  • Clear metadata description - You nailed the tech stack details and trigger phrases in the description
  • Organized sections - Headers for Features, Workflows, and References show intentional structure

The Big One: Missing Core Files and Scripts

This is the wall stopping everything. Your SKILL.md references three documentation files (architecture_patterns.md, system_design_workflows.md, tech_decision_guide.md) and three Python scripts (architecture_diagram_generator.py, project_architect.py, dependency_analyzer.py) that don't exist.

When a developer tries to use this skill, they hit dead links and broken commands. That's why Utility scored 0/20—there's no actual problem-solving power here.

The fix: Either create these files with real content, or consolidate everything into SKILL.md itself. You don't need external scripts—replace them with concrete Claude workflows. For example, instead of referencing a missing diagram generator, show an actual prompt...

AI-Detected Topics

Extracted using NLP analysis

claude-ai maintainable systems claudecode-subagents claude-ai-skills practices claude-skills claude-code Postgres architecture Diagram Generator

Report Security Issue

Found a security vulnerability in this agent skill?