alirezarezvani--claude-skills/engineering-team/README.md

Engineering Skills Collection

Complete set of 32 engineering skills (role skills, security suite, AI/ML/Data, and specialized tools) tailored to your tech stack (ReactJS, NextJS, NodeJS, Express, React Native, Swift, Kotlin, Flutter, Postgres, GraphQL, Go, Python).

⚡ Installation

Quick Install (Recommended)

Install all engineering skills with one command:

# Install all engineering skills to all supported agents
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team

# Install to Claude Code only
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team --agent claude

# Install to Cursor only
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team --agent cursor

Install Individual Skills

# Core Engineering
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-architect
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-frontend
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-backend
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-fullstack
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-qa
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-devops
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-secops
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/code-reviewer
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-security

# Cloud & Enterprise
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/aws-solution-architect
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/ms365-tenant-manager

# Development Tools
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/tdd-guide
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/tech-stack-evaluator

# AI/ML/Data
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-data-scientist
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-data-engineer
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-ml-engineer
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-prompt-engineer
npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team/skills/senior-computer-vision

Supported Agents: Claude Code, Cursor, VS Code, Copilot, Goose, Amp, Codex

Complete Installation Guide: See ../INSTALLATION.md for detailed instructions, troubleshooting, and manual installation.

---

📦 Skills Package

All skills follow the exact structure from your fullstack-engineer example:

skill-name/
├── SKILL.md                  # Main skill documentation
├── references/               # 3 detailed reference guides
│   ├── [topic]_patterns.md
│   ├── [topic]_guide.md
│   └── [topic]_practices.md
└── scripts/                  # 3 automation scripts
    ├── [tool]_generator.py
    ├── [tool]_analyzer.py
    └── [tool]_scaffolder.py

🎯 Skills Overview

1. Senior Software Architect (skills/senior-architect/)

Purpose: System architecture design, tech stack decisions, architecture diagrams

Key Capabilities:

• Architecture diagram generation (C4, sequence, component)
• Dependency analysis and visualization
• Architecture Decision Records (ADR) creation
• System design patterns (Monolithic, Microservices, Serverless)
• Integration pattern templates
• Tech stack decision framework

Scripts:

• architecture_diagram_generator.py - Generate professional architecture diagrams
• project_architect.py - Scaffold architecture documentation
• dependency_analyzer.py - Analyze dependencies and detect issues

References:

• architecture_patterns.md - Comprehensive architecture patterns
• system_design_workflows.md - Step-by-step design process
• tech_decision_guide.md - Tech stack selection guide

Use When:

• Designing new system architecture
• Making technology stack decisions
• Creating technical documentation
• Evaluating architectural trade-offs

---

2. Senior Frontend Engineer (skills/senior-frontend/)

Purpose: Frontend development with React, Next.js, TypeScript

Key Capabilities:

• React component scaffolding
• Bundle size analysis and optimization
• Performance optimization
• Next.js App Router patterns
• State management (Zustand, Context)
• UI/UX best practices

Scripts:

• component_generator.py - Generate React components
• bundle_analyzer.py - Analyze and optimize bundles
• frontend_scaffolder.py - Scaffold frontend projects

References:

• react_patterns.md - React best practices and patterns
• nextjs_optimization_guide.md - Next.js performance guide
• frontend_best_practices.md - Modern frontend practices

Use When:

• Building React/Next.js applications
• Optimizing frontend performance
• Implementing UI components
• Managing application state

---

3. Senior Backend Engineer (skills/senior-backend/)

Purpose: Backend development with Node.js, Express, GraphQL, Go, Python

Key Capabilities:

• REST & GraphQL API design
• Database optimization (PostgreSQL)
• Authentication/Authorization
• API load testing
• Microservice patterns
• Error handling strategies

Scripts:

• api_scaffolder.py - Generate API endpoints
• database_migration_tool.py - Database migration management
• api_load_tester.py - API performance testing

References:

• api_design_patterns.md - API design best practices
• database_optimization_guide.md - Database performance guide
• backend_security_practices.md - Security implementation

Use When:

• Designing APIs (REST/GraphQL)
• Optimizing database queries
• Implementing authentication
• Building microservices

---

4. Senior Fullstack Engineer (skills/senior-fullstack/)

Purpose: End-to-end application development

Key Capabilities:

• Full project scaffolding
• Code quality analysis
• Full-stack architecture
• Frontend-backend integration
• Testing strategies
• Deployment workflows

Scripts:

• fullstack_scaffolder.py - Generate complete projects
• project_scaffolder.py - Project structure creation
• code_quality_analyzer.py - Comprehensive code analysis

References:

• tech_stack_guide.md - Complete tech stack reference
• architecture_patterns.md - Full-stack architecture
• development_workflows.md - Development best practices

