# investigating-logs

The investigating-logs Claude Code skill investigates logs in a PostHog project, checks service health and traces error spikes. It runs for deploy checks, incident triage, change analysis, or a search around one trace or run.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 188 installs · ★ 101 repo stars
- Author: PostHog
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/investigating-logs/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/investigating-logs

## What it does

The skill examines PostHog project logs to help identify service health, changes in message patterns, and reasons for error spikes. It starts with summaries and comparisons across time windows; raw log rows come later. Summaries first.

PostHog tools group entries by service, severity, and pattern, track counts over time, and retrieve context around a log line, trace, or run. A post-change check compares windows on either side of the change; it needs a time boundary to make that comparison meaningful. The skill can also locate logs tied to an alert or user complaint.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill investigating-logs -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/investigating-logs/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/investigating-logs/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill investigating-logs -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/investigating-logs/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill investigating-logs -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/investigating-logs/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/investigating-logs
```

2. **Manually: put the files in place**
- File: `.github/skills/investigating-logs/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill investigating-logs -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/investigating-logs
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/investigating-logs/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill investigating-logs -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/investigating-logs/SKILL.md

## When to use it
- check whether a service still emits logs after a deployment
- find new error patterns after a configuration change
- break an error spike down by time window
- inspect log context around a trace or run
- identify which service is involved in an incident

## Example prompts
- Check the PostHog project logs after the latest deployment and compare them with the earlier period.
- Why did the error count rise? Investigate the spike in the logs.
- Find the logs around this trace and explain what happened.

## Similar
- [investigating-incidents-with-aws-devops-agent](https://affpapa.org/en/nevibecode/skills/investigating-incidents-with-aws-devops-agent.md) — skill · 1600 installs
- [dt-obs-logs](https://affpapa.org/en/nevibecode/skills/dt-obs-logs.md) — skill · 3000 installs
- [dd-logs](https://affpapa.org/en/nevibecode/skills/dd-logs.md) — skill · 2300 installs
- [mcloud-logs](https://affpapa.org/en/nevibecode/skills/mcloud-logs.md) — skill · 1600 installs
- [platform-apex-logs-debug](https://affpapa.org/en/nevibecode/skills/platform-apex-logs-debug.md) — skill · 7200 installs
- [investigating-replay](https://affpapa.org/en/nevibecode/skills/investigating-replay.md) — skill · 424 installs

From the same set: [posthog/ai-plugin](https://affpapa.org/en/nevibecode/by/posthog/ai-plugin.md) — 82 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
