Skip to content

chore: update verification guidance to prefer SDK with manual fallback#37

Merged
leggetter merged 2 commits intomainfrom
chore/guidance-updates
Feb 22, 2026
Merged

chore: update verification guidance to prefer SDK with manual fallback#37
leggetter merged 2 commits intomainfrom
chore/guidance-updates

Conversation

@leggetter
Copy link
Collaborator

Summary

Updates official guidance to use provider SDKs by default for webhook signature verification, with manual verification as a fallback for frameworks the SDK doesn't support.

Changes

Event Gateway (commit 1)

  • skills/hookdeck-event-gateway/SKILL.md
  • skills/outpost/SKILL.md

Verification Guidance (commit 2)

  • AGENTS.md: Use provider SDK by default; include manual verification for unsupported frameworks (e.g., FastAPI when only Node SDK exists)
  • CONTRIBUTING.md: Align signature verification guidance with new policy
  • scripts/skill-generator/prompts/generate-skill.md: Update skill generator prompt for SDK-first approach

Rationale

Provider-specific skills (Stripe, Paddle, Resend, ElevenLabs, etc.) already recommend the official SDK when available. The meta-docs (AGENTS.md, CONTRIBUTING) previously said "prefer manual" which was inconsistent. The new guidance aligns with how providers document their webhooks and how production apps typically integrate.

Made with Cursor

leggetter and others added 2 commits February 22, 2026 17:00
Co-authored-by: Cursor <cursoragent@cursor.com>
- AGENTS.md: Use provider SDK by default, manual verification for unsupported frameworks
- CONTRIBUTING.md: Align signature verification guidance
- generate-skill.md: Update skill generator prompt for SDK-first approach

Co-authored-by: Cursor <cursoragent@cursor.com>
@leggetter leggetter merged commit 3fbb7bb into main Feb 22, 2026
6 checks passed
@leggetter leggetter deleted the chore/guidance-updates branch February 22, 2026 17:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant