Agent skill · software engineering · jeremylongshore
hex-prod-checklist
Execute Hex production deployment checklist and rollback procedures.
Why this skill is useful
Adds a validation script for Hex API readiness checks and detailed deployment procedures that are not publicly documented.
What it needs
Requires bash installed locally. Requires hex account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Hex Production Checklist Overview Hex is a collaborative data analytics platform where teams build notebooks, dashboards, and scheduled data pipelines. A production integration triggers project runs, retrieves results, and monitors pipeline health via the Hex API. Failures mean stale dashboards, broken scheduled reports, or data pipelines that silently stop producing output for downstream consumers. Authentication & Secrets [ ] HEXAPIKEY stored in secrets manager (not config files) [ ] Token scoped to "Run projects" permission only [ ] Token expiration set > 90 days with calendar renewal reminder [ ] Separate tokens for dev/staging/prod workspaces [ ] Key rotation schedule documented (quarterly cycle) API Integration [ ] Production base URL configured (https://app.hex.tech/api/v1) [ ] Rate limits respected (20 requests/min, 60/hour) [ ] All orchestrated projects published before triggering runs [ ] Input parameters documented and validated before submission [ ] Run status polling with configurable interval (default: 5s) [ ] Result retrieval handles large datasets (pagination/streaming) [ ] Project version pinning prevents unexpected behavior changes Error Handling & Resilience [ ] Circuit breaker configured for Hex API outages [ ] Retry with exponential backoff for 429/5xx responses [ ] ERRORED and KILLED run states handled with alert + re-queue [ ] Run timeout detection (alert if run exceeds 2x typical duration) [ ] Database connection errors in Hex projects surface to caller [ ] Graceful degradation serves cached results when API is down Monitoring & Alerting [ ] API latency tracked per project run [ ] Error rate alerts set (any ERRORED run = notification) [ ] Run duration regression tracked (>50% increase = warning) [ ] Scheduled run completion rate monitored daily [ ] API quota usage tracked against plan limits Validation Script Error Handling Check Risk if Skipped Priority ------- ---------------- ---------- API key expiration All scheduled runs stop silently P …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/hex-prod-checklist--ab7315