Agent skill · operations · jeremylongshore
maintainx-prod-checklist
Production deployment checklist for MaintainX integrations.
Why this skill is useful
Adds a comprehensive deployment checklist with executable scripts for verifying production readiness and auditing MaintainX integrations.
What it needs
Requires jq installed locally. Requires maintainx account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
MaintainX Production Checklist Overview Comprehensive pre-deployment and post-deployment checklist for MaintainX integrations covering security, reliability, observability, and data integrity. Prerequisites MaintainX integration developed and tested Production MaintainX account with API access Deployment infrastructure ready (Cloud Run, K8s, or similar) Instructions Step 1: Authentication & Security [ ] API key stored in secret manager (not env file or code) [ ] .env and .key files in .gitignore [ ] Pre-commit hook blocking secret commits [ ] API key rotation schedule set (every 90 days) [ ] Input validation on all user-provided data (Zod or similar) Step 2: Error Handling & Resilience [ ] Retry logic with exponential backoff for 429 and 5xx errors [ ] Retry-After header honored on 429 responses [ ] Circuit breaker for cascading failure prevention [ ] Graceful degradation when MaintainX API is down [ ] Request timeout set (30 seconds recommended) Step 3: Data Integrity [ ] Cursor-based pagination handles all list endpoints [ ] Idempotency keys on webhook handlers (prevent duplicate processing) [ ] Data sync state persisted (survives restarts) [ ] Reconciliation job runs daily to detect drift [ ] Work order status transitions follow valid paths only Step 4: Observability [ ] Structured JSON logging (not console.log in production) [ ] API request metrics (count, latency, error rate) [ ] Health check endpoint (/health) returning API connectivity status [ ] Readiness probe (/ready) for container orchestration [ ] Alerting configured for error rate > 5%, latency > 5s, sync lag > 15min Step 5: Performance [ ] Connection pooling with keep-alive enabled [ ] Response caching for static resources (users, locations, teams) [ ] Max page size (100) used for pagination [ ] Webhook-driven updates instead of polling where possible [ ] Rate limiting to stay within API quotas Step 6: Deployment [ ] Multi-stage Docker build (small production image) [ ] Non-root user in container [ ] R …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-prod-checklist--9cf27a