Stats
Actions
Tags
From hex-pack
Diagnoses and fixes common Hex API errors: 401/403/404/429 auth/rate limits, ERRORED/KILLED runs. Includes curl tests for tokens/projects.
How this skill is triggered — by the user, by Claude, or both
Slash command
/hex-pack:hex-common-errorsThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Cause:** Token invalid, expired, or missing.
Cause: Token invalid, expired, or missing. Fix: Regenerate token in Hex workspace settings.
Cause: Token has "Read projects" scope but RunProject requires "Run projects". Fix: Create new token with "Run projects" scope.
Cause: Project ID wrong or project not published. Fix: Verify project ID. Only published projects can be run via API.
Cause: RunProject is limited to 20 requests/min, 60/hr.
Fix: Queue runs with delays. See hex-rate-limits.
Cause: SQL query, Python code, or connection error in the project. Fix: Open the project in Hex UI and check the error in the run history.
Cause: Run exceeded timeout or was manually cancelled. Fix: Optimize slow queries. Increase timeout in API trigger.
# Test token
curl -s -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer $HEX_API_TOKEN" \
https://app.hex.tech/api/v1/projects
# List recent runs for a project
curl -s -H "Authorization: Bearer $HEX_API_TOKEN" \
https://app.hex.tech/api/v1/project/PROJECT_ID/runs | python3 -m json.tool
For debugging, see hex-debug-bundle.
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin hex-packGenerates TypeScript code for Hex API: list projects, trigger runs with params, poll completion, access results. For new integrations, setup testing, or API learning.
Automates Honeybadger error monitoring tasks via Rube MCP and Composio. Discovers tools, manages connections, and executes Honeybadger operations.
Analyzes error patterns from Claude Code sessions using logs and scripts to troubleshoot issues like connection refused and PostgreSQL errors. Invoke /errors for batch analysis.