feat: add webhooks skill for receiving third-party events

[ejirocodes]

Summary

Closes #5

• Add inngest-webhooks skill covering guidance for creating webhooks with Inngest Cloud
• Covers webhook creation, transform functions (signature, parameters, error handling), signature verification patterns, REST API (POST https://inn.gs/e/<key>), event keys, 6 common integration transforms (Stripe, GitHub, Clerk, Linear, Intercom, Resend), branch environment routing, supported content types, webhook REST API for programmatic management, and local testing with tunnels
• 393 lines — under the 500-line limit

Test plan

• Verify transform examples match official docs at inngest.com/docs/platform/webhooks
• Cross-reference REST API format against inngest.com/docs/events
• Confirm SKILL.md stays under 500-line limit
• Check cross-links to other skills resolve correctly

---

Summary by cubic

Adds the inngest-webhooks skill to help teams receive third‑party events via Inngest webhooks, with clear guidance on transforms, verification, REST event publishing, and provider mappings. Also fixes branch environment routing instructions and removes a duplicate Inngest constructor example.

• New Features

  • New skills/inngest-webhooks/SKILL.md covering transforms (signature, params, error handling) and verification patterns.
  • REST event publishing via POST https://inn.gs/e/<key>, event keys, branch routing with x-inngest-env, provider examples (Stripe, GitHub, Clerk, Linear, Intercom, Resend), local testing via Dev Server and tunnels, and webhook management REST API; README links the skill.

• Bug Fixes

  • Corrected x-inngest-env guidance: omitting it sends events to the branch events page and won’t trigger functions; also removed a duplicate Inngest constructor example.

^{Written for commit 6346ffe. Summary will update on new commits.}

[cubic-dev-ai]

2 issues found across 2 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="skills/inngest-webhooks/SKILL.md">

<violation number="1" location="skills/inngest-webhooks/SKILL.md:264">
P2: Conflicting guidance for missing `x-inngest-env` gives incompatible routing behavior and can cause missed function execution assumptions.</violation>

<violation number="2" location="skills/inngest-webhooks/SKILL.md:285">
P3: The example code redeclares `const inngest` in the same scope, so it won’t compile if copied as written. Present the two initialization styles as mutually exclusive (e.g., comment out the alternative or use a different variable name).</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[ejirocodes]

Hi @djfarrelly, this is also ready for review when you get a chance