webhook-transforms

Transform external webhook events into cited brain pages via gbrain put.

Updated May 11, 2026
One-click install
npx skills add https://github.com/yunusgungor/gbrain --skill webhook-transforms-yunusgungor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhook-transforms
Source: https://github.com/yunusgungor/gbrain/tree/main/skills/webhook-transforms
Command: npx skills add https://github.com/yunusgungor/gbrain --skill webhook-transforms-yunusgungor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

External events (SMS, meetings, social mentions) are noisy and hard to ingest into the brain without losing context. This skill provides a generic framework to define a transform function, register a webhook URL, and process incoming events so they become brain pages with proper citations, while preserving raw payloads on transform failures and ensuring entities are extracted for enrichment.

Core Features & Use Cases

  • Define transform: Map an external event payload to brain page content (markdown) plus metadata (slug, type, citations) with proper sanitization.
  • Webhook registration: Expose a webhook endpoint to external services for event delivery and ingestion.
  • End-to-end processing: On event receipt, transform, write brain pages via gbrain put, enrich entities, add timeline entries, and sync to maintain consistency.
  • Reliability & safety: Log failed payloads to a dead-letter queue, surface error types, and retry once to avoid data loss.

Quick Start

Register a webhook URL, implement a transform function, and ensure transformed events create brain pages with citations.

Frequently Asked Questions about webhook-transforms

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ingest external webhook payloads into a brain pipeline?

To ingest external webhook payloads into a brain pipeline, you can register a webhook endpoint and define a transform function that maps incoming event data into brain pages with proper citations and metadata. The system sanitizes inputs, extracts entities, and writes pages via gbrain put.

What is the best way to transform SMS and meeting events into brain pages?

The best way to transform SMS and meeting events into brain pages is by defining a transform function that maps external event payloads into markdown content with proper citations. This ensures the data is sanitized and structured for brain pipeline ingestion.

Do I need a dead-letter queue for webhook event ingestion?

You need a dead-letter queue for webhook event ingestion if you want to preserve raw payloads when transform functions fail. The system logs failed payloads to this queue and retries once, ensuring no external event data is lost during processing.

How does entity extraction work during webhook event processing?

During webhook event processing, entity extraction occurs after the transform function maps the external payload to brain page content. The system extracts entities automatically and uses them for subsequent enrichment and timeline updates.