Agent skill · software engineering · jeremylongshore
clay-local-dev-loop
Set up a local development loop for building and testing Clay integrations.
Why this skill is useful
Adds specific scripts and integration patterns for setting up a local development loop with Clay, which the AI wouldn't reliably generate on its own.
What it needs
Requires ngrok, node, python3 installed locally. Requires clay account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Clay Local Dev Loop Overview Clay is a web-based platform with no local runtime. Your local dev loop consists of: (1) scripts that push data into Clay via webhooks, (2) Clay enrichment running in the cloud, and (3) HTTP API columns pushing enriched data back to your local endpoint via ngrok. This skill sets up that feedback loop. Prerequisites Completed clay-install-auth setup Node.js 18+ or Python 3.10+ ngrok installed (npm install -g ngrok or ngrok.com) Clay table with webhook source configured Instructions Step 1: Expose Your Local Server via ngrok Clay's HTTP API enrichment columns need a public URL to call your local endpoints. Step 2: Create a Local Webhook Receiver Step 3: Build a Test Data Sender Step 4: Configure Clay HTTP API Column to Call You Back In your Clay table: 1. Click + Add Column > HTTP API 2. Set Method: POST 3. Set URL: https://your-ngrok-url.ngrok-free.app/api/clay/enriched 4. Set Body (JSON): Map enriched columns using Clay's {{columnname}} syntax: 1. Enable Auto-run on new rows Step 5: Dev Loop Iteration Cycle Iteration cycle: 1. Modify enrichment columns or Claygent prompts in Clay UI 2. Re-send test data via webhook 3. Observe enriched results in your local receiver 4. Adjust and repeat Step 6: Mock Clay Responses for Unit Tests Error Handling Issue Cause Solution ------- ------- ---------- ngrok tunnel drops Free tier session expired Restart ngrok or upgrade to paid plan Clay HTTP API column returns error ngrok URL changed Update the URL in Clay column settings No data flows back Auto-run disabled Enable auto-run on the HTTP API column Webhook returns 422 Bad JSON in test data Validate payload with jq . <<< '$JSON' Enrichment columns empty No provider configured Add enrichment provider in Clay table Output The development loop returns a local test receipt with fixture version, callback result, validation status, and any sanitized correlation ID. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/clay-local-dev-loop--be5960