resolving-ingestion-warnings
This skill helps diagnose and fix PostHog ingestion warnings, events that are dropped, rejected, or modified during data ingestion.
Identity proven by GitHub's verified organisation badge (PostHog)
- Agents
- Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode, claude.ai and API
- License
- No license stated
- Pin
- e0fbf5epinned Oct 9, 2026
- Context cost
- about 6,800 tokenswhen the skill loads
- GitHub stars
- 88on posthog/ai-plugin
- Scripts
- None found
What it does
“Diagnoses and resolves PostHog ingestion warnings — problems recorded while ingesting events (dropped events, rejected person merges, oversized payloads, invalid data). Use when a user asks why events are missing, dropped, or undercounted, why identify/alias calls don't work or accounts stay duplicated, why person or group properties aren't updating or profiles look inflated, why recordings have gaps, heatmaps are empty, LLM token counts are missing, why cookieless events vanish, or whenever the `ingestion_warning` health check fires. Explains severity triage (error = dropped, warning = modified, info = intentional) and routes all warning types — size limits and enrichment, merges and distinct IDs, `$process_person_profile`, timestamps, cookieless, heatmaps, transformations, session replay — to per-issue reference files with code-level causes and per-SDK fixes.”
Generated summary from the skill's own text
This skill helps diagnose and fix PostHog ingestion warnings, events that are dropped, rejected, or modified during data ingestion. It routes users through PostHog's health check system to identify warning types, explains severity levels and their impact on data, and provides targeted reference guides for each category of problem including size limits, person merges, distinct IDs, timestamps, and cookieless tracking.
When to use it
- Events are missing or counts lower than expected in PostHog
- Person merges or identify calls fail and accounts stay separate
- Person or group properties reject with size violations
- Cookieless tracking events vanish or heatmaps show gaps
When not to
- Only investigating why an individual query returns zero results unrelated to ingestion
- Debugging non-ingestion health checks or other platform issues
Install
No license stated: install from the publisher's repository, and ask the author before you reuse or share it.
These commands install from the publisher's repository and need no account.
skills CLI
npx skills add posthog/ai-plugin --skill resolving-ingestion-warningsInstalls from the repository's default branch, which may have changed since the commit we checked.
GitHub CLI 2.90 or later
gh skill install posthog/ai-plugin resolving-ingestion-warnings@e0fbf5e742fb4242c4ea509b395b2e343642f0b7Installs the commit we checked (e0fbf5e).
Copy by hand
Download the folder at e0fbf5e and put it in .claude/skills/resolving-ingestion-warnings for Claude Code and in .agents/skills/resolving-ingestion-warnings for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode.
Claude Code plugin
/plugin install posthog@claude-plugins-officialThe publisher's plugin in Claude's official marketplace. It may hold more than this skill, and we have not pinned it.
Copy for your agent
A prompt for any coding agent. It installs this skill from GitHub at the pinned commit, copies the files as they are, and runs nothing unless you ask.
Prompt
Install the agent skill "resolving-ingestion-warnings" by PostHog. Source, pinned to commit e0fbf5e742fb4242c4ea509b395b2e343642f0b7: https://github.com/posthog/ai-plugin/tree/e0fbf5e742fb4242c4ea509b395b2e343642f0b7/skills/resolving-ingestion-warnings 1. Download that folder at exactly this commit. Do not use the default branch. 2. Copy every file unchanged, keeping the folder structure, into .claude/skills/resolving-ingestion-warnings/ for Claude Code and .agents/skills/resolving-ingestion-warnings/ for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode. Create the folders if they do not exist. 3. Do not edit the files, and do not run any script in the folder unless I ask you to. 4. When you are done, list the files you copied and where you put them. Its license is restricted or not stated. Show me the license terms from the repository before you copy anything. Listing and checks: https://www.agentnative.dev/skills/posthog/resolving-ingestion-warnings
SKILL.md at the pin
The license of this skill does not let us show its files here.
Files
- SKILL.md28 KB · 36c39c2ec71c
- references/
- fixing-ai-endpoint-rejections.md6.3 KB · 4a78b91b37c9
- fixing-cannot-merge-already-identified.md4.4 KB · 19f923abf008
- fixing-capture-replay-rejections.md4.8 KB · 5af19f5c1ad9
- fixing-cookieless-warnings.md7.0 KB · 8ea2cc67209b
- fixing-event-dropped-by-transformation.md3.2 KB · 7a0f8512dc81
- fixing-event-dropped-too-old.md3.6 KB · eb8012f02931
- fixing-group-key-too-long.md1.9 KB · 69c07db39f17
- fixing-ignored-invalid-timestamp.md2.4 KB · 67411fb73ecf
- fixing-invalid-ai-token-property.md2.0 KB · 4ec9de14c42b
- fixing-invalid-distinct-ids.md4.2 KB · b2b39c72f8ad
- fixing-invalid-heatmap-data.md4.1 KB · 4fa8aab2b03a
- fixing-merge-race-condition.md5.0 KB · b9f2a5907f24
- fixing-message-size-too-large.md6.9 KB · af044fe17035
- fixing-person-properties-size-violation.md6.9 KB · 59902c5a14e7
- fixing-process-person-profile-warnings.md4.9 KB · b0b8c767f04a
- fixing-session-replay-warnings.md4.0 KB · 7c0cefe3d78e
17 files, 100 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.
Skill folder on GitHub at e0fbf5eMore from PostHog
analyzing-experiment-session-replays
This skill enables agents to analyze session recordings from experiment variants to identify behavioral differences between control and test groups.
Claude Code, Codex, Cursor +4 · about 2.3K tokens · pinned 6 days ago
analyzing-offline-evaluations
This skill inspects and compares offline AI evaluation experiments stored in PostHog, diagnoses case-level regressions, and tracks scorer changes across…
Claude Code, Codex, Cursor +4 · about 1.5K tokens · pinned 6 days ago
auditing-warehouse-view-health
Audits materialized views in a PostHog data warehouse to identify failed views and flag unused ones that waste compute resources.
Claude Code, Codex, Cursor +4 · about 1.4K tokens · pinned 6 days ago
authoring-data-quality-checks
This skill adds data quality checks (like dbt tests) on warehouse tables, views, and HogQL metrics, supporting assertions such as not-null, uniqueness…
Claude Code, Codex, Cursor +4 · about 2.5K tokens · pinned 6 days ago
authoring-scouts
This skill helps engineers write, edit, and adapt PostHog Signals scouts, scheduled agents that scan projects and report findings to an inbox.
Claude Code, Codex, Cursor +4 · about 10.6K tokens · pinned 6 days ago
building-a-dashboard
This skill constructs or modifies PostHog dashboards by selecting and arranging insight tiles.
Claude Code, Codex, Cursor +4 · about 2.1K tokens · pinned 6 days ago
Related in Observability
exploring-replay-vision-observations
This skill guides agents through reading observations from Replay Vision scanners, understanding their findings across session recordings, and taking action…
by PostHogOfficial publisher
Claude Code, Codex, Cursor +4 · about 3.3K tokens · pinned 6 days ago
exploring-scouts
Explore and understand PostHog Signals scouts through read-only tools, examining fleet configuration, recent runs, performance metrics, and durable team…
by PostHogOfficial publisher
Contains scripts
Claude Code, Codex, Cursor +3 · about 11K tokens · pinned 6 days ago
resolving-ingestion-warnings
This skill diagnoses and resolves PostHog ingestion warnings that occur during event processing.
by PostHogOfficial publisher
Claude Code, Codex, Cursor +4 · about 6.8K tokens · pinned 6 days ago
signals-scout-feature-flags
This skill monitors PostHog feature flags for evaluation anomalies and cleanup opportunities.
by PostHogOfficial publisher
Claude Code, Codex, Cursor +3 · about 13.4K tokens · pinned 6 days ago
signals-scout-replay-vision
This skill monitors PostHog Replay Vision scanners to detect when observation throughput drops unexpectedly and to surface aggregate patterns across sessions…
by PostHogOfficial publisher
Claude Code, Codex, Cursor +3 · about 7.9K tokens · pinned 6 days ago
authoring-scouts
Write and adapt PostHog Signals scouts, scheduled agents that scan projects, detect issues, and file reports to the inbox on a configurable schedule.
by PostHogOfficial publisher
Claude Code, Codex, Cursor +4 · about 10.6K tokens · pinned 6 days ago