Logs Nextjs — Agent Skill by PostHog

From the author

PostHog logs for Next.js

— the description by PostHog

AutoGineer summary

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

This skill provides guidance and best practices for configuring log ingestion in Next.js applications to send data to PostHog. It emphasizes the use of the OpenTelemetry protocol and structured logging to ensure logs are actionable, searchable, and context-rich. By following these patterns, developers can centralize system logs alongside product analytics and session replays, enabling more efficient debugging and monitoring of production environments.

What it does

Provides instructions for setting up PostHog log ingestion in Next.js.
Promotes the use of structured logging over plain text for better queryability.
Encourages the use of wide events to capture request-level context.
Outlines best practices for log levels, cardinality, and business context.
Supports integration with OpenTelemetry for standardized data export.

When to use it

When you need to centralize system logs from a Next.js application.
When you want to correlate system logs with user sessions and product analytics.
When you are implementing or refactoring logging to improve production observability.
When you need to debug complex request flows using trace and session context.

Advantages

Enables unified visibility across logs, analytics, and session replays.
Reduces noise by focusing on request-level wide events.
Standardizes log data using OpenTelemetry protocols.
Improves debugging efficiency by linking logs to specific user sessions.

Usage examples

“How do I set up PostHog logs in my Next.js 15 application?”: The agent provides the steps to initialize PostHog in instrumentation-client.ts and configure the OTLP exporter.
“What is the best way to log payment processing in my app?”: The agent advises against step-by-step code logging, suggesting a single wide event containing relevant metadata like order_id and amount_cents.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/posthog/logs-nextjs/download

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

mkdir -p .agents/skills && unzip logs-nextjs.zip -d .agents/skills

Documentation by PostHog

PostHog logs for Next.js

This skill helps you add PostHog log ingestion to Next.js applications.

Reference files

references/nextjs.md - Next.js logs installation - docs
references/start-here.md - Getting started with logs - docs
references/search.md - Search logs - docs
references/best-practices.md - Logging best practices - docs
references/troubleshooting.md - Logs troubleshooting - docs
references/link-session-replay.md - Link session replay - docs
references/debug-logs-mcp.md - Debug logs with mcp - docs

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

Key principles

Environment variables: Always use environment variables for PostHog keys and OpenTelemetry endpoints. Never hardcode them.
Minimal changes: Add log export alongside existing logging. Don't replace or restructure existing logging code.
OpenTelemetry: PostHog logs use the OpenTelemetry protocol. Configure an OTLP exporter pointed at PostHog's ingest endpoint.
Structured logging: Prefer structured log formats with key-value properties over plain text messages.

Framework guidelines

For Next.js 15.3+, initialize PostHog in instrumentation-client.ts for the simplest setup

Files

ATTRIBUTION.mdAdded by AutoGineer933 B
LICENSELicence file added by AutoGineer1.0 KiB
SKILL.md1.3 KiB
references/best-practices.md19.6 KiB
references/debug-logs-mcp.md2.2 KiB
references/link-session-replay.md4.9 KiB
references/nextjs.md5.5 KiB
references/search.md2.5 KiB
references/start-here.md2.4 KiB
references/troubleshooting.md3.5 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.

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