Use When:

• Starting new full-stack projects
• Analyzing code quality
• Implementing complete features
• Setting up development environments

---

5. Senior QA Testing Engineer (skills/senior-qa/)

Purpose: Quality assurance and test automation for React/Next.js applications

Tech Stack Focus:

• Jest + React Testing Library (unit/integration)
• Playwright (E2E testing)
• Istanbul/NYC (coverage analysis)
• MSW (API mocking)

Key Capabilities:

• Component test generation with accessibility checks
• Coverage gap analysis with critical path detection
• E2E test scaffolding with Page Object Model
• Test pyramid implementation (70/20/10 ratio)
• CI/CD integration patterns

Scripts:

• test_suite_generator.py - Scans React components, generates Jest + RTL tests with accessibility assertions
• coverage_analyzer.py - Parses Istanbul/LCOV reports, identifies untested critical paths, generates HTML reports
• e2e_test_scaffolder.py - Scans Next.js routes, generates Playwright tests with Page Object Model classes

References:

• testing_strategies.md - Test pyramid, coverage targets, CI/CD integration patterns
• test_automation_patterns.md - Page Object Model, fixtures, mocking strategies, async testing
• qa_best_practices.md - Test naming, isolation, flaky test handling, debugging strategies

Use When:

• Setting up React/Next.js testing infrastructure
• Generating component test suites with RTL
• Analyzing coverage gaps in critical paths
• Scaffolding Playwright E2E tests for Next.js routes

---

6. Senior DevOps Engineer (skills/senior-devops/)

Purpose: CI/CD, infrastructure automation, deployment

Key Capabilities:

• CI/CD pipeline setup (GitHub Actions, CircleCI)
• Infrastructure as Code (Terraform)
• Docker containerization
• Kubernetes orchestration
• Deployment automation
• Monitoring setup

Scripts:

• pipeline_generator.py - Generate CI/CD pipelines
• terraform_scaffolder.py - Create IaC templates
• deployment_manager.py - Manage deployments

References:

• cicd_pipeline_guide.md - Pipeline setup and best practices
• infrastructure_as_code.md - IaC patterns and examples
• deployment_strategies.md - Blue-green, canary deployments

Use When:

• Setting up CI/CD pipelines
• Automating deployments
• Managing infrastructure
• Containerizing applications

---

7. Senior SecOps Engineer (skills/senior-secops/)

Purpose: Security operations and compliance

Key Capabilities:

• Security scanning automation
• Vulnerability assessment
• Compliance checking (GDPR, SOC2)
• Security audit automation
• Incident response
• Security metrics

Scripts:

• security_scanner.py - Scan for vulnerabilities
• vulnerability_assessor.py - Assess security risks
• compliance_checker.py - Check compliance status

References:

• security_standards.md - OWASP Top 10, security standards
• vulnerability_management_guide.md - Vulnerability handling
• compliance_requirements.md - Compliance frameworks

Use When:

• Implementing security controls
• Conducting security audits
• Managing vulnerabilities
• Ensuring compliance

---

8. Code Reviewer (skills/code-reviewer/)

Purpose: Code review automation and quality checking

Key Capabilities:

• Automated PR analysis
• Code quality metrics
• Security scanning
• Best practice checking
• Review checklist generation
• Anti-pattern detection

Scripts:

• pr_analyzer.py - Analyze pull requests
• code_quality_checker.py - Check code quality
• review_report_generator.py - Generate review reports

References:

• code_review_checklist.md - Comprehensive checklist
• coding_standards.md - Language-specific standards
• common_antipatterns.md - What to avoid

Use When:

• Reviewing pull requests
• Ensuring code quality
• Identifying issues
• Providing feedback

---

9. Senior Security Engineer (skills/senior-security/)

Purpose: Security architecture and penetration testing

Key Capabilities:

• Threat modeling
• Security architecture design
• Penetration testing automation
• Cryptography implementation
• Security auditing
• Zero Trust architecture

Scripts:

• threat_modeler.py - Create threat models
• security_auditor.py - Perform security audits
• pentest_automator.py - Automate penetration tests

References:

• security_architecture_patterns.md - Security design patterns
• penetration_testing_guide.md - Pen testing methodologies
• cryptography_implementation.md - Crypto best practices

Use When:

• Designing security architecture
• Conducting penetration tests
• Implementing cryptography
• Performing security audits

---

🚀 Quick Start Guide

Installation

1. Pick the skills you need under skills/
2. Open the skill folder (e.g., cd skills/senior-architect)
3. Install dependencies (if needed):

   # For Python scripts
   pip install -r requirements.txt
   
   # For Node.js tools
   npm install
   

Using a Skill

Each skill follows the same pattern:

# 1. Read the SKILL.md file
cat SKILL.md

