Skill

hex-sdk-patterns

Apply production-ready Hex SDK patterns for TypeScript and Python. Use when implementing Hex integrations, refactoring SDK usage, or establishing team coding standards for Hex. Trigger with phrases like "hex SDK patterns", "hex best practices", "hex code patterns", "idiomatic hex".

npx claudepluginhub flight505/skill-forge --plugin hex-pack

Tool Access

This skill is limited to using the following tools:

ReadWriteEdit

Preview

Production patterns for Hex API: typed client, pipeline orchestration, retry logic, and Python integration.

SKILL.md

Similar Skills

cache-components

139.3k

Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitApr 30, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Hex SDK Patterns

Overview

Production patterns for Hex API: typed client, pipeline orchestration, retry logic, and Python integration.

Instructions

Step 1: Run with Retry

async function runWithRetry(client: HexClient, projectId: string, params: Record<string, any>, maxRetries = 2) { for (let i = 0; i <= maxRetries; i++) { try { const { runId } = await client.runProject(projectId, params); const result = await pollUntilComplete(client, projectId, runId); return result; } catch (err: any) { if (i === maxRetries || !err.message.includes('429')) throw err; await new Promise(r => setTimeout(r, 30000)); // Wait 30s on rate limit } } }

Step 2: Python Client (hextoolkit)

# pip install hextoolkit from hextoolkit import HexAPI hex_api = HexAPI(token=os.environ['HEX_API_TOKEN']) # List projects projects = hex_api.list_projects() # Run project run = hex_api.run_project('project-id', input_params={'date': '2025-01-01'}) # Poll for completion status = hex_api.get_run_status('project-id', run['runId'])

Step 3: Airflow Integration

# Using the hex-inc/airflow-provider-hex package from airflow_provider_hex.operators.hex import HexRunProjectOperator run_task = HexRunProjectOperator( task_id='run_hex_project', project_id='your-project-id', input_params={'date': '{{ ds }}'}, hex_conn_id='hex_default', wait_for_completion=True, timeout=600, )

Resources

Next Steps

Apply patterns in hex-core-workflow-a.

Hex SDK Patterns

Overview

Production patterns for Hex API: typed client, pipeline orchestration, retry logic, and Python integration.

Instructions

Step 1: Run with Retry

async function runWithRetry(client: HexClient, projectId: string, params: Record<string, any>, maxRetries = 2) {
  for (let i = 0; i <= maxRetries; i++) {
    try {
      const { runId } = await client.runProject(projectId, params);
      const result = await pollUntilComplete(client, projectId, runId);
      return result;
    } catch (err: any) {
      if (i === maxRetries || !err.message.includes('429')) throw err;
      await new Promise(r => setTimeout(r, 30000)); // Wait 30s on rate limit
    }
  }
}

Step 2: Python Client (hextoolkit)

# pip install hextoolkit
from hextoolkit import HexAPI

hex_api = HexAPI(token=os.environ['HEX_API_TOKEN'])

# List projects
projects = hex_api.list_projects()

# Run project
run = hex_api.run_project('project-id', input_params={'date': '2025-01-01'})

# Poll for completion
status = hex_api.get_run_status('project-id', run['runId'])

Step 3: Airflow Integration

# Using the hex-inc/airflow-provider-hex package
from airflow_provider_hex.operators.hex import HexRunProjectOperator

run_task = HexRunProjectOperator(
    task_id='run_hex_project',
    project_id='your-project-id',
    input_params={'date': '{{ ds }}'},
    hex_conn_id='hex_default',
    wait_for_completion=True,
    timeout=600,
)

Resources

Next Steps

Apply patterns in hex-core-workflow-a.