Official agent skill

Adding Ingestion Warnings

by PostHog in PostHog/posthog

How to add a new ingestion warning type to the event ingestion pipeline.

OfficialCustom licenceAuto-check passedDatabases

Install Adding Ingestion Warnings

skills CLI
$ npx skills add PostHog/posthog --skill adding-ingestion-warnings -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install PostHog/posthog adding-ingestion-warnings --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/PostHog/posthog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/adding-ingestion-warnings .claude/skills/adding-ingestion-warnings && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
adding-ingestion-warnings
GitHub stars
40k
Token cost
~3.7k tokens
SKILL.md length
1,670 words
Files
1
Skills in repo
252
Repo updated
First seen
Licence
Custom licence

At a glance

How to add a new ingestion warning type to the event ingestion pipeline.

  • Works in 3 steps: Register the type in… → Emit it (see below), passing only… → Update downstream surfaces (see…
  • Emitting a new warning from nodejs ingestion code (emitIngestionWarning
  • SKILL.md covers The registry is the source of…, Emitting, Rust and Rolling out a new…, plus 1 more section
  • Calls pnpm; reaches posthog.com

What it does

Adding Ingestion Warnings is an agent skill from PostHog/posthog, published by the product's own GitHub organization. How to add a new ingestion warning type to the event ingestion pipeline. Use when emitting a new warning from nodejs ingestion code (emitIngestionWarning, captureIngestionWarning, pipeline warnings arrays, drop() with warnings), when adding a warning type, category, or severity, or when a typecheck error says a string is not assignable to IngestionWarningType. Covers the INGESTIONWARNINGTYPES registry (the single source of truth for type, category, and severity), the details-key conventions that ClickHouse v2…

Its SKILL.md is about 3.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Databases, covering Data warehousing. It works with ClickHouse, Node.js and Rust. The repository describes itself as: :hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error…

When your agent uses it

  • Emitting a new warning from nodejs ingestion code (emitIngestionWarning
  • CaptureIngestionWarning
  • Pipeline warnings arrays
  • Drop() with warnings)

Example prompts

  • “/adding-ingestion-warnings”

Requirements

  • Node.js
  • Docker

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Register the type in INGESTION_WARNING_TYPES, inside the matching group comment block. Pick
  2. Emit it (see below), passing only per-occurrence fields: details, pipelineStep, optional key / alwaysSend.
  3. Update downstream surfaces (see checklist).

What it can do on your machine

Read from SKILL.md and the folder at commit 10f9ad7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • posthog.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Adding Ingestion Warnings loads about 3.7k tokens when it runs. Until then it costs about 173 tokens; SKILL.md has 1,670 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~173
When it runs · the whole SKILL.md, loaded when a task matches
~3.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,670 words (~3,681 tokens).

“Ingestion warnings tell customers their events were ingested with problems (or dropped). They are produced to the clickhouse_ingestion_warnings Kafka topic and land in two ClickHouse tables: v1 (ingestion_warnings) and v2 (ingestion_warnings_v2, which materializes structured columns from the details JSON).”

— opening of SKILL.md by PostHog, Custom licence
name
adding-ingestion-warnings

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/adding-ingestion-warnings of PostHog/posthog.

Open the folder on GitHubat commit 10f9ad7

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in PostHog/posthog, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Adding Ingestion Warnings next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Adding Ingestion Warnings compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Adding Ingestion Warnings this skillPostHog/posthog40k—~3.7kAutomated safety check: PassCustom licence
ClickHouse RowBinary for Node.jsClickHouse/agent-skills544—~1.3kAutomated safety check: PassApache-2.0
Webapp Buildersidequery/sidemantic129—~5.5kAutomated safety check: PassAGPL-3.0
Querying Tempotempoxyz/tidx107—~3.1kAutomated safety check: PassMIT
Clickhouse JS Node Codingvemetric/vemetric3941 repos~2.8kAutomated safety check: PassAGPL-3.0
Clickhouse JS Node Troubleshootingvemetric/vemetric3941 repos~1.3kAutomated safety check: PassAGPL-3.0

Similar skills

  • ClickHouse RowBinary for Node.js

    ClickHouse/agent-skills

    Generates TypeScript or JavaScript readers and writers for ClickHouse's RowBinary formats over HTTP in Node.js, after checking that RowBinary suits the data.

    544 GitHub stars~1.3k tokensUpdated 9 days ago
    DatabasesAuto-check passed
  • Webapp Builder

    sidequery/sidemantic

    Build interactive analytics webapps, demos, dashboards, or embedded app surfaces from Sidemantic semantic models using copyable component primitives and deterministic query inspection.

    129 GitHub stars~5.5k tokensUpdated today
    DatabasesAuto-check passed
  • Querying Tempo

    tempoxyz/tidx

    Query indexed Tempo chain data via tidx HTTP API and CLI. An agent skill from tempoxyz/tidx.

    107 GitHub stars~3.1k tokensUpdated today
    DatabasesAuto-check passed
  • Clickhouse JS Node Coding

    vemetric/vemetric

    Write idiomatic application code with the ClickHouse Node.js client (@clickhouse/client).

    394 GitHub starsUsed in 1 repo~2.8k tokens
    DatabasesAuto-check passed
  • Troubleshoot and resolve common issues with the ClickHouse Node.js client (@clickhouse/client).

    394 GitHub starsUsed in 1 repo~1.3k tokens
    DatabasesAuto-check passed
  • Clickhouse Install Auth

    jeremylongshore/tons-of-skills-marketplace

    Install @clickhouse/client and configure authentication to ClickHouse Cloud or self-hosted.

    2.8k GitHub stars~1.2k tokensUpdated today
    DatabasesAuto-check: notes

More from PostHog/posthog

All 252 skills in this repo
  • Authoring Log Alerts

    PostHog/posthog

    Official

    Author useful, low-noise log alerts on services in a PostHog project.

    40k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Official

    Operating procedure for the conflict-autoresolver agent: sweep open PostHog/posthog PRs that conflict with master, resolve the trivial conflicts (generated artifacts deterministically, source…

    40k GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Official

    Help users debug PostHog Error Tracking stack-trace symbolication for any supported platform — JavaScript/TypeScript web, React Native (Hermes), Android (Proguard / R8), or iOS / macOS (dSYM).

    40k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Exploring Apm Traces

    PostHog/posthog

    Official

    Investigates distributed application performance using PostHog APM (OpenTelemetry span) data via MCP.

    40k GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Exploring LLM Traces

    PostHog/posthog

    Official

    Debug and inspect LLM/AI agent traces using PostHog's MCP tools.

    40k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Investigate Metric

    PostHog/posthog

    Official

    Diagnose why a product metric changed (dropped, spiked, or plateaued) by orchestrating breakdowns, actors, paths, lifecycle, retention, and annotations queries.

    40k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Categories

Questions about Adding Ingestion Warnings

What does Adding Ingestion Warnings do?

How to add a new ingestion warning type to the event ingestion pipeline. Adding Ingestion Warnings is an agent skill from PostHog/posthog, published by the product's own GitHub organization. How to add a new ingestion warning type to the event ingestion pipeline.

When should I use Adding Ingestion Warnings?

Adding Ingestion Warnings fits situations like: emitting a new warning from nodejs ingestion code (emitIngestionWarning; captureIngestionWarning; pipeline warnings arrays; drop() with warnings).

How do I install Adding Ingestion Warnings in Claude Code?

Run `npx skills add PostHog/posthog --skill adding-ingestion-warnings -a claude-code`. Or copy the skill folder (.agents/skills/adding-ingestion-warnings in PostHog/posthog) into .claude/skills/adding-ingestion-warnings in your project. Claude Code loads it when a task matches its description.

How do I install Adding Ingestion Warnings in Codex?

Run `npx skills add PostHog/posthog --skill adding-ingestion-warnings -a codex`. Or copy the skill folder (.agents/skills/adding-ingestion-warnings in PostHog/posthog) into .agents/skills/adding-ingestion-warnings in your project. Codex loads it when a task matches its description.

Can I use Adding Ingestion Warnings in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add PostHog/posthog --skill adding-ingestion-warnings -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adding-ingestion-warnings, .gemini/skills/adding-ingestion-warnings, .github/skills/adding-ingestion-warnings and .opencode/skills/adding-ingestion-warnings in your project.

What does Adding Ingestion Warnings need to run?

Going by SKILL.md and its folder, Adding Ingestion Warnings needs the command-line tools its instructions call (pnpm). Our summary lists: Node.js; Docker.

Does Adding Ingestion Warnings access the network?

SKILL.md names 1 domain. In commands or code: posthog.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Adding Ingestion Warnings safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Adding Ingestion Warnings use?

Adding Ingestion Warnings has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Adding Ingestion Warnings use?

About 3.7k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Adding Ingestion Warnings?

Skills that share tags, products or a category with Adding Ingestion Warnings: ClickHouse RowBinary for Node.js (ClickHouse/agent-skills, 544 stars), Webapp Builder (sidequery/sidemantic, 129 stars), Querying Tempo (tempoxyz/tidx, 107 stars) and Clickhouse JS Node Coding (vemetric/vemetric, 394 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Adding Ingestion Warnings?

PostHog (a GitHub organization, an official publisher) maintains it in PostHog/posthog, which has 40,182 GitHub stars. The repository holds 252 skills in this directory. The repository was last updated on October 8, 2026.

Source: PostHog/posthog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.