api-onboarding-diagnosticianlisted
Install: claude install-skill Prashanthvara/cs-automation-skills
# API Onboarding Diagnostician
Turns raw API logs from a stuck onboarding into a root-cause finding, a fix owner, and a customer-facing status update, in one pass.
## Inputs
- API request/response log excerpt (JSON lines, HAR, or plain text)
- Integration context: which endpoints, auth method (OAuth2, API key, mTLS), expected flow
Synthetic log fixtures per failure class in `references/log_fixtures/`.
## Workflow
1. Run `scripts/parse_logs.py` to bucket entries by endpoint, status code, and error body signature.
2. Match the dominant signature against `references/failure_signatures.md`: auth (expired token, wrong grant type, clock skew on JWT), payload (schema drift, enum mismatch, encoding), rate limiting (429 with retry-after ignored), idempotency (duplicate key collisions), environment (sandbox credentials against production host).
3. Separate customer-side faults from platform-side faults. The fix path differs completely.
4. Draft two artifacts: an internal engineering ticket (signature, frequency, first occurrence, reproduction) and a customer-facing status note (plain language, next step, owner, ETA discipline: no ETA unless the fix owner committed one).
## Output format
`## Root Cause`, `## Evidence` (bucketed counts), `## Fix Path` (owner and change), `## Customer Update` (under 100 words, no internal jargon).
## Guardrails
- Never send the customer an update that attributes fault before the evidence supports it.
- Redact tokens, keys, and PII from all quote