smoke-test-external-services

Smoke Test External Services Skill

Quick Reference - Load this first for fast context (~3KB)

Mission

Execute comprehensive external service integration smoke tests to validate third-party APIs, payment gateways, email/SMS providers, and monitoring service connectivity during release workflows.

Core Capabilities

• Service Connectivity: Validate external service reachability and authentication
• API Integration: Test third-party API endpoints (Stripe, Twilio, SendGrid, etc.)
• Circuit Breaker Testing: Validate failover and graceful degradation
• Rate Limit Handling: Test rate limit detection and backoff strategies
• Webhook Validation: Verify webhook endpoints and signature validation
• Service Health Monitoring: Check external service status pages

When to Use This Skill

Use this skill when:

• Executing pre-release smoke tests (validate external dependencies)
• Testing canary deployments (monitor external API quotas)
• Verifying rollback success (ensure external service connectivity restored)
• Running scheduled health checks (detect external service degradation)
• Validating disaster recovery (test failover to backup providers)

Quick Start

1. Load Skill in Agent

skills:
  - name: smoke-test-external-services
    path: skills/smoke-test-external-services/SKILL.md

2. Execute External Service Tests

const { SmokeTestExternalServices } = require('./scripts/test-integrations.js');

const tester = new SmokeTestExternalServices({
  services: [
    {
      name: 'stripe',
      type: 'payment',
      baseUrl: 'https://api.stripe.com',
      apiKey: process.env.STRIPE_API_KEY
    },
    {
      name: 'sendgrid',
      type: 'email',
      baseUrl: 'https://api.sendgrid.com',
      apiKey: process.env.SENDGRID_API_KEY
    }
  ]
});

const result = await tester.executeTests({
  environment: 'staging',
  tests: ['connectivity', 'authentication', 'basic-operation']
});

if (result.passed) {
  console.log('✅ External service smoke tests passed');
} else {
  console.error('❌ External service smoke tests failed');
}