Development
fix-posthog - Claude MCP Skill
Run /check-posthog, then fix the highest priority PostHog integration issues. Focuses on one issue at a time for safe, incremental fixes. Invoke for: PostHog not working, events not sending, analytics broken.
SEO Guide: Enhance your AI agent with the fix-posthog tool. This Model Context Protocol (MCP) server allows Claude Desktop and other LLMs to run /check-posthog, then fix the highest priority posthog integration issues. focuses on one issue a... Download and configure this skill to unlock new capabilities for your AI workflow.
Documentation
SKILL.md# /fix-posthog Run `/check-posthog`, then fix the highest priority issue. ## What This Does 1. Run `/check-posthog` to identify issues 2. Pick the highest priority unfixed issue 3. Implement the fix 4. Verify the fix works 5. Report what was fixed **Fixes one issue per invocation.** Run multiple times to fix multiple issues. ## Fix Playbook ### P0: SDK Not Initialized **Problem:** `initPostHog()` not called or PostHogProvider missing. **Fix:** ```bash codex exec --full-auto "Add PostHog initialization. \ Create lib/analytics/posthog.ts with initPostHog(). \ Create PostHogProvider component. \ Add to app/layout.tsx. \ Reference: ~/.claude/skills/posthog/references/sdk-patterns.md. \ Verify: pnpm typecheck" \ --output-last-message /tmp/codex-fix.md 2>/dev/null ``` ### P0: API Key Missing **Problem:** `NEXT_PUBLIC_POSTHOG_KEY` not set. **Fix:** ```bash # Get key from PostHog dashboard # Add to .env.local echo "NEXT_PUBLIC_POSTHOG_KEY=phc_xxx" >> .env.local # Add to Vercel production printf '%s' 'phc_xxx' | vercel env add NEXT_PUBLIC_POSTHOG_KEY production ``` ### P1: No Reverse Proxy **Problem:** Direct PostHog host gets blocked by ad blockers. **Fix:** ```bash codex exec --full-auto "Add PostHog reverse proxy to next.config. \ Add rewrites for /ingest/* to us.i.posthog.com/*. \ Add rewrites for /ingest/static/* to us-assets.i.posthog.com/static/*. \ Update posthog.init to use api_host: '/ingest'. \ Reference: ~/.claude/skills/posthog/references/sdk-patterns.md section 4. \ Verify: pnpm build" \ --output-last-message /tmp/codex-fix.md 2>/dev/null ``` ### P1: Privacy Masking Missing **Problem:** `mask_all_text` and `maskAllInputs` not configured. **Fix:** ```bash codex exec --full-auto "Add privacy settings to PostHog init. \ Add mask_all_text: true. \ Add session_recording.maskAllInputs: true. \ Add person_profiles: 'identified_only'. \ Reference: ~/.claude/skills/posthog/references/privacy-checklist.md. \ Verify: pnpm typecheck" \ --output-last-message /tmp/codex-fix.md 2>/dev/null ``` ### P1: PII in identify() Calls **Problem:** Email/name passed to `posthog.identify()`. **Fix:** ```bash codex exec --full-auto "Remove PII from posthog.identify calls. \ Only pass user ID, no email/name/phone properties. \ Search: grep -rE 'posthog.identify.*email|identify.*name' --include='*.ts' --include='*.tsx'. \ Verify: pnpm typecheck && grep -rE 'posthog.identify.*email' returns no results" \ --output-last-message /tmp/codex-fix.md 2>/dev/null ``` ### P2: No Standard Events **Problem:** No typed event schema defined. **Fix:** ```bash codex exec --full-auto "Add typed event schema to PostHog analytics. \ Create StandardEvent type with: user_signed_up, user_activated, subscription_started, subscription_cancelled, feature_used. \ Add trackEvent function that enforces type. \ Reference: ~/.claude/skills/posthog/references/sdk-patterns.md section 1. \ Verify: pnpm typecheck" \ --output-last-message /tmp/codex-fix.md 2>/dev/null ``` ## Verification After each fix, verify with MCP: ``` # Check events are flowing mcp__posthog__query-run with TrendsQuery for last 1h # Check for errors mcp__posthog__list-errors ``` Manual browser verification: 1. Open DevTools → Network 2. Filter for `ingest` or `posthog` 3. Trigger action → verify request succeeds 4. Check PostHog Live Events → verify event appears ## Output After fixing, report: - What was fixed - How it was verified - What's the next priority issue (if any) ## Related - `/check-posthog` - Audit only (no fixes) - `/log-posthog-issues` - Create GitHub issues - `/posthog` - Full lifecycle workflow
Signals
Information
- Repository
- phrazzld/claude-config
- Author
- phrazzld
- Last Sync
- 3/2/2026
- Repo Updated
- 3/1/2026
- Created
- 1/31/2026
Reviews (0)
No reviews yet. Be the first to review this skill!
Related Skills
upgrade-nodejs
Upgrading Bun's Self-Reported Node.js Version
cursorrules
CrewAI Development Rules
cn-check
Install and run the Continue CLI (`cn`) to execute AI agent checks on local code changes. Use when asked to "run checks", "lint with AI", "review my changes with cn", or set up Continue CI locally.
CLAUDE
CLAUDE.md
Related Guides
Bear Notes Claude Skill: Your AI-Powered Note-Taking Assistant
Learn how to use the bear-notes Claude skill. Complete guide with installation instructions and examples.
Mastering tmux with Claude: A Complete Guide to the tmux Claude Skill
Learn how to use the tmux Claude skill. Complete guide with installation instructions and examples.
OpenAI Whisper API Claude Skill: Complete Guide to AI-Powered Audio Transcription
Learn how to use the openai-whisper-api Claude skill. Complete guide with installation instructions and examples.