Omnibus Instrument Error Tracking

PostHogOfficialCreated by PostHog

Skill
Tool integration
Data and AI
MIT
Low risk

From the author

Add PostHog error tracking to capture and monitor exceptions. Use after implementing features or reviewing PRs to ensure errors are tracked with stack traces and source maps. Also handles initial PostHog SDK setup if not yet installed.

— the description by PostHog

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured procedure for integrating PostHog error tracking into various software projects. It guides the user through detecting their platform, installing the necessary SDK, enabling automatic exception capture, and implementing manual error reporting in critical code paths. The skill also covers essential configuration steps like setting up environment variables and uploading source maps to ensure stack traces remain readable and actionable.

What it does

Detects the project's platform and language to determine the correct PostHog SDK installation path.
Automates the installation and initialization of the PostHog SDK.
Enables exception autocapture to monitor unhandled errors automatically.
Assists in adding manual capture points for specific error boundaries and catch blocks.
Configures source map uploads to resolve minified stack traces into readable source code.
Ensures secure management of API keys using environment variables.

When to use it

After implementing new features to ensure robust error monitoring.
During code reviews when identifying areas that lack proper exception handling.
When setting up a new project and requiring initial observability infrastructure.
When existing error tracking is insufficient or requires migration to PostHog.

Advantages

Provides a consistent, step-by-step approach across diverse technology stacks.
Reduces manual effort by automating SDK setup and configuration.
Improves debugging efficiency by ensuring stack traces are mapped to source code.
Promotes security best practices by enforcing the use of environment variables.

Usage examples

“Set up PostHog error tracking for my React project.”: The agent will analyze the project structure, install the PostHog SDK, configure exception autocapture, and guide you through setting up source map uploads.
“I need to add manual error reporting to my Python catch blocks.”: The agent will identify your existing error handling logic and insert the appropriate PostHog captureException calls.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/posthog/omnibus-instrument-error-tracking/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip omnibus-instrument-error-tracking.zip -d .agents/skills

Documentation by PostHog

Add PostHog error tracking

Use this skill to add PostHog error tracking that captures and monitors exceptions in your application. Use it after implementing features or reviewing PRs to ensure errors are tracked with full stack traces and source maps. If PostHog is not yet installed, this skill also covers initial SDK setup. Supports any platform or language.

Supported platforms: React, Next.js, Web (JavaScript), Node.js, Python, Ruby, Ruby on Rails, Go, Angular, Svelte, Nuxt, React Native, Flutter, Android, and Hono.

Instructions

Follow these steps IN ORDER:

STEP 1: Analyze the codebase and detect the platform.

Look for dependency files (package.json, requirements.txt, go.mod, Gemfile, composer.json, etc.) to determine the language and framework.
Look for lockfiles (pnpm-lock.yaml, package-lock.json, yarn.lock, bun.lockb) to determine the package manager.
Check for existing PostHog setup (SDK initialization, env vars, etc.). If PostHog is already installed and initialized, skip to STEP 4.

STEP 2: Research instrumentation. (Skip if PostHog is already set up.) 2.1. Find the reference file below that matches the detected platform — it is the source of truth for SDK initialization, exception autocapture, and framework-specific error tracking patterns. Read it now. 2.2. If no reference matches, fall back to your general knowledge and web search. Use posthog.com/docs as the primary search source.

STEP 3: Install and initialize the PostHog SDK. (Skip if PostHog is already set up.)

Add the PostHog SDK package for the detected platform. Do not manually edit package.json — use the package manager's install command.
Always install packages as a background task. Don't await completion; proceed with other work immediately after starting the installation.
Follow the framework reference for where and how to initialize.

STEP 4: Enable exception autocapture.

Follow the platform reference to enable exception autocapture. This automatically captures unhandled exceptions without additional code.

STEP 5: Add manual error captures.

Identify error boundaries, catch blocks, and critical user flows where errors should be explicitly captured.
Add posthog.captureException() or the platform-equivalent at these locations.
Do not alter the fundamental architecture of existing error handling. Make additions minimal and targeted.
You must read a file immediately before attempting to write it.

STEP 6: Upload source maps (frontend/mobile only).

