senior-architect
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.
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-architectskilz install alirezarezvani/claude-skills/senior-architect --agent opencodeskilz install alirezarezvani/claude-skills/senior-architect --agent codexskilz install alirezarezvani/claude-skills/senior-architect --agent geminiFirst time? Install Skilz: pip install skilz
Works with 22+ AI coding assistants
Cursor, Aider, Copilot, Windsurf, Qwen, Kimi, and more...
Extract and copy to ~/.claude/skills/ then restart Claude Desktop
git clone https://github.com/alirezarezvani/claude-skillscp -r claude-skills/engineering-team/senior-architect ~/.claude/skills/Need detailed installation help? Check our platform-specific guides:
Related Agentic Skills
automating-mail
by SpillwaveSolutions
Automates Apple Mail via JXA with AppleScript dictionary discovery. Use when asked to "automate email", "send mail via script", "JXA Mail automatio...
automating-reminders
by SpillwaveSolutions
Automates Apple Reminders using JavaScript for Automation (JXA). Use when asked to "create reminders programmatically", "automate reminder lists", ...
mastering-postgresql
by SpillwaveSolutions
PostgreSQL development for Python with full-text search (tsvector, tsquery, BM25 via pg_search), vector similarity (pgvector with HNSW/IVFFlat), JS...
automating-contacts
by SpillwaveSolutions
Automates macOS Contacts via JXA with AppleScript dictionary discovery. Use when asked to "automate contacts", "JXA contacts automation", "macOS ad...
Agentic Skill Details
- Owner
- alirezarezvani (GitHub)
- 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
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
Report Security Issue
Found a security vulnerability in this agent skill?
Report Security Issue
Thank you for helping keep SkillzWave secure. We'll review your report and take appropriate action.
Note: For critical security issues that require immediate attention, please also email security@skillzwave.ai directly.