Claude Code Plugins

Community-maintained marketplace

Feedback

deployment-audit-skill

@CleanExpo/Unite-Hub
1
0

Use DigitalOcean MCP and related tools to check deployment health, crash logs, environment consistency, and runtime issues for Unite-Hub / Synthex. Use when diagnosing deployment failures or verifying readiness.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name deployment-audit-skill
description Use DigitalOcean MCP and related tools to check deployment health, crash logs, environment consistency, and runtime issues for Unite-Hub / Synthex. Use when diagnosing deployment failures or verifying readiness.
allowed-tools Run, Read

Deployment Audit Skill

Purpose

Continuously monitor and troubleshoot deployments on DigitalOcean and Vercel for Synthex / Unite-Hub.

Typical Tasks

  1. Retrieve crash logs via DO CLI / MCP
    • doctl apps list
    • doctl apps logs <app-id> --type=run_restarted
    • doctl apps logs <app-id> <component> --type=run_restarted
  2. Check environment variable consistency across:
    • .env.local
    • Vercel project settings
    • DigitalOcean app spec
  3. Validate:
    • Correct Supabase URLs and keys
    • Correct Stripe keys (test vs live)
    • Correct callback/redirect URLs

Output

  • Human-readable audit summary in docs/audit/DEPLOYMENT_HEALTH.md
  • Issue entries in docs/audit/AUDIT_ISSUES_REGISTRY.json

Environment Checklist

Required Variables

NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY
SUPABASE_SERVICE_ROLE_KEY
NEXTAUTH_URL
NEXTAUTH_SECRET
GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRET
ANTHROPIC_API_KEY

Optional Variables

STRIPE_SECRET_KEY
STRIPE_WEBHOOK_SECRET
SENDGRID_API_KEY
RESEND_API_KEY
SEMRUSH_API_KEY
DATAFORSEO_LOGIN
DATAFORSEO_PASSWORD

Health Check Process

Step 1: Environment Sync

Compare variables across:

  • Local .env.local
  • Vercel environment variables
  • DigitalOcean app spec

Flag mismatches.

Step 2: Build Verification

  • Run npm run build
  • Check for TypeScript errors
  • Check for missing dependencies
  • Verify all routes compile

Step 3: Runtime Validation

  • Check recent deploy logs
  • Look for crash patterns
  • Identify memory/CPU spikes
  • Flag slow endpoints

Step 4: API Health

  • Ping key API endpoints
  • Verify authentication works
  • Check database connectivity
  • Validate external service connections

Common Issues & Fixes

Issue: "Module not found"

Cause: Missing dependency Fix: npm install <module>

Issue: "Invalid environment variable"

Cause: Variable not set or wrong format Fix: Check .env.local and deployment settings

Issue: "Memory limit exceeded"

Cause: Heavy computation or memory leak Fix: Optimize code, increase limit, or add caching

Issue: "Database connection timeout"

Cause: Too many connections or network issue Fix: Enable connection pooling, check Supabase status