webhook-skills: Instructions file for Codex

AGENTS.md

This file provides guidance to AI coding agents (Claude Code, Cursor, Copilot, etc.) when working with code in this repository.

Repository Overview

A community collection of webhook integration skills for AI coding agents. Skills provide step-by-step instructions for setting up webhook receivers, handling events, and integrating with the Hookdeck Event Gateway for reliable webhook infrastructure.

Repository Structure

webhook-skills/
├── README.md                    # Installation guide and skills overview
├── AGENTS.md                    # This file
├── TESTING.md                   # Testing documentation
├── LICENSE
├── scripts/
│   ├── test-examples.sh          # Run example tests (all or specific skills)
│   └── test-agent-scenario.sh   # Run agent integration tests
├── .github/
│   └── workflows/
│       └── test-examples.yml    # CI pipeline
│
└── skills/
    ├── stripe-webhooks/
    │   ├── SKILL.md
    │   ├── references/
    │   │   ├── overview.md          # What Stripe webhooks are, common events
    │   │   ├── setup.md             # Configure in Stripe dashboard
    │   │   └── verification.md      # Signature verification details
    │   └── examples/
    │       ├── express/
    │       │   ├── README.md        # Entry point for this example
    │       │   ├── package.json
    │       │   ├── .env.example
    │       │   └── src/             # Internal structure as needed
    │       │       └── index.js
    │       ├── nextjs/
    │       │   └── ...
    │       └── fastapi/
    │           └── ...
    │
    ├── shopify-webhooks/
    │   ├── SKILL.md
    │   ├── references/
    │   │   ├── overview.md
    │   │   ├── setup.md
    │   │   └── verification.md
    │   └── examples/
    │       ├── express/
    │       ├── nextjs/
    │       └── fastapi/
    │
    ├── github-webhooks/
    │   ├── SKILL.md
    │   ├── references/
    │   │   ├── overview.md
    │   │   ├── setup.md
    │   │   └── verification.md
    │   └── examples/
    │       ├── express/
    │       ├── nextjs/
    │       └── fastapi/
    │
    ├── webhook-handler-patterns/
    │   ├── SKILL.md
    │   └── references/
    │       ├── idempotency.md
    │       ├── error-handling.md
    │       ├── retry-logic.md
    │       └── frameworks/
    │           ├── express.md
    │           ├── nextjs.md
    │           └── fastapi.md
    │
    └── hookdeck-event-gateway/
        ├── SKILL.md
        ├── references/
        │   ├── 01-setup.md
        │   ├── 02-scaffold.md
        │   ├── 03-listen.md
        │   ├── 04-iterate.md
        │   ├── connections.md
        │   └── verification.md
        └── examples/
            ├── express/
            ├── nextjs/
            └── fastapi/