# 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.

- Skill: `mphaxise/webhook-transforms` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mphaxise/webhook-transforms`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mphaxise/webhook-transforms/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: mphaxise (https://skillmd.com/u/mphaxise)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mphaxise/webhook-transforms

---


# 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.