Agent skill · software engineering · jeremylongshore
persona-performance-tuning
Improve Persona integration latency and throughput with event-driven processing, bounded reconciliation, and evidence-based measurement. Use when reducing polling or queue lag. Trigger with: "speed up Persona", "reduce inquiry polling", "tune Persona webhooks".
Why this skill is useful
Adds specific batching and caching techniques for optimizing Persona API performance that the AI wouldn't reliably generate on its own.
What it needs
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
Event-Driven Persona Inquiry Reconciliation Overview Optimize the application around authentic webhook events and bounded GET reconciliation rather than parallel polling or speculative session creation. Measure customer latency, queue lag, rate headroom, and decision freshness separately. Prerequisites Latency SLO and volume by workflow Current traces for API calls, webhook receipt, queueing, and decisions Rate and quota header telemetry plus failure budget Instructions Step 1: Build the latency model Measure inquiry create, client start, verification progress, provider event creation, delivery, queue delay, reconciliation, and domain decision. Step 2: Remove polling from the hot path Use verified webhooks as the primary notification. Keep bounded polling only for recovery and customer-visible refresh with jitter and stop conditions. Step 3: Partition safely Process unrelated accounts or inquiries concurrently while serializing consequential transitions per subject or inquiry. Step 4: Avoid session churn Create or resume an inquiry session only when a client needs it; track issuance and prevent retries from consuming the default session allowance. Step 5: Cache only stable metadata Cache template and non-sensitive configuration with versioned invalidation. Do not cache bearer credentials, session tokens, or stale identity decisions. Step 6: Tune from evidence Adjust worker count, batch size, timeout, and reconciliation interval while protecting RateLimit-, Quota-, error, and stale-decision thresholds. Authentication Performance work must preserve bearer-key isolation, raw webhook HMAC verification, and session-token confidentiality. Bypassing authentication or reconciliation is not an optimization. Tool Discipline Use Read and Grep to inspect application configuration, provider documentation, fixtures, schemas, tests, and redacted operational evidence before proposing a change. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/persona-performance-tuning