# 2. Check the reference documentation
ls references/

# 3. Run the scripts
python scripts/[script-name].py --help

# Example: Generate architecture diagrams
cd skills/senior-architect
python scripts/architecture_diagram_generator.py --type c4 --output ./docs

Skill Selection Guide

Starting a new project? → Use senior-fullstack or senior-architect

Building frontend features? → Use senior-frontend

Designing APIs? → Use senior-backend

Setting up CI/CD? → Use senior-devops

Security concerns? → Use senior-secops or senior-security

Code review? → Use code-reviewer

Testing strategy? → Use senior-qa

---

📚 Common Workflows

Workflow 1: Starting a New Project

# Step 1: Design architecture
cd skills/senior-architect
python scripts/project_architect.py my-app --pattern microservices

# Step 2: Scaffold project
cd ../senior-fullstack
python scripts/project_scaffolder.py my-app --type nextjs-graphql

# Step 3: Setup CI/CD
cd ../senior-devops
python scripts/pipeline_generator.py my-app --platform github

Workflow 2: Code Review Process

# Step 1: Analyze PR
cd skills/code-reviewer
python scripts/pr_analyzer.py ../my-app

# Step 2: Check quality
python scripts/code_quality_checker.py ../my-app

# Step 3: Generate report
python scripts/review_report_generator.py ../my-app --output review.md

Workflow 3: Security Audit

# Step 1: Scan for vulnerabilities
cd skills/senior-secops
python scripts/security_scanner.py ../my-app

# Step 2: Assess risks
python scripts/vulnerability_assessor.py ../my-app

# Step 3: Check compliance
python scripts/compliance_checker.py ../my-app --standard soc2

---

🛠 Tech Stack Support

All skills are optimized for your tech stack:

Frontend:

• React 18+
• Next.js 14+ (App Router)
• TypeScript
• Tailwind CSS
• React Native
• Flutter

Backend:

• Node.js 20+
• Express 4+
• GraphQL (Apollo Server)
• Go (Gin/Echo)
• Python (FastAPI)

Database:

• PostgreSQL 16+
• Prisma ORM
• NeonDB
• Supabase

Mobile:

• Swift (iOS)
• Kotlin (Android)
• React Native
• Flutter

DevOps:

• Docker
• Kubernetes
• Terraform
• GitHub Actions
• CircleCI
• AWS/GCP/Azure

Tools:

• Git (GitHub/GitLab/Bitbucket)
• Jira
• Confluence
• Figma
• Miro

---

📖 Best Practices

Using Scripts

1. Always read help first: python script.py --help
2. Test in development: Run on sample projects first
3. Review outputs: Check generated files before using
4. Customize as needed: Scripts are starting points

Using References

1. Start with patterns: Read the patterns guide first
2. Follow workflows: Use step-by-step workflows
3. Adapt to context: Adjust recommendations for your needs
4. Document decisions: Keep track of what works

Combining Skills

Skills work best together:

• Architect + Fullstack: Design then build
• DevOps + SecOps: Deploy securely
• Backend + QA: Build and test APIs
• Frontend + Code Reviewer: Build quality UIs

---

🔄 Iteration and Updates

These skills are designed to evolve:

1. Use the skill on real projects
2. Note improvements needed
3. Update scripts and references
4. Share learnings with team

---

📝 Customization

Each skill can be customized:

Updating Scripts

Edit Python scripts to add:

• Company-specific conventions
• Custom templates
• Additional checks
• Integration with your tools

Updating References

Edit markdown files to add:

• Your patterns and practices
• Team standards
• Project examples
• Lessons learned

---

🎯 Summary

You now have 9 comprehensive engineering skills that match your tech stack:

1. ✅ Senior Architect - System design and architecture
2. ✅ Senior Frontend - React/Next.js development
3. ✅ Senior Backend - API and backend development
4. ✅ Senior Fullstack - End-to-end development
5. ✅ Senior QA - Testing and quality assurance
6. ✅ Senior DevOps - CI/CD and infrastructure
7. ✅ Senior SecOps - Security operations
8. ✅ Code Reviewer - Code review automation
9. ✅ Senior Security - Security architecture

Each skill includes:

• Comprehensive SKILL.md with quick start guide
• 3 reference guides with patterns and best practices
• 3 automation scripts for common tasks

---

🚀 Next Steps

1. Pick the skills you need most under skills/
2. Explore the folder structure
3. Read SKILL.md for each skill
4. Run example scripts to understand capabilities
5. Customize for your specific needs
6. Integrate into your development workflow

---

💡 Tips

• Start small: Begin with 2-3 core skills
• Test scripts: Run on sample projects first
• Read references: They contain valuable patterns
• Iterate: Update skills based on usage
• Share: Use as team knowledge base

---

Happy Engineering! 🎉