svix-new-integration
Installation
SKILL.md
Workflow
This skill is interview-first. Do not write code, install SDKs, or scaffold files until the plan has been produced and confirmed.
- Triage — start with <references/triage.md>. This determines the direction (Dispatch, Ingest, both) and the high-level tenancy model.
- Branch — depending on the triage answers, walk the user through:
- <references/dispatch-questions.md> if they are sending webhooks to their own customers/partners.
- <references/ingest-questions.md> if they are receiving webhooks from third-party providers.
- Both files, in order, if the integration is bidirectional.
- Write the plan — use <references/plan-template.md>. Quote the user's answers back; do not invent details they didn't give.
- Confirm, then hand off — once the plan is approved, switch to the
svix-best-practicesskill for the actual implementation. This skill's job ends at the plan.
Interview rules
- One topic at a time. Use
AskUserQuestionper topic with 2–4 concrete options plus an "Other" fallback. Don't dump every question at once — branching depends on earlier answers. - Quote the user's words. When they say "we call them organizations," use
organization_idin the plan, not a generic placeholder. - Surface tradeoffs, don't decide silently. If an answer has a non-obvious downstream cost (e.g. "we'll use Channels per project" implies untyped strings, no validation), flag it in the question's description.
- Skip questions that don't apply. If the user only sends webhooks, never ask Ingest questions. If they have no partners, skip the partner-routing branch.
- Resist scope creep. A discovery interview is not the place to debate Event Type schemas in depth — capture the decision and move on. Detailed schema design happens during implementation.