Agent skill · software engineering · jeremylongshore
persona-hello-world
Create and inspect one replay-safe Persona sandbox inquiry without implying a completed verification. Use when proving a new integration path. Trigger with: "test Persona inquiry", "Persona hello world", "smoke test Persona sandbox".
Why this skill is useful
Adds specific API commands and error handling for the Persona identity verification process that the AI wouldn't reliably generate on its own.
What it needs
Requires persona account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Persona Sandbox Inquiry Smoke Test Overview Prove the minimum create-and-read path in sandbox while keeping identity verification, account linkage, and session issuance explicit. A successful API response proves transport and contract compatibility, not that a person passed verification. Prerequisites A sandbox API key and a reviewed dated API version An enabled sandbox inquiry template ID Synthetic test identity data and a durable unique operation ID Instructions Step 1: Choose the create contract Use exactly one of inquiry-template-id, inquiry-template-version-id, or the supported template selector. Prefer the stable template ID unless a controlled test intentionally pins a version. Step 2: Create replay-safe intent Generate an Idempotency-Key from the operation ID, not a person or reference ID. Persist the request fingerprint before sending the POST. Step 3: Link the account deliberately When auto-creating an account, use meta.auto-create-account-reference-id; do not revive deprecated request reference-id guidance. Use meta.auto-create-inquiry-session only when the client needs an immediate session. Step 4: Inspect the JSON:API result Verify data.type, inquiry ID, status, template relationship, and optional meta['session-token']. Treat new fields and types as compatible additions. Step 5: Read and dispose GET the inquiry, compare its ID and status, then retain a redacted receipt. Never claim pass, fail, or completion unless the observed inquiry and verification states support it. Authentication Use the sandbox bearer API key against https://api.withpersona.com/api/v1 with the explicitly reviewed Persona-Version. Keep any session token server-side until delivered to the intended client through a protected channel. 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-hello-world--a6a98e