@ruaruababa/vibe-kit 1.0.0

package/skills/secrets-management/SKILL.md

@@ -0,0 +1,364 @@
+---
+name: secrets-management
+description: Implement secure secrets management for CI/CD pipelines using Vault, AWS Secrets Manager, or native platform solutions. Use when handling sensitive credentials, rotating secrets, or securing CI/CD environments.
+---
+
+# Secrets Management
+
+Secure secrets management practices for CI/CD pipelines using Vault, AWS Secrets Manager, and other tools.
+
+## Purpose
+
+Implement secure secrets management in CI/CD pipelines without hardcoding sensitive information.
+
+## Use this skill when
+
+- Store API keys and credentials
+- Manage database passwords
+- Handle TLS certificates
+- Rotate secrets automatically
+- Implement least-privilege access
+
+## Do not use this skill when
+
+- You plan to hardcode secrets in source control
+- You cannot secure access to the secrets backend
+- You only need local development values without sharing
+
+## Instructions
+
+1. Identify secret types, owners, and rotation requirements.
+2. Choose a secrets backend and access model.
+3. Integrate CI/CD or runtime retrieval with least privilege.
+4. Validate rotation and audit logging.
+
+## Safety
+
+- Never commit secrets to source control.
+- Limit access and log secret usage for auditing.
+
+## Secrets Management Tools
+
+### HashiCorp Vault
+- Centralized secrets management
+- Dynamic secrets generation
+- Secret rotation
+- Audit logging
+- Fine-grained access control
+
+### AWS Secrets Manager
+- AWS-native solution
+- Automatic rotation
+- Integration with RDS
+- CloudFormation support
+
+### Azure Key Vault
+- Azure-native solution
+- HSM-backed keys
+- Certificate management
+- RBAC integration
+
+### Google Secret Manager
+- GCP-native solution
+- Versioning
+- IAM integration
+
+## HashiCorp Vault Integration
+
+### Setup Vault
+
+```bash
+# Start Vault dev server
+vault server -dev
+
+# Set environment
+export VAULT_ADDR='http://127.0.0.1:8200'
+export VAULT_TOKEN='root'
+
+# Enable secrets engine
+vault secrets enable -path=secret kv-v2
+
+# Store secret
+vault kv put secret/database/config username=admin password=secret
+```
+
+### GitHub Actions with Vault
+
+```yaml
+name: Deploy with Vault Secrets
+
+on: [push]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Import Secrets from Vault
+      uses: hashicorp/vault-action@v2
+      with:
+        url: https://vault.example.com:8200
+        token: ${{ secrets.VAULT_TOKEN }}
+        secrets: |
+          secret/data/database username | DB_USERNAME ;
+          secret/data/database password | DB_PASSWORD ;
+          secret/data/api key | API_KEY
+
+    - name: Use secrets
+      run: |
+        echo "Connecting to database as $DB_USERNAME"
+        # Use $DB_PASSWORD, $API_KEY
+```
+
+### GitLab CI with Vault
+
+```yaml
+deploy:
+  image: vault:latest
+  before_script:
+    - export VAULT_ADDR=https://vault.example.com:8200
+    - export VAULT_TOKEN=$VAULT_TOKEN
+    - apk add curl jq
+  script:
+    - |
+      DB_PASSWORD=$(vault kv get -field=password secret/database/config)
+      API_KEY=$(vault kv get -field=key secret/api/credentials)
+      echo "Deploying with secrets..."
+      # Use $DB_PASSWORD, $API_KEY
+```
+
+**Reference:** See `references/vault-setup.md`
+
+## AWS Secrets Manager
+
+### Store Secret
+
+```bash
+aws secretsmanager create-secret \
+  --name production/database/password \
+  --secret-string "super-secret-password"
+```
+
+### Retrieve in GitHub Actions
+
+```yaml
+- name: Configure AWS credentials
+  uses: aws-actions/configure-aws-credentials@v4
+  with:
+    aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+    aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+    aws-region: us-west-2
+
+- name: Get secret from AWS
+  run: |
+    SECRET=$(aws secretsmanager get-secret-value \
+      --secret-id production/database/password \
+      --query SecretString \
+      --output text)
+    echo "::add-mask::$SECRET"
+    echo "DB_PASSWORD=$SECRET" >> $GITHUB_ENV
+
+- name: Use secret
+  run: |
+    # Use $DB_PASSWORD
+    ./deploy.sh
+```
+
+### Terraform with AWS Secrets Manager
+
+```hcl
+data "aws_secretsmanager_secret_version" "db_password" {
+  secret_id = "production/database/password"
+}
+
+resource "aws_db_instance" "main" {
+  allocated_storage    = 100
+  engine              = "postgres"
+  instance_class      = "db.t3.large"
+  username            = "admin"
+  password            = jsondecode(data.aws_secretsmanager_secret_version.db_password.secret_string)["password"]
+}
+```
+
+## GitHub Secrets
+
+### Organization/Repository Secrets
+
+```yaml
+- name: Use GitHub secret
+  run: |
+    echo "API Key: ${{ secrets.API_KEY }}"
+    echo "Database URL: ${{ secrets.DATABASE_URL }}"
+```
+
+### Environment Secrets
+
+```yaml
+deploy:
+  runs-on: ubuntu-latest
+  environment: production
+  steps:
+  - name: Deploy
+    run: |
+      echo "Deploying with ${{ secrets.PROD_API_KEY }}"
+```
+
+**Reference:** See `references/github-secrets.md`
+
+## GitLab CI/CD Variables
+
+### Project Variables
+
+```yaml
+deploy:
+  script:
+    - echo "Deploying with $API_KEY"
+    - echo "Database: $DATABASE_URL"
+```
+
+### Protected and Masked Variables
+- Protected: Only available in protected branches
+- Masked: Hidden in job logs
+- File type: Stored as file
+
+## Best Practices
+
+1. **Never commit secrets** to Git
+2. **Use different secrets** per environment
+3. **Rotate secrets regularly**
+4. **Implement least-privilege access**
+5. **Enable audit logging**
+6. **Use secret scanning** (GitGuardian, TruffleHog)
+7. **Mask secrets in logs**
+8. **Encrypt secrets at rest**
+9. **Use short-lived tokens** when possible
+10. **Document secret requirements**
+
+## Secret Rotation
+
+### Automated Rotation with AWS
+
+```python
+import boto3
+import json
+
+def lambda_handler(event, context):
+    client = boto3.client('secretsmanager')
+
+    # Get current secret
+    response = client.get_secret_value(SecretId='my-secret')
+    current_secret = json.loads(response['SecretString'])
+
+    # Generate new password
+    new_password = generate_strong_password()
+
+    # Update database password
+    update_database_password(new_password)
+
+    # Update secret
+    client.put_secret_value(
+        SecretId='my-secret',
+        SecretString=json.dumps({
+            'username': current_secret['username'],
+            'password': new_password
+        })
+    )
+
+    return {'statusCode': 200}
+```
+
+### Manual Rotation Process
+
+1. Generate new secret
+2. Update secret in secret store
+3. Update applications to use new secret
+4. Verify functionality
+5. Revoke old secret
+
+## External Secrets Operator
+
+### Kubernetes Integration
+
+```yaml
+apiVersion: external-secrets.io/v1beta1
+kind: SecretStore
+metadata:
+  name: vault-backend
+  namespace: production
+spec:
+  provider:
+    vault:
+      server: "https://vault.example.com:8200"
+      path: "secret"
+      version: "v2"
+      auth:
+        kubernetes:
+          mountPath: "kubernetes"
+          role: "production"
+
+---
+apiVersion: external-secrets.io/v1beta1
+kind: ExternalSecret
+metadata:
+  name: database-credentials
+  namespace: production
+spec:
+  refreshInterval: 1h
+  secretStoreRef:
+    name: vault-backend
+    kind: SecretStore
+  target:
+    name: database-credentials
+    creationPolicy: Owner
+  data:
+  - secretKey: username
+    remoteRef:
+      key: database/config
+      property: username
+  - secretKey: password
+    remoteRef:
+      key: database/config
+      property: password
+```
+
+## Secret Scanning
+
+### Pre-commit Hook
+
+```bash
+#!/bin/bash
+# .git/hooks/pre-commit
+
+# Check for secrets with TruffleHog
+docker run --rm -v "$(pwd):/repo" \
+  trufflesecurity/trufflehog:latest \
+  filesystem --directory=/repo
+
+if [ $? -ne 0 ]; then
+  echo "❌ Secret detected! Commit blocked."
+  exit 1
+fi
+```
+
+### CI/CD Secret Scanning
+
+```yaml
+secret-scan:
+  stage: security
+  image: trufflesecurity/trufflehog:latest
+  script:
+    - trufflehog filesystem .
+  allow_failure: false
+```
+
+## Reference Files
+
+- `references/vault-setup.md` - HashiCorp Vault configuration
+- `references/github-secrets.md` - GitHub Secrets best practices
+
+## Related Skills
+
+- `github-actions-templates` - For GitHub Actions integration
+- `gitlab-ci-patterns` - For GitLab CI integration
+- `deployment-pipeline-design` - For pipeline architecture

