Skip to content

leek/agent-skills / skills/fix-posthog-issues

fix-posthog-issues

Verified

Triage active PostHog error-tracking issues by root cause, fix the legit ones, and resolve or suppress the rest with evidence.

FileKindSize
SKILL.mdskill md6.1 KB
agents/openai.yamlconfig226 B
references/posthog-mcp.mdmarkdown1.8 KB

references/posthog-mcp.md

View on GitHub
# PostHog MCP mechanics

The PostHog MCP exposes one `exec` tool, which takes CLI-style command strings:

```text
search <regex>                     # find tools
info <tool_name>                   # read a tool's schema once, then reuse it
schema <tool_name> <field_path>    # drill into any field that carries a `hint`
call <tool_name> <json_input>      # invoke
```

## Error-tracking tools

1. `query-error-tracking-issues-list`: the working set. Filter on `status: active`, and
   order by last seen. **Can lag** (see below).
2. `query-error-tracking-issue`: one issue's detail and impact. This read is fresh.
3. `query-error-tracking-issue-events`: event samples, with stack traces, code
   variables, `session_id`, URL, browser, and person.
4. `error-tracking-issues-partial-update`: takes
   `{"id": "<uuid>", "status": "active" | "resolved" | "suppressed"}`, and also
   `severity`, `name`, and `description`. Use
   `error-tracking-issues-assign-partial-update` for assignees, and
   `error-tracking-issues-merge-create` to fold duplicates into one issue.
5. `error-tracking-suppression-rules-create` / `-list` / `-update`: permanent
   server-side drops.
6. `execute-sql`: session timelines for frame archaeology. Confirm the columns before
   you query. Filter on the `session_id` and a tight timestamp window around the
   exception.

## Status write lag

After `error-tracking-issues-partial-update`, the list can show the old status for a
while (aggregation lag). Confirm with `query-error-tracking-issue` for that id. Do not
write the status again just because the list looks stale.

## `resolved` vs `suppressed`

`resolved` reopens automatically if the error recurs. Use it for fixes pending deploy,
stale issues, and transients. `suppressed` never comes back. Keep it for vendor code you
will never patch and for scanner or browser noise.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall