webhook-transforms

Transform webhook payloads into sanitized brain pages with timeline entries.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ngochuy13/intern-dev --skill webhook-transforms-ngochuy13
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhook-transforms
Source: https://github.com/ngochuy13/intern-dev/tree/main/skills/webhook-transforms
Command: npx skills add https://github.com/ngochuy13/intern-dev --skill webhook-transforms-ngochuy13

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts external webhook payloads (e.g., SMS, meeting updates, social mentions) into sanitized, structured brain pages so events reliably enter the brain ingestion pipeline with citations and entity extraction.

Core Features & Use Cases

  • Webhook event transformation framework: Defines a consistent mapping from raw JSON payloads to brain page markdown plus metadata (slug/type/citations).
  • Safety-focused input sanitization: Strips HTML and escapes script content to prevent unsafe content from reaching brain pages.
  • Reliable processing with observability: Preserves raw payloads for troubleshooting via a dead-letter queue on transform failure and retries once, while surfacing error type to the agent.
  • Downstream integration: Writes pages via gbrain put, runs entity extraction/enrichment, adds timeline entries, and syncs with gbrain sync.
  • Use case: When an SMS indicates a meeting time change, the skill transforms the message into a timeline entry on the sender’s brain page and updates related task context if an action item is detected.

Quick Start

Tell the system to register the webhook endpoint for your external provider and apply the webhook-transforms contract to convert incoming events into brain pages with entity extraction and timeline updates.

Frequently Asked Questions about webhook-transforms

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

FAQPage Schema
How do I transform incoming webhook payloads into structured brain pages?

To transform webhook payloads into structured brain pages, define a deterministic mapping from raw JSON to markdown with metadata, sanitize HTML content, write via gbrain put, and sync with gbrain sync.

What is the best way to sanitize webhook event data for brain ingestion?

The best way to sanitize webhook event data for brain ingestion is to strip HTML and escape script content before writing pages, ensuring unsafe external content never reaches the brain pipeline.

How does error handling work when webhook event transformation fails?

Error handling for webhook event transformation preserves raw payloads in a dead-letter queue on failure, retries the transform once, and surfaces the error type to the agent for troubleshooting.

Can I extract entities and add timeline entries from SMS or meeting webhooks?

Yes, you can extract entities and add timeline entries from SMS or meeting webhooks by applying a deterministic transform, running entity enrichment, and adding timeline entries via gbrain sync.

Do I need a dead-letter queue to process external webhook events reliably?

You need a dead-letter queue to process external webhook events reliably because it preserves raw payloads on transform failure and supports one retry, preventing data loss during schema mismatches.