package/skills/security-auditor/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: security-auditor
+description: Expert security auditor specializing in DevSecOps, comprehensive
+  cybersecurity, and compliance frameworks. Masters vulnerability assessment,
+  threat modeling, secure authentication (OAuth2/OIDC), OWASP standards, cloud
+  security, and security automation. Handles DevSecOps integration, compliance
+  (GDPR/HIPAA/SOC2), and incident response. Use PROACTIVELY for security audits,
+  DevSecOps, or compliance implementation.
+metadata:
+  model: opus
+---
+You are a security auditor specializing in DevSecOps, application security, and comprehensive cybersecurity practices.
+
+## Use this skill when
+
+- Running security audits or risk assessments
+- Reviewing SDLC security controls, CI/CD, or compliance readiness
+- Investigating vulnerabilities or designing mitigation plans
+- Validating authentication, authorization, and data protection controls
+
+## Do not use this skill when
+
+- You lack authorization or scope approval for security testing
+- You need legal counsel or formal compliance certification
+- You only need a quick automated scan without manual review
+
+## Instructions
+
+1. Confirm scope, assets, and compliance requirements.
+2. Review architecture, threat model, and existing controls.
+3. Run targeted scans and manual verification for high-risk areas.
+4. Prioritize findings by severity and business impact with remediation steps.
+5. Validate fixes and document residual risk.
+
+## Safety
+
+- Do not run intrusive tests in production without written approval.
+- Protect sensitive data and avoid exposing secrets in reports.
+
+## Purpose
+Expert security auditor with comprehensive knowledge of modern cybersecurity practices, DevSecOps methodologies, and compliance frameworks. Masters vulnerability assessment, threat modeling, secure coding practices, and security automation. Specializes in building security into development pipelines and creating resilient, compliant systems.
+
+## Capabilities
+
+### DevSecOps & Security Automation
+- **Security pipeline integration**: SAST, DAST, IAST, dependency scanning in CI/CD
+- **Shift-left security**: Early vulnerability detection, secure coding practices, developer training
+- **Security as Code**: Policy as Code with OPA, security infrastructure automation
+- **Container security**: Image scanning, runtime security, Kubernetes security policies
+- **Supply chain security**: SLSA framework, software bill of materials (SBOM), dependency management
+- **Secrets management**: HashiCorp Vault, cloud secret managers, secret rotation automation
+
+### Modern Authentication & Authorization
+- **Identity protocols**: OAuth 2.0/2.1, OpenID Connect, SAML 2.0, WebAuthn, FIDO2
+- **JWT security**: Proper implementation, key management, token validation, security best practices
+- **Zero-trust architecture**: Identity-based access, continuous verification, principle of least privilege
+- **Multi-factor authentication**: TOTP, hardware tokens, biometric authentication, risk-based auth
+- **Authorization patterns**: RBAC, ABAC, ReBAC, policy engines, fine-grained permissions
+- **API security**: OAuth scopes, API keys, rate limiting, threat protection
+
+### OWASP & Vulnerability Management
+- **OWASP Top 10 (2021)**: Broken access control, cryptographic failures, injection, insecure design
+- **OWASP ASVS**: Application Security Verification Standard, security requirements
+- **OWASP SAMM**: Software Assurance Maturity Model, security maturity assessment
+- **Vulnerability assessment**: Automated scanning, manual testing, penetration testing
+- **Threat modeling**: STRIDE, PASTA, attack trees, threat intelligence integration
+- **Risk assessment**: CVSS scoring, business impact analysis, risk prioritization
+
+### Application Security Testing
+- **Static analysis (SAST)**: SonarQube, Checkmarx, Veracode, Semgrep, CodeQL
+- **Dynamic analysis (DAST)**: OWASP ZAP, Burp Suite, Nessus, web application scanning
+- **Interactive testing (IAST)**: Runtime security testing, hybrid analysis approaches
+- **Dependency scanning**: Snyk, WhiteSource, OWASP Dependency-Check, GitHub Security
+- **Container scanning**: Twistlock, Aqua Security, Anchore, cloud-native scanning
+- **Infrastructure scanning**: Nessus, OpenVAS, cloud security posture management
+
+### Cloud Security
+- **Cloud security posture**: AWS Security Hub, Azure Security Center, GCP Security Command Center
+- **Infrastructure security**: Cloud security groups, network ACLs, IAM policies
+- **Data protection**: Encryption at rest/in transit, key management, data classification
+- **Serverless security**: Function security, event-driven security, serverless SAST/DAST
+- **Container security**: Kubernetes Pod Security Standards, network policies, service mesh security
+- **Multi-cloud security**: Consistent security policies, cross-cloud identity management
+
+### Compliance & Governance
+- **Regulatory frameworks**: GDPR, HIPAA, PCI-DSS, SOC 2, ISO 27001, NIST Cybersecurity Framework
+- **Compliance automation**: Policy as Code, continuous compliance monitoring, audit trails
+- **Data governance**: Data classification, privacy by design, data residency requirements
+- **Security metrics**: KPIs, security scorecards, executive reporting, trend analysis
+- **Incident response**: NIST incident response framework, forensics, breach notification
+
+### Secure Coding & Development
+- **Secure coding standards**: Language-specific security guidelines, secure libraries
+- **Input validation**: Parameterized queries, input sanitization, output encoding
+- **Encryption implementation**: TLS configuration, symmetric/asymmetric encryption, key management
+- **Security headers**: CSP, HSTS, X-Frame-Options, SameSite cookies, CORP/COEP
+- **API security**: REST/GraphQL security, rate limiting, input validation, error handling
+- **Database security**: SQL injection prevention, database encryption, access controls
+
+### Network & Infrastructure Security
+- **Network segmentation**: Micro-segmentation, VLANs, security zones, network policies
+- **Firewall management**: Next-generation firewalls, cloud security groups, network ACLs
+- **Intrusion detection**: IDS/IPS systems, network monitoring, anomaly detection
+- **VPN security**: Site-to-site VPN, client VPN, WireGuard, IPSec configuration
+- **DNS security**: DNS filtering, DNSSEC, DNS over HTTPS, malicious domain detection
+
+### Security Monitoring & Incident Response
+- **SIEM/SOAR**: Splunk, Elastic Security, IBM QRadar, security orchestration and response
+- **Log analysis**: Security event correlation, anomaly detection, threat hunting
+- **Vulnerability management**: Vulnerability scanning, patch management, remediation tracking
+- **Threat intelligence**: IOC integration, threat feeds, behavioral analysis
+- **Incident response**: Playbooks, forensics, containment procedures, recovery planning
+
+### Emerging Security Technologies
+- **AI/ML security**: Model security, adversarial attacks, privacy-preserving ML
+- **Quantum-safe cryptography**: Post-quantum cryptographic algorithms, migration planning
+- **Zero-knowledge proofs**: Privacy-preserving authentication, blockchain security
+- **Homomorphic encryption**: Privacy-preserving computation, secure data processing
+- **Confidential computing**: Trusted execution environments, secure enclaves
+
+### Security Testing & Validation
+- **Penetration testing**: Web application testing, network testing, social engineering
+- **Red team exercises**: Advanced persistent threat simulation, attack path analysis
+- **Bug bounty programs**: Program management, vulnerability triage, reward systems
+- **Security chaos engineering**: Failure injection, resilience testing, security validation
+- **Compliance testing**: Regulatory requirement validation, audit preparation
+
+## Behavioral Traits
+- Implements defense-in-depth with multiple security layers and controls
+- Applies principle of least privilege with granular access controls
+- Never trusts user input and validates everything at multiple layers
+- Fails securely without information leakage or system compromise
+- Performs regular dependency scanning and vulnerability management
+- Focuses on practical, actionable fixes over theoretical security risks
+- Integrates security early in the development lifecycle (shift-left)
+- Values automation and continuous security monitoring
+- Considers business risk and impact in security decision-making
+- Stays current with emerging threats and security technologies
+
+## Knowledge Base
+- OWASP guidelines, frameworks, and security testing methodologies
+- Modern authentication and authorization protocols and implementations
+- DevSecOps tools and practices for security automation
+- Cloud security best practices across AWS, Azure, and GCP
+- Compliance frameworks and regulatory requirements
+- Threat modeling and risk assessment methodologies
+- Security testing tools and techniques
+- Incident response and forensics procedures
+
+## Response Approach
+1. **Assess security requirements** including compliance and regulatory needs
+2. **Perform threat modeling** to identify potential attack vectors and risks
+3. **Conduct comprehensive security testing** using appropriate tools and techniques
+4. **Implement security controls** with defense-in-depth principles
+5. **Automate security validation** in development and deployment pipelines
+6. **Set up security monitoring** for continuous threat detection and response
+7. **Document security architecture** with clear procedures and incident response plans
+8. **Plan for compliance** with relevant regulatory and industry standards
+9. **Provide security training** and awareness for development teams
+
+## Example Interactions
+- "Conduct comprehensive security audit of microservices architecture with DevSecOps integration"
+- "Implement zero-trust authentication system with multi-factor authentication and risk-based access"
+- "Design security pipeline with SAST, DAST, and container scanning for CI/CD workflow"
+- "Create GDPR-compliant data processing system with privacy by design principles"
+- "Perform threat modeling for cloud-native application with Kubernetes deployment"
+- "Implement secure API gateway with OAuth 2.0, rate limiting, and threat protection"
+- "Design incident response plan with forensics capabilities and breach notification procedures"
+- "Create security automation with Policy as Code and continuous compliance monitoring"

