Agent skill · software engineering · jeremylongshore
persona-local-dev-loop
Run a deterministic local Persona sandbox loop with synthetic inquiries, raw webhook fixtures, and replay checks. Use when developing without production PII. Trigger with: "develop Persona locally", "test Persona webhook", "mock Persona flow".
Why this skill is useful
Adds specific commands and workflows for integrating with the Persona API and ngrok that the AI wouldn't reliably generate on its own.
What it needs
Requires ngrok, npm installed locally. Requires persona account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Deterministic Persona Sandbox and Webhook Loop Overview Build the local loop around Persona sandbox behavior and captured contract fixtures, not around calls to production. Sandbox performs no real verification, supports forced pass or fail paths, and incurs no usage charges. Prerequisites Sandbox-only API key and template HTTPS-capable webhook tunnel or local fixture runner Synthetic identities and a secret-safe fixture directory Instructions Step 1: Declare the scenario Name the template, forced outcome, inquiry state, expected event type, API version, and cleanup disposition. Step 2: Create with an operation key Create a sandbox inquiry using a unique Idempotency-Key. Persist IDs separately from synthetic payloads. Step 3: Exercise the client path Use the supported sandbox flow to force pass or fail. Do not encode sandbox-only controls into production request code. Step 4: Capture raw webhook bytes Save headers and raw body before parsing, redact PII, and preserve duplicate deliveries and deliberately reordered fixtures. Step 5: Replay deterministically Verify HMAC against raw bytes, deduplicate by event ID, order business processing by data.attributes.created-at, and assert the terminal local state. Step 6: Reset without hiding drift Delete only generated local artifacts through the project’s approved cleanup path; retain the contract fingerprint and test receipt. Authentication Use a sandbox bearer key for REST requests and a separate sandbox webhook secret for HMAC verification. Never expose either value in a tunnel URL, fixture, console log, or committed .env file. Tool Discipline Use Read and Grep to inspect application configuration, provider documentation, fixtures, schemas, tests, and redacted operational evidence before proposing a change. Use Write or Edit only for an approved implementation, configuration, test, runbook, or redacted receipt. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/persona-local-dev-loop