tech-hub-skills 1.2.0 → 1.5.2

package/.claude/skills/README.md

@@ -0,0 +1,336 @@
+# Tech Hub Claude Skills
+
+This directory contains Claude Code skills that provide intelligent access to the complete Tech Hub skills library (**100+ production-ready skills across 12 roles**).
+
+## 🎯 Primary Skill: ORCHESTRATOR
+
+**Start here for any project!**
+
+The `orchestrator` skill is your intelligent project manager that:
+
+- Analyzes project requirements
+- Selects optimal skill combinations across multiple roles
+- Applies best practices automatically (cost, security, quality)
+- Generates comprehensive execution plans
+- Coordinates cross-role integrations
+
+### How to Use the Orchestrator
+
+In Claude Code, simply describe your project:
+
+```
+@orchestrator I need to build a customer churn prediction model
+```
+
+The orchestrator will:
+
+1. Analyze domain, complexity, and compliance needs
+2. Select optimal skills (PII detection, data pipelines, ML training, deployment, monitoring)
+3. Apply automatic cost optimizations (70-90% savings)
+4. Generate a phased implementation plan
+5. Reference specific skill documentation for implementation
+
+## 📚 All Available Skills
+
+### Core Engineering Roles
+
+| Skill File          | Role             | When to Use                                   |
+| ------------------- | ---------------- | --------------------------------------------- |
+| `ai-engineer.md`    | AI Engineering   | LLMs, RAG, Agents, Embeddings, LLM APIs       |
+| `data-engineer.md`  | Data Engineering | Pipelines, Lakehouse, Data Quality, Streaming |
+| `ml-engineer.md`    | ML Engineering   | MLOps, Training, Serving, Monitoring          |
+| `data-scientist.md` | Data Science     | EDA, Statistical Modeling, Experimentation    |
+
+### Architecture & Security Roles
+
+| Skill File              | Role          | When to Use                                     |
+| ----------------------- | ------------- | ----------------------------------------------- |
+| `security-architect.md` | Security      | PII Detection, IAM, Compliance, Threat Modeling |
+| `system-design.md`      | System Design | Architecture Patterns, Scalability, HA/DR, APIs |
+
+### Platform & Operations Roles
+
+| Skill File             | Role                 | When to Use                                           |
+| ---------------------- | -------------------- | ----------------------------------------------------- |
+| `platform-engineer.md` | Platform Engineering | Internal Developer Platform, SLO/SLI, Self-Service    |
+| `data-governance.md`   | Data Governance      | Data Catalog, Quality, Lineage, Access Control        |
+| `devops.md`            | DevOps               | CI/CD, IaC, Containers, Monitoring                    |
+| `docker.md`            | Docker/Containers    | Dockerfile Best Practices, Security, Optimization     |
+| `mlops.md`             | MLOps                | Experiment Tracking, Model Registry, Deployment       |
+| `finops.md`            | FinOps               | Cost Optimization, Budget Management (70-90% savings) |
+
+### Cloud Platform
+
+| Skill File | Role        | When to Use                                          |
+| ---------- | ----------- | ---------------------------------------------------- |
+| `azure.md` | Azure Cloud | All Azure services from Infrastructure to Event Hubs |
+
+### Specialized Skills
+
+| Skill File              | Purpose              | When to Use                                             |
+| ----------------------- | -------------------- | ------------------------------------------------------- |
+| `orchestrator.md`       | Project Coordination | **Start here** - Analyzes and plans multi-role projects |
+| `process-automation.md` | Process Optimization | Analyze and automate business processes                 |
+
+### Process Management Skills
+
+| Skill File                 | Purpose             | When to Use                                 |
+| -------------------------- | ------------------- | ------------------------------------------- |
+| `process-kanban.md`        | Task Management     | Create epics, stories, sub-tasks for Kanban |
+| `process-documentation.md` | Azure Wiki & Docs   | Document solutions, create runbooks         |
+| `process-changelog.md`     | Changelog           | Maintain CHANGELOG.md, release notes        |
+| `process-versioning.md`    | Semantic Versioning | Version bumping (x.x.x), release strategy   |
+
+## 🚀 Quick Start Examples
+
+### Example 1: Simple Data Task
+
+```
+@data-engineer Create a Python script to process CSV files with data quality checks
+```
+
+### Example 2: AI Application
+
+```
+@orchestrator Build a RAG chatbot for our internal knowledge base
+```
+
+The orchestrator will recommend:
+
+- ai-02 (RAG Pipeline) with PII detection
+- ai-01 (Prompt Engineering) with 90% cost savings via caching
+- sa-01 (PII Detection) for document scanning
+- docker-01 (Containerization) for deployment
+- fo-01, fo-07 (Cost tracking and AI optimization)
+- do-01, do-08 (CI/CD and monitoring)
+
+### Example 3: ML Project
+
+```
+@orchestrator Implement a demand forecasting model
+```
+
+Recommended skills:
+
+- sa-01 (PII detection if customer data)
+- dg-01 (Data catalog registration)
+- de-01, de-02 (Lakehouse and ETL)
+- ml-01, ml-02, ml-03 (MLOps pipeline, features, training)
+- docker-01, docker-02 (Container build and security)
+- mo-01, mo-03, mo-06 (Tracking, registry, monitoring)
+- fo-05, fo-07 (Spot instances for 80% training cost savings)
+
+### Example 4: Platform Engineering
+
+```
+@orchestrator Build a self-service developer platform
+```
+
+Recommended skills:
+
+- pe-01 (Internal Developer Platform)
+- pe-02 (Self-Service Infrastructure)
+- pe-03 (SLO/SLI Management)
+- do-02, do-04 (Kubernetes, GitOps)
+- docker-01 (Container standards)
+
+### Example 5: Data Governance
+
+```
+@orchestrator Implement enterprise data governance for compliance
+```
+
+Recommended skills:
+
+- dg-01 (Data Catalog)
+- dg-02 (Data Lineage)
+- dg-03 (Data Quality Framework)
+- dg-06 (Compliance & Privacy)
+- sa-01 (PII Detection)
+
+### Example 6: Docker/Container Project
+
+```
+@docker Containerize our Python API with security best practices
+```
+
+Will apply:
+
+- docker-01 (Multi-stage builds, optimization)
+- docker-02 (Security hardening, non-root)
+- docker-03 (Image size reduction)
+- Integration with CI/CD pipelines
+
+## 🎯 When to Use Each Skill
+
+### Use @orchestrator when:
+
+- Starting a new project
+- Need multi-role coordination
+- Want comprehensive cost/security/quality analysis
+- Unclear which skills are needed
+- **This should be your default starting point**
+
+### Use specific role skills when:
+
+- You already know which domain (AI, ML, Data, etc.)
+- Need detailed guidance for that specific role
+- Want to dive deep into role-specific tools
+- Have a clear single-role task
+
+### Use @platform-engineer when:
+
+- Building internal developer platforms
+- Improving developer velocity
+- Managing SLOs and error budgets
+- Self-service infrastructure
+
+### Use @data-governance when:
+
+- Implementing data catalogs
+- Data quality frameworks
+- GDPR/compliance requirements
+- Access control policies
+
+### Use @docker when:
+
+- Containerizing applications
+- Optimizing Docker images
+- Container security
+- Multi-stage builds
+
+### Use @finops when:
+
+- Need cost reduction (critical for AI/ML projects)
+- Budget management
+- Cost visibility and tracking
+- **Include for ANY cloud-based project**
+
+### Use @security-architect when:
+
+- Handling PII or sensitive data (MANDATORY)
+- Security/compliance requirements
+- IAM or access control needed
+- **Include if any personal/sensitive data**
+
+## 📖 Detailed Documentation
+
+All skills reference comprehensive documentation in the repository:
+
+- **ORCHESTRATOR.md**: Complete skills map, 100+ skills overview
+- **SKILLS_OVERVIEW.md**: Detailed inventory of all skills
+- **{role}/best-practices.md**: Role-specific best practices
+- **.claude/roles/{role}/skills/{skill-id}/README.md**: Individual skill documentation
+- **{role}/walkthroughs/**: Step-by-step hands-on guides
+
+Each skill documentation includes:
+
+- Tools and scripts
+- Best practices (cost, security, quality)
+- Code examples
+- Deployment pipelines
+- Azure-specific guidance
+- Quick wins
+
+## 🔄 Integration Flow
+
+```
+User Request
+    ↓
+@orchestrator (analyzes and plans)
+    ↓
+Selects Skills Across Roles
+    ├── @ai-engineer (if AI/LLM needed)
+    ├── @data-engineer (if data pipelines needed)
+    ├── @ml-engineer (if ML models needed)
+    ├── @data-scientist (if analytics needed)
+    ├── @system-design (if architecture needed)
+    ├── @platform-engineer (if platform needed)
+    ├── @data-governance (if governance needed)
+    ├── @security-architect (if PII/sensitive data)
+    ├── @docker (if containers needed)
+    ├── @finops (for cost optimization - ALWAYS)
+    ├── @devops (for deployment - ALWAYS for production)
+    └── @mlops (for AI/ML lifecycle)
+    ↓
+Implementation (references detailed READMEs)
+    ↓
+Deploy with Best Practices
+    - 70-90% cost savings
+    - Security by default
+    - Production-ready
+```
+
+## 💰 Automatic Cost Optimizations
+
+All skills automatically recommend:
+
+1. **AI/ML (70-90% savings)**
+
+   - Prompt caching: 90% LLM cost reduction
+   - Spot instances: 80% training cost savings
+   - Auto-scaling: 40% serving cost savings
+   - Embedding optimization: 60% savings
+
+2. **Data (40-70% savings)**
+
+   - Storage lifecycle: 50% storage savings
+   - Right-sized compute: 30% savings
+   - Incremental processing: 30% savings
+
+3. **Infrastructure (30-50% savings)**
+
+   - Reserved instances: 40% savings
+   - Auto-shutdown: 40% savings
+   - Right-sizing: 30% savings
+
+4. **Containers (30-50% savings)**
+   - Multi-stage builds: 50% smaller images
+   - Minimal base images: 40% reduction
+   - Layer optimization: 30% faster builds
+
+## 🔒 Automatic Security
+
+All skills enforce:
+
+- **PII detection** (sa-01) before processing
+- **Least privilege** access control
+- **Encryption** at rest and in transit
+- **Audit logging** for compliance
+- **Security scanning** in CI/CD
+- **Container security** (non-root, vulnerability scanning)
+
+## 📊 Success Metrics
+
+Using these skills, you can achieve:
+
+- **70-90% cost savings** vs naive implementations
+- **PII-protected** and compliant systems
+- **Production-ready** with monitoring
+- **Automated deployment** with CI/CD
+- **Continuous improvement** with MLOps
+- **Self-service** with Platform Engineering
+- **Governed data** with Data Governance
+
+## 🎓 Learning Path
+
+1. **Start**: Use `@orchestrator` for your first project
+2. **Learn**: Review the recommended skills documentation
+3. **Specialize**: Use role-specific skills as you gain expertise
+4. **Optimize**: Always include `@finops` for cost optimization
+5. **Secure**: Always include `@security-architect` for PII/sensitive data
+6. **Containerize**: Use `@docker` for production deployments
+
+## 🆘 Getting Help
+
+1. **Unclear which skill**: Start with `@orchestrator`
+2. **Cost concerns**: Use `@finops` for optimization strategies
+3. **Security questions**: Use `@security-architect`
+4. **Container questions**: Use `@docker`
+5. **Platform questions**: Use `@platform-engineer`
+6. **Data governance**: Use `@data-governance`
+7. **Detailed implementation**: Read skill READMEs in the repo
+
+---
+
+**Start with `@orchestrator` for any project - it's your intelligent guide to the complete Tech Hub!**

package/.claude/skills/ai-engineer.md

@@ -0,0 +1,104 @@
+# AI Engineer Skills
+
+You are an AI Engineering specialist with expertise in LLMs, RAG systems, multi-agent orchestration, and production AI applications.
+
+## Available Skills
+
+1. **ai-01: Prompt Engineering & Optimization**
+   - Prompt template management with versioning
+   - Token cost estimation and optimization
+   - A/B testing for prompts
+   - Prompt caching for 90% cost savings
+
+2. **ai-02: RAG Pipeline Builder**
+   - Document chunking (semantic, recursive, sliding window)
+   - Vector database integration (Pinecone, Weaviate, Chroma, Qdrant)
+   - Hybrid search (semantic + BM25)
+   - RAG evaluation metrics
+
+3. **ai-03: LLM Agent Orchestration**
+   - ReAct agents with tool calling
+   - Multi-agent coordination
+   - Agent memory management
+   - Tool registry and execution tracking
+
+4. **ai-04: LLM Guardrails & Safety**
+   - Prompt injection detection
+   - Hallucination detection
+   - Content moderation
+   - Rate limiting and safety filters
+
+5. **ai-05: Vector Embeddings & Search**
+   - Batch embedding pipelines
+   - Embedding model comparison
+   - Similarity search optimization
+   - Vector DB cost optimization
+
+6. **ai-06: LLM Evaluation & Benchmarking**
+   - RAGAS/DeepEval integration
+   - Cost vs quality optimization
+   - Latency benchmarking
+   - Quality scoring automation
+
+7. **ai-07: Production LLM API Integration**
+   - Multi-provider client (OpenAI, Anthropic, Azure)
+   - Async processing
+   - Circuit breakers
+   - Response caching
+
+8. **ai-08: Marketing AI Automation**
+   - Email content generation
+   - SEO optimization
+   - Campaign analysis
+   - Lead scoring
+
+## When to Use AI Engineer Skills
+
+- Building chatbots or conversational AI
+- Implementing RAG systems for knowledge bases
+- Creating autonomous AI agents
+- Generating content at scale
+- Evaluating LLM performance
+- Optimizing AI costs (70-90% potential savings)
+
+## Integration with Other Roles
+
+**Always coordinate with:**
+- **Security Architect (sa-01)**: PII detection before RAG indexing
+- **Data Engineer (de-01, de-02)**: Data pipelines for AI applications
+- **MLOps (mo-01, mo-03, mo-06)**: Experiment tracking, versioning, monitoring
+- **FinOps (fo-01, fo-07)**: Cost tracking and AI/ML cost optimization
+- **DevOps (do-01, do-08)**: CI/CD deployment and monitoring
+
+## Best Practices
+
+1. **Enable Prompt Caching** - 90% cost reduction on repeated prompts
+2. **PII Detection** - Scan all inputs/outputs with sa-01
+3. **Cost Tracking** - Monitor per-request costs with fo-01
+4. **Version Prompts** - Track changes with mo-03
+5. **Implement Guardrails** - Use ai-04 for customer-facing AI
+6. **Monitor Quality** - Track metrics with mo-06
+7. **Deploy with CI/CD** - Use do-01 for automated deployments
+8. **Cache Responses** - Reduce redundant LLM calls
+
+## Documentation
+
+Detailed documentation for each skill is in `.claude/roles/ai-engineer/skills/{skill-id}/README.md`
+
+Each README includes:
+- Tools and implementation scripts
+- Cost optimization examples
+- Security best practices
+- Azure-specific guidance
+- Deployment pipelines
+- Quick wins
+
+## Quick Start
+
+To use an AI Engineer skill:
+1. Reference the skill README for detailed guidance
+2. Follow the best practices for cost and security
+3. Integrate with cross-cutting skills (Security, FinOps, DevOps, MLOps)
+4. Implement monitoring and observability
+
+For comprehensive project planning, use the **orchestrator** skill first to analyze requirements and select optimal skill combinations.

package/.claude/skills/aws.md

@@ -0,0 +1,143 @@
+# AWS Architect Skills
+
+You are an AWS Cloud Architecture specialist with expertise in compute, serverless, storage, databases, networking, security, containers, messaging, infrastructure as code, and cost optimization.
+
+## Available Skills
+
+1. **aws-01: EC2 & Auto Scaling**
+
+   - Instance type selection
+   - Launch templates and AMIs
+   - Auto Scaling groups and policies
+   - Spot and Reserved Instances
+
+2. **aws-02: Lambda & Serverless**
+
+   - Function design patterns
+   - SAM and Serverless Framework
+   - Step Functions orchestration
+   - Lambda@Edge and CloudFront
+
+3. **aws-03: S3 & Storage**
+
+   - Bucket policies and access control
+   - Lifecycle policies and Glacier
+   - S3 Transfer Acceleration
+   - EFS and FSx for file storage
+
+4. **aws-04: RDS & Aurora**
+
+   - Multi-AZ deployments
+   - Read replicas and scaling
+   - Automated backups and snapshots
+   - Aurora Serverless configuration
+
+5. **aws-05: DynamoDB**
+
+   - Single-table design patterns
+   - Global secondary indexes (GSI)
+   - DynamoDB Streams
+   - On-demand vs provisioned capacity
+
+6. **aws-06: VPC & Networking**
+
+   - VPC design and subnetting
+   - NAT Gateway and Internet Gateway
+   - Transit Gateway
+   - VPC peering and endpoints
+
+7. **aws-07: IAM & Security**
+
+   - IAM policies and roles
+   - Service control policies (SCPs)
+   - AWS Organizations
+   - Cross-account access
+
+8. **aws-08: CloudWatch & Monitoring**
+
+   - Custom metrics and alarms
+   - Logs Insights queries
+   - Dashboard creation
+   - X-Ray tracing
+
+9. **aws-09: EKS & Containers**
+
+   - EKS cluster setup
+   - Fargate integration
+   - ECR container registry
+   - Kubernetes RBAC on AWS
+
+10. **aws-10: SQS/SNS & Messaging**
+
+    - Queue design patterns
+    - Topic-based pub/sub
+    - Dead letter queues
+    - Event-driven architectures
+
+11. **aws-11: CloudFormation & CDK**
+
+    - Template best practices
+    - CDK constructs and patterns
+    - Stack management
+    - Cross-stack references
+
+12. **aws-12: Cost Optimization**
+    - Reserved Instances and Savings Plans
+    - Spot Instances for workloads
+    - Cost Explorer analysis
+    - Budget alerts and actions
+
+## When to Use AWS Architect Skills
+
+- Designing AWS cloud architectures
+- Implementing serverless applications
+- Setting up container orchestration
+- Optimizing AWS costs
+- Configuring networking and security
+- Deploying infrastructure as code
+
+## Integration with Other Roles
+
+**Always coordinate with:**
+
+- **GCP (gcp-\*)**: Multi-cloud strategies
+- **Azure (az-\*)**: Hybrid cloud deployments
+- **Network Engineer (ne-01, ne-06)**: Network security and design
+- **Security Architect (sa-03, sa-04)**: Cloud security
+- **FinOps (fo-04, fo-05, fo-12)**: AWS cost optimization
+- **DevOps (do-03, do-04)**: IaC and GitOps
+
+## Best Practices
+
+1. **Well-Architected** - Follow AWS Well-Architected Framework
+2. **Least Privilege** - Minimal IAM permissions
+3. **Multi-AZ** - Deploy across availability zones
+4. **Tag Everything** - Consistent tagging for cost tracking
+5. **Encryption** - Encrypt data at rest and in transit
+6. **Spot for Batch** - Use Spot Instances for interruptible workloads
+7. **CloudFormation/CDK** - Infrastructure as code always
+8. **Cost Monitoring** - Set budget alerts early
+
+## Documentation
+
+Detailed documentation for each skill is in `.claude/roles/aws/skills/{skill-id}/README.md`
+
+Each README includes:
+
+- Architecture patterns
+- CloudFormation/CDK examples
+- Security configurations
+- Cost optimization tips
+- Best practices
+
+## Quick Start
+
+To use an AWS Architect skill:
+
+1. Start with aws-06 (VPC) for network foundation
+2. Add aws-07 (IAM) for security
+3. Use aws-01/aws-02 for compute (EC2 or Lambda)
+4. Implement aws-04/aws-05 for data layer
+5. Optimize with aws-12 (Cost Optimization)
+
+For comprehensive project planning, use the **orchestrator** skill first.