Flexport prod checklist

Skill jeremylongshore/claude-code-plugins-plus-skills/plugins/saas-packs/flexport-pack/skills/flexport-prod-checklist

'Execute Flexport production deployment checklist for logistics integrations.From its SKILL.md

Install

npx -y skills add jeremylongshore/claude-code-plugins-plus-skills --skill flexport-prod-checklist

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.0 KB, 642 tokens by cl100k_base, as published. Nobody here has run it

Flexport Production Checklist

Overview

Pre-deployment and go-live checklist for Flexport logistics integrations covering API configuration, webhook setup, monitoring, and rollback procedures.

Pre-Deployment

Authentication & Secrets

Production API key stored in secret manager (not env files)
Webhook secret configured and verified
Key rotation procedure documented
No keys in git history (git log -p | grep -i flexport_api)

API Integration

All endpoints tested against production API
Pagination implemented for list endpoints (/shipments, /products)
Rate limit handling with exponential backoff
Retry logic for transient 5xx errors
Idempotency keys on POST/PATCH operations
Flexport-Version: 2 header on all requests

Webhooks

HTTPS endpoint with valid TLS certificate
X-Hub-Signature verification implemented
Webhook endpoint responds within 5 seconds
Dead letter queue for failed webhook processing
Idempotent webhook handlers (replay-safe)

Data Integrity

HS codes validated against customs requirements
UN/LOCODE port codes verified
Commercial invoice totals cross-checked
Product catalog synced with Flexport Product Library

Monitoring & Alerting

// Health check endpoint
app.get('/health', async (req, res) => {
  const start = Date.now();
  try {
    const r = await fetch('https://api.flexport.com/shipments?per=1', {
      headers: {
        'Authorization': `Bearer ${process.env.FLEXPORT_API_KEY}`,
        'Flexport-Version': '2',
      },
    });
    res.json({
      status: r.ok ? 'healthy' : 'degraded',
      flexport: { connected: r.ok, latencyMs: Date.now() - start },
    });
  } catch {
    res.status(503).json({ status: 'unhealthy', flexport: { connected: false } });
  }
});

Alert Thresholds

Metric	Warning	Critical
API error rate	> 5%	> 20%
p99 latency	> 3000ms	> 10000ms
429 rate limits	> 5/hour	> 20/hour
Webhook failures	> 2/hour	> 10/hour
Auth failures (401/403)	Any	Any

Rollback Procedure

# Immediate rollback
kubectl rollout undo deployment/flexport-integration
# Or for non-k8s: revert to last known good image/version

Resources

Next Steps

For version upgrades, see flexport-upgrade-migration.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,144. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.