Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions context/skills/ai-observability/config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -426,6 +426,15 @@ variants:
- https://posthog.com/docs/ai-observability/installation/mastra.md
- https://posthog.com/docs/libraries/node.md

- id: google-adk
framework: google-adk
display_name: Google ADK
description: PostHog AI Observability for the Google Agent Development Kit (agent framework, Node)
tags: [google-adk, javascript_node, ai_observability]
docs_urls:
- https://posthog.com/docs/ai-observability/installation/google-adk.md
- https://posthog.com/docs/libraries/node.md

- id: instructor-python
framework: instructor
default: true
Expand Down
2 changes: 1 addition & 1 deletion context/skills/ai-observability/description.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Wire up PostHog's AI Observability so calls made through {display_name} land in

This skill instruments the LLM calls the project *already makes*. It does **not** install the vendor SDK for you.

Check the project's manifest for an LLM package. The catalog is far wider than the obvious providers — 68 variants covering agent frameworks (`openai-agents`, `claude-agent-sdk`, LangGraph, CrewAI, Mastra, …) and OpenAI-compatible gateways (Groq, OpenRouter, Together, Ollama, …), which an app reaches through the `openai` package plus a `baseURL` override. `1-begin.md` carries the ordered decision rules; follow them rather than matching on the first familiar package name. If no LLM SDK is present, switch to the `manual-capture` variant — it posts `$ai_generation` events directly and works standalone.
Check the project's manifest for an LLM package. The catalog is far wider than the obvious providers — 69 variants covering agent frameworks (`openai-agents`, `claude-agent-sdk`, LangGraph, CrewAI, Mastra, …) and OpenAI-compatible gateways (Groq, OpenRouter, Together, Ollama, …), which an app reaches through the `openai` package plus a `baseURL` override. `1-begin.md` carries the ordered decision rules; follow them rather than matching on the first familiar package name. If no LLM SDK is present, switch to the `manual-capture` variant — it posts `$ai_generation` events directly and works standalone.

Everything else this skill needs — PostHog credentials, instrumentation packages, env vars — the skill installs and configures itself. It does **not** require a pre-existing `posthog.init(...)`. If one is already there, reuse its env-var names in `3-instrument.md`; if not, that step sets fresh values via `set_env_values`.

Expand Down
3 changes: 2 additions & 1 deletion context/skills/ai-observability/references/1-begin.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Pick the variant, then read the code. Do not edit anything in this step.

## Pick the variant

This skill ships 68 variants. Call `load_skill_menu` with `category: "ai-observability"`. That list is the source of truth.
This skill ships 69 variants. Call `load_skill_menu` with `category: "ai-observability"`. That list is the source of truth.

Apply these rules in order. The first match wins. Frameworks wrap providers, and gateways look like OpenAI, so the order matters.

Expand All @@ -32,6 +32,7 @@ Apply these rules in order. The first match wins. Frameworks wrap providers, and
| `instructor` | `instructor-{python,node}` |
| `litellm` | `litellm` |
| `mastra`, `@mastra/core` | `mastra` |
| `@google/adk` | `google-adk` |
| `convex` | `convex` |

Instrument the framework, not the provider below it. A provider instrumentor keeps the model calls and loses the agent, tool, and handoff structure.
Expand Down
Loading