Agent skill · software engineering · jeremylongshore
hex-sdk-patterns
Apply production-ready Hex SDK patterns for TypeScript and Python.
Why this skill is useful
Adds executable scripts for Hex SDK integration patterns that are not commonly found in public documentation.
What it needs
Requires airflow-provider-hex, hextoolkit installed locally. Requires hex account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Hex SDK Patterns Overview Production patterns for Hex API: typed client, pipeline orchestration, retry logic, and Python integration. Instructions Step 1: Run with Retry Step 2: Python Client (hextoolkit) Step 3: Airflow Integration Prerequisites A typed client boundary, secret-manager reference, environment allowlist, and a sandbox project using fictional or approved non-sensitive data. An explicit execution budget, idempotency/correlation convention, and policy that unknown project scope or response shape fails closed. Output Produce an SDK receipt with client revision, environment, opaque project/run IDs, parameter schema revision, execution state, aggregate result checks, and rollback/cancel reference. Do not include API tokens, SQL, cell output, or workspace data. Error Handling Classify authentication, authorization, validation, quota, timeout, and terminal-run failures separately. Do not retry a write-like project run without idempotency, broaden scope to bypass a denial, or log notebook output for diagnosis. Examples sdk=v3; env=sandbox; project=proj-opaque-11; params=r4; run=succeeded; rowcount=within-range; cancel=not-needed is a safe SDK execution receipt. Resources Hex API Airflow Provider Next Steps Apply patterns in hex-core-workflow-a.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/hex-sdk-patterns