Skip to content
Get packs

Webhook Event Transforms

Turns incoming webhook events (SMS, meetings, social mentions) into structured brain pages.

Source Download skill
Repository
garrytan/gbrain
Stars
31,447
Licence
MIT
Files
1 file

What it does

This skill teaches an agent how to receive events pushed from outside services, such as a text message, a finished meeting, or a social media mention, and convert each one into a structured page in a personal knowledge store called a brain. You define a transform function that maps the event's fields to a page, register a webhook URL with the external service, and the agent then processes incoming events automatically. It also specifies sanitizing input, keeping raw payloads in a dead-letter folder if a transform fails, and retrying once.

Great for

  • Developers building an automated pipeline that feeds external events into a gbrain knowledge store
  • Teams who already run gbrain and want SMS, meeting or social mention data captured with citations

Skip it if

  • Users who just want to read or write notes by hand; this only matters with a webhook-fed pipeline and a running gbrain installation
  • Anyone exposing a webhook endpoint without reviewing sanitization and token scopes, since external input is written into a persistent store and inaccurate or hostile payloads could pollute it

Try asking

  • “Set up a webhook so my SMS messages get saved to the brain as timeline entries”
  • “Process this webhook event from my meeting tool and create a meeting page”
  • “Transform this social mention payload into a media page with entity links”
Step-by-step guide: how to use Webhook Event TransformsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    webhook-transforms.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip webhook-transforms.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip webhook-transforms.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Review each transform function's sanitization step before registering a live webhook URL
  • Check the _dead-letter folder regularly so failed events are not forgotten
  • Confirm token scopes with the brain host operator before expecting writes to succeed

What's inside

  • SKILL.md

Redistributed unmodified from garrytan/gbrain under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.