webhook-transforms

Transform raw webhook payloads into sanitized markdown pages with citations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents disconnected external activity (SMS, meetings, social mentions) from becoming unusable data by converting raw webhook payloads into brain-ingestible pages with safe, structured citations.

Core Features & Use Cases

  • Event-to-page transformation: Converts incoming JSON payloads into markdown brain content plus metadata like slug, type, and citations.
  • Safety-first input sanitization: Strips HTML tags and prevents raw HTML/script from reaching brain pages to reduce XSS risk.
  • Resilient ingestion pipeline: Preserves raw payloads on failure via a dead-letter queue, retries once, and surfaces error types to the agent.
  • Entity extraction and timeline updates: Runs entity extraction on every transformed event and adds timeline entries to mentioned entities, then syncs.

Quick Start

Use the webhook-transforms skill to register a webhook for incoming SMS events so each delivery creates a sanitized brain page and timeline entry from the payload.

Frequently Asked Questions about webhook-transforms

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

FAQPage Schema
How do I convert incoming webhook payloads into markdown pages with safe citations?

Webhook transformations convert incoming JSON payloads into sanitized markdown brain pages with structured metadata like slugs, types, and citations. The process applies deterministic functions that strip HTML tags to prevent XSS and ensure safe content ingestion.

What is the best way to sanitize external event data for knowledge graph ingestion?

Input sanitization for knowledge graph ingestion strips HTML tags and prevents raw scripts from reaching brain pages, reducing XSS risk. This safety-first approach ensures external event data like SMS or social mentions becomes secure, structured content.

How do I handle failed webhook event ingestion without losing raw payload data?

Failed webhook event ingestion preserves raw payloads via a dead-letter queue and retries once before surfacing error types to the agent. This resilient pipeline prevents data loss during transformation failures.

Can I automatically extract entities and update timelines from external events?

Entity extraction and timeline updates run automatically on every transformed webhook event. The process extracts mentioned entities from incoming payloads, adds timeline entries, and syncs the knowledge graph to maintain chronological activity records.

Does webhook transformation work for SMS received, completed meetings, and social mentions?

Webhook transformation supports diverse ingestion scenarios including SMS received, completed meetings, and social mentions. Each external event type undergoes the same deterministic transformation to create sanitized brain pages with proper citations.

Why do raw HTML tags need to be stripped during webhook data transformation?

Raw HTML tags must be stripped during webhook data transformation to prevent XSS risk from reaching brain pages. This safety-first input sanitization ensures external payloads become secure, ingestible markdown content without script vulnerabilities.