Webhook Transforms

GBrain-inspired event transforms for Codex. Use when a JSON event payload should be replayed into the local brain as a meeting or source artifact.

mphaxise 244026f 1.3 KB Updated

File contents

Webhook Transforms

Use this skill when the user has a webhook-style payload and wants it turned into a durable brain artifact.

This port is adapted from garrytan/gbrain at commit b7e3005b5b3f1b54082f9c5990482ebf81a4a807.

Important Adaptation

Upstream GBrain assumes a live inbound webhook endpoint. In this repo, the honest equivalent is an offline replay and transform workflow:

  • python3 scripts/brain_transform_event.py payload.json --event-type auto

The helper preserves raw payloads, writes transformed pages, and dead-letters failures under brain/_dead-letter/.

Workflow

  1. Start from a local JSON payload file.
  2. Choose auto when the event shape is obvious, otherwise pass an explicit event type.
  3. Transform the payload into a meeting or source page.
  4. Review the transformed output and related entity updates.
  5. If the transform fails, inspect the dead-letter payload before retrying.

Guardrails

  • Do not claim a live webhook service exists in this repo.
  • Do not pass raw HTML or unreviewed payload content straight into brain pages.
  • Treat transforms as test-before-bulk work before replaying many events.

mphaxise/gstack-port-for-codex/tree/main/skills/webhook-transforms commit 244026fd05

Frequently asked questions

npx skillmds@latest add mphaxise/webhook-transforms