Error Tracking Web — Agent Skill by PostHog

From the author

PostHog error tracking for Web (JavaScript)

— the description by PostHog

AutoGineer summary

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

This skill provides guidance on implementing PostHog error tracking within JavaScript web applications. It covers SDK initialization, manual exception capture, and best practices for managing error data, including the use of source maps for readable stack traces and proper user identification to avoid PII leakage. The skill also outlines how to configure alerts and automate issue assignment to streamline debugging workflows.

What it does

Initializes the PostHog JavaScript SDK for browser-based error tracking.
Enables automatic exception capture for monitoring application crashes and errors.
Provides methods for manual error capture at specific application boundaries.
Supports source map uploads to de-minify stack traces for easier debugging.
Configures automated issue assignment rules based on exception properties.
Sets up alert notifications for new, reopened, or spiking error issues.

When to use it

When you need to monitor runtime errors in a JavaScript web application.
When you want to automate the triage and assignment of software issues to team members.
When you need to receive real-time alerts for critical application errors or error spikes.
When you need to correlate frontend errors with user sessions and feature flags.

Advantages

Centralizes error monitoring and user behavior data in one platform.
Reduces manual triage time through automated assignment rules.
Improves debugging efficiency by resolving minified stack traces via source maps.
Helps maintain data privacy by distinguishing between event properties and user identification.

Usage examples

“How do I initialize PostHog for error tracking in my React app?”: The agent provides the posthog.init() code snippet, ensuring it is called before other methods and configured with environment variables for keys and host URLs.
“How can I alert my team when a specific error spikes?”: The agent guides you to the error tracking configuration page to set up spike alerts based on historical baselines or event volume.

Install

Download the skill as a ZIP:
https://autogineer.com/agent-skills/posthog/error-tracking-web/download

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

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

Documentation by PostHog

PostHog error tracking for Web (JavaScript)

This skill helps you add PostHog error tracking to Web (JavaScript) applications.

Reference files

references/web.md - Web 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

Consult the documentation for API details and framework-specific patterns.

Key principles

Environment variables: Always use environment variables for PostHog keys and host URLs. Never hardcode them.
Minimal changes: Add error tracking alongside existing error handling. Don't replace or restructure existing error handling code.
Autocapture first: Enable exception autocapture in the SDK initialization 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.

Framework guidelines

Remember that source code is available in the node_modules directory
Check package.json for type checking or build scripts to validate changes
posthog-js is the JavaScript SDK package name
posthog.init() MUST be called before any other PostHog methods (capture, identify, etc.)
posthog-js is browser-only — do NOT import it in Node.js or server-side contexts (use posthog-node instead)
Autocapture is ON by default with posthog-js (tracks clicks, form submissions, pageviews). Do NOT disable autocapture unless the user explicitly requests it.
NEVER send PII in posthog.capture() event properties — no emails, full names, phone numbers, physical addresses, IP addresses, or user-generated content
PII belongs in posthog.identify() person properties (email, name, role), NOT in capture() event properties
Call posthog.identify(userId, { email, name, role }) on login AND on page refresh if the user is already logged in
Call posthog.reset() on logout to unlink future events from the current user
For SPAs without a framework router, capture pageviews with posthog.capture($pageview) or use the capture_pageview history_change option in init for History API routing

Files

ATTRIBUTION.mdAdded by AutoGineer954 B
LICENSELicence file added by AutoGineer1.0 KiB
SKILL.md2.5 KiB
references/alerts.md4.1 KiB
references/assigning-issues.md5.5 KiB
references/fingerprints.md3.4 KiB
references/monitoring.md8.6 KiB
references/upload-source-maps.md2.7 KiB
references/web.md5.4 KiB

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 Node.js

Security

No issues found by our static scan· No issues found

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

Claude API
AnthropicOfficial
Comprehensive reference for integrating Anthropic's Claude API, SDKs, and Managed Agents into your applications.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0Medium riskHas scriptsGitHub stars of the source repository188.6k
Transformers
K-Dense· Community
Integrate Hugging Face Transformers for model loading, inference, and fine-tuning across NLP, vision, and audio tasks.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskGitHub stars of the source repository56.4k
Open Notebook
K-Dense· Community
Integrate with the self-hosted Open Notebook platform to automate research ingestion, context-aware chat, and AI-driven analysis.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITLow riskHas scriptsGitHub stars of the source repository56.4k
Vision Sft
Seth Hobson· Community
A structured workflow for supervised fine-tuning of vision-language models, focusing on adapter configuration and silent failure prevention.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
LLM Evaluation
Seth Hobson· Community
A comprehensive framework for evaluating LLM application performance using automated metrics, human feedback, and LLM-as-a-judge techniques.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Lora Qlora Recipes
Seth Hobson· Community
Provides configuration recipes and best-practice hyperparameters for LoRA and QLoRA supervised fine-tuning.
Data and AIClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k