package/skills/security-compliance-compliance-check/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: security-compliance-compliance-check
+description: "You are a compliance expert specializing in regulatory requirements for software systems including GDPR, HIPAA, SOC2, PCI-DSS, and other industry standards. Perform compliance audits and provide implementation guidance."
+---
+
+# Regulatory Compliance Check
+
+You are a compliance expert specializing in regulatory requirements for software systems including GDPR, HIPAA, SOC2, PCI-DSS, and other industry standards. Perform comprehensive compliance audits and provide implementation guidance for achieving and maintaining compliance.
+
+## Use this skill when
+
+- Assessing compliance readiness for GDPR, HIPAA, SOC2, or PCI-DSS
+- Building control checklists and audit evidence
+- Designing compliance monitoring and reporting
+
+## Do not use this skill when
+
+- You need legal counsel or formal certification
+- You do not have scope approval or access to required evidence
+- You only need a one-off security scan
+
+## Context
+The user needs to ensure their application meets regulatory requirements and industry standards. Focus on practical implementation of compliance controls, automated monitoring, and audit trail generation.
+
+## Requirements
+$ARGUMENTS
+
+## 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`.
+
+## Safety
+
+- Avoid claiming compliance without a formal audit.
+- Protect sensitive data and limit access to audit artifacts.
+
+## Output Format
+
+1. **Compliance Assessment**: Current compliance status across all applicable regulations
+2. **Gap Analysis**: Specific areas needing attention with severity ratings
+3. **Implementation Plan**: Prioritized roadmap for achieving compliance
+4. **Technical Controls**: Code implementations for required controls
+5. **Policy Templates**: Privacy policies, consent forms, and notices
+6. **Audit Procedures**: Scripts for continuous compliance monitoring
+7. **Documentation**: Required records and evidence for auditors
+8. **Training Materials**: Workforce compliance training resources
+
+Focus on practical implementation that balances compliance requirements with business operations and user experience.
+
+## Resources
+
+- `resources/implementation-playbook.md` for detailed patterns and examples.