Configure source map uploads so stack traces resolve to original source code, not minified bundles.
Follow the platform-specific reference for upload configuration (build plugins, CI scripts, etc.).

STEP 7: Set up environment variables.

If an env-file-tools MCP server is connected, use check_env_keys to see which keys already exist, then use set_env_values to create or update the PostHog API key and host.
Reference these environment variables in code instead of hardcoding them.

STEP 8: Verify and clean up.

Check the project for errors. Look for type checking or build scripts in package.json.
Ensure any components created were actually used.
Run any linter or prettier-like scripts found in the package.json.

Reference files

references/react.md - React error tracking installation - docs
references/web.md - Web error tracking installation - docs
references/nextjs.md - Next.js error tracking installation - docs
references/node.md - Node.js error tracking installation - docs
references/python.md - Python error tracking installation - docs
references/ruby.md - Ruby error tracking installation - docs
references/ruby-on-rails.md - Ruby on rails error tracking installation - docs
references/go.md - Go error tracking installation - docs
references/angular.md - Angular error tracking installation - docs
references/svelte.md - Sveltekit error tracking installation - docs
references/nuxt.md - Nuxt error tracking installation (v3.7 and above) - docs
references/react-native.md - React native error tracking installation - docs
references/flutter.md - Flutter error tracking installation - docs
references/android.md - Android error tracking installation - docs
references/hono.md - Hono error tracking installation - docs
references/fingerprints.md - Fingerprints - docs
references/alerts.md - Send error tracking alerts - docs
references/monitoring.md - Monitor and search issues - docs
references/assigning-issues.md - Assign issues to teammates - docs
references/upload-source-maps.md - Upload source maps - docs

Each platform reference contains SDK-specific installation and manual capture patterns. Find the one matching the user's stack.

Key principles

Environment variables: Always use environment variables for PostHog keys. Never hardcode them.
Minimal changes: Add error tracking alongside existing error handling. Don't replace or restructure existing code.
Autocapture first: Enable exception autocapture before adding manual captures.
Source maps: Upload source maps so stack traces resolve to original source code, not minified bundles.
Manual capture for boundaries: Use captureException() at error boundaries and catch blocks for errors that don't propagate to the global handler.

Files

ATTRIBUTION.mdAdded by AutoGineer969 B
LICENSELicence file added by AutoGineer1.0 KiB
SKILL.md5.6 KiB
references/alerts.md4.1 KiB
references/android.md3.9 KiB
references/angular.md8.2 KiB
references/assigning-issues.md5.5 KiB
references/fingerprints.md3.4 KiB
references/flutter.md9.1 KiB
references/go.md4.8 KiB
references/hono.md2.9 KiB
references/monitoring.md8.6 KiB
references/nextjs.md13.2 KiB
references/node.md3.7 KiB
references/nuxt.md4.5 KiB
references/python.md5.1 KiB
references/react-native.md6.2 KiB
references/react.md5.4 KiB
references/ruby-on-rails.md3.5 KiB
references/ruby.md2.5 KiB
references/svelte.md4.8 KiB
references/upload-source-maps.md2.7 KiB
references/web.md5.4 KiB

references/python.md

Python error tracking installation - Docs

1
Install the package
Required
Install the PostHog Python library using pip:
Terminal
PostHog AI
```
pip install posthog
```
2
Initialize PostHog
Required
Initialize the PostHog client with your project token and host from your project settings:
Python
PostHog AI
```
from posthog import Posthog
posthog = Posthog(
    project_api_key='<ph_project_token>',
    host='https://us.i.posthog.com'
)
```
Django integration
If you're using Django, check out our Django integration for automatic request tracking.
3
Send events
Recommended
Once installed, PostHog will automatically start capturing events. You can also manually send events to test your integration:
Capture custom events by calling the capture method with an event name and properties:
Python
PostHog AI
```
import posthog
posthog.capture('user_123', 'user_signed_up', properties={'example_property': 'example_value'})
```
Verify PostHog is initialized
Recommended
Before proceeding, enable debug and call posthog.capture('test_event') to make sure you can capture events.
4
Setting up exception autocapture
Recommended
Exception autocapture can be enabled during initialization of the PostHog client to automatically capture any unhandled exceptions thrown by your Python application. It works by setting Python's built-in exception hooks, such as sys.excepthook and threading.excepthook.
Python
PostHog AI
```
from posthog import Posthog
posthog = Posthog("<ph_project_token>", enable_exception_autocapture=True, ...)
```
We recommend setting up and using contexts so that exceptions automatically include distinct IDs, session IDs, and other properties you can set up with tags.
You can also enable code variables capture to automatically capture the state of local variables when exceptions occur, giving you a debugger-like view of your application.
5
Manually capturing exceptions
Optional
For exceptions handled by your application that you would still like sent to PostHog, you can manually call the capture method:
Python
PostHog AI
```
posthog.capture_exception(e, distinct_id="user_distinct_id", properties=additional_properties)
```
You can find a full example of all of this in our Python (and Flask) error tracking tutorial.

Framework-specific exception capture

Optional

Python frameworks often have built-in error handlers. This means PostHog's default exception autocapture won't work and we need to manually capture errors instead. The exact process depends on the framework:

Django

The Python SDK provides a Django middleware that automatically wraps all requests with a context. Add the middleware to your Django settings:

Python

PostHog AI

MIDDLEWARE = [
    # ... other middleware
    'posthog.integrations.django.PosthogContextMiddleware',
    # ... other middleware
]

By default, the middleware captures exceptions and sends them to PostHog. Disable with POSTHOG_MW_CAPTURE_EXCEPTIONS = False. Use POSTHOG_MW_EXTRA_TAGS, POSTHOG_MW_REQUEST_FILTER, and POSTHOG_MW_TAG_MAP to customize. See the Django integration docs for full configuration.

Flask

Python

PostHog AI

from flask import Flask, jsonify
from posthog import Posthog
posthog = Posthog('<ph_project_token>', host='https://us.i.posthog.com')
@app.errorhandler(Exception)
def handle_exception(e):
    event_id = posthog.capture_exception(e)
    response = jsonify({'message': str(e), 'error_id': event_id})
    response.status_code = 500
    return response

FastAPI

Python

PostHog AI

from fastapi.responses import JSONResponse
from posthog import Posthog
posthog = Posthog('<ph_project_token>', host='https://us.i.posthog.com')
@app.exception_handler(Exception)
async def http_exception_handler(request, exc):
    posthog.capture_exception(exc)
    return JSONResponse(status_code=500, content={'message': str(exc)})

Verify error tracking
Recommended
Confirm events are being sent to PostHog
Before proceeding, let's make sure exception events are being captured and sent to PostHog. You should see events appear in the activity feed.
Image: Activity feed with eventsImage: Activity feed with events
Check for exceptions in PostHog

Community questions

Ask a question

Was this page useful?

HelpfulCould be better

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs an MCP server, Needs an API key, Needs Python, Needs Node.js

Security

What our scanner noticed· Low risk

Instructions that use the network

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by

PostHog

Publisher

PostHog (Official)

Source

PostHog/skills · skills/posthog/error-tracking/skills/all · commit a5d30e7

Licence

MIT License (redistribution allowed)

LICENSE (added by AutoGineer from LICENSE)
ATTRIBUTION.md (written by AutoGineer)

Synced

2026-11-08

Also distributed in

PostHog/skills

AutoGineer is not affiliated with or endorsed by PostHog.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download omnibus-instrument-error-tracking.zip

From the author

AutoGineer summary

What it does

When to use it

Advantages

Usage examples

Install

Documentation by PostHog

Add PostHog error tracking

Instructions

Reference files

Key principles

Files

references/python.md

Python error tracking installation - Docs

Install the package

Initialize PostHog

Send events

Verify PostHog is initialized

Setting up exception autocapture

Manually capturing exceptions

Framework-specific exception capture

Django

Flask

FastAPI

Verify error tracking

Community questions

Was this page useful?

Requirements and compatibility

Security

Attribution and licence

Related skills

Claude API

Transformers

Open Notebook

Vision Sft

LLM Evaluation

Lora Qlora Recipes

Download ZIP