PostHog/ai-plugin

آخر نشاط مصدر مسجل: ٢٣ أكتوبر ٢٠٢٦ في ١٢:٠٨

آخر تحديث لفهرس SkillsMP: ٢ نوفمبر ٢٠٢٦ في ١٨:٠٢

skills مجمعة: ١٣٩

نجوم GitHub: ٩٥
تفرعات GitHub: ٢٠

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/PostHog/ai-plugin.

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

# PostHog AI plugin Official PostHog plugin for AI clients. Access PostHog products directly from your AI coding tool. ## Installation ### Claude Code 1. Install the plugin: ```bash claude plugin install posthog ``` Or install from this repo as a marketplace: ```bash claude plugin marketplace add PostHog/ai-plugin claude plugin install posthog@posthog ``` 2. Authenticate via OAuth: ```bash # Just enter Claude Code anywhere claude # Then, use the /mcp command within Claude, select plugin:posthog:posthog, and press Enter /mcp ``` Then follow the browser prompts to log into PostHog. 3. (Optional) Send Claude Code sessions to PostHog LLM Analytics. Add to `~/.claude/settings.json` (global) or `.claude/settings.local.json` (per-project): ```json { "env": { "POSTHOG_LLMA_CC_ENABLED": "true", "POSTHOG_API_KEY": "phc_...", "POSTHOG_HOST": "https://eu.i.posthog.com" } } ``` Both `POSTHOG_LLMA_CC_ENABLED=true` and `POSTHOG_API_KEY` are required. Sessions are sent when Claude Code exits. Set `POSTHOG_LLMA_PRIVACY_MODE=true` to redact prompt/output content. Add custom properties to all events with `POSTHOG_LLMA_CUSTOM_PROPERTIES` (JSON string, e.g. `'{"ai_product": "my-app"}'`). Set `POSTHOG_AI_PURPOSE` to declare what the session is doing relative to the repo — documented values are `authoring` and `review`, emitted as `$ai_purpose`. Useful when a harness wraps an agent it can't modify (e.g. a CI job running Claude Code as a reviewer); left unset the property is omitted. #### Session capture without the rest of the plugin To send Claude Code sessions to PostHog LLM analytics without the skills, the slash commands, or the MCP server, install the capture plugin on its own: ```bash claude plugin marketplace add PostHog/ai-plugin claude plugin install posthog-telemetry@posthog ``` It registers one `SessionEnd` hook and nothing else, so it adds nothing to the context of a session. It needs only the Python standard library, and it reads the same environment variables as step 3 above. Install it instead of the `posthog` plugin, not alongside it. Both register the same hook, so running both parses and uploads every session twice. PostHog dedupes the events themselves, because their UUIDs are derived from the session, but the two hooks race on the status file. ### Cursor Install from the [Cursor Marketplace](https://cursor.com/marketplace) or add manually in Cursor Settings > Plugins. The plugin installs the PostHog skills and the MCP server. Claude Code's session capture and the write-command gate don't run in Cursor. In Cursor IDE, the MCP connection runs through Cursor's hosted service, so Cursor holds your PostHog sign-in and you may need to sign in again after updating the plugin. Grok Bot (desktop and mobile) lists the same plugin from the Cursor Marketplace. Open **Plugins**, search for **PostHog**, install it, and log into PostHog when prompted. ### Codex 1. Add the marketplace: ```bash codex plugin marketplace add PostHog/ai-plugin ``` 2. Install the plugin from inside Codex: ``` codex # Then run /plugins, select PostHog, and install /plugins ``` 3. Trust the plugin's hook when Codex asks you to review it at startup, or later from `/hooks`. The hook approves known PostHog reads (`tools`, `search`, `info` and the other read-only `exec` commands, and calls to tools on `hooks/read-tools.txt`) so they run without a prompt. Every other call, including every write, gets Codex's own approval prompt. The `POSTHOG_MCP_EXEC_GATE_*` variables don't apply on Codex. Codex asks before every PostHog call until you trust the hook, and again after each plugin update until you re-trust it. The one exception is `render-ui`, which shows a PostHog chart or view in the conversation and never changes data, so it always runs without a prompt. A few Codex settings change this: - A `[mcp_servers.posthog]` entry in your own `~/.codex/config.toml` replaces the plugin's server config entirely, including the prompt mode the gate relies on. Remove it, or add `default_tools_approval_mode = "prompt"` and a `[mcp_servers.posthog.tools.render-ui]` table with `approval_mode = "approve"` to it. - With approval policy `never` and full access (`--dangerously-bypass-approvals-and-sandbox`), Codex approves MCP calls before the hook runs, so nothing is gated. - With approval policy `never` and a restricted sandbox, calls the hook doesn't approve are denied instead of prompted. ### Antigravity 1. Install the plugin: ```bash agy plugin install https://github.com/PostHog/ai-plugin ``` 2. Authenticate via OAuth: run `/mcp`, select `posthog_posthog`, and choose **Authenticate**. Open the link it shows, log into PostHog, and paste the authorization code back into Antigravity. The plugin installs the PostHog skills and the MCP server. Claude Code's session capture and the write-command gate don't run in Antigravity. ### Gemini CLI ```bash gemini extensions install https://github.com/PostHog/ai-plugin ``` ### Grok 1. Install the plugin: ```bash grok plugin install PostHog/ai-plugin --trust ``` 2. Authenticate via OAuth: On first use of a PostHog tool, Grok prompts you to authorize in your browser. Log into PostHog to connect. ### Claude Cowork 1. Add the marketplace: open **Settings** > **Plugins**, click **Add** > **Add marketplace**, enter `PostHog/ai-plugin`, and click **Sync**. 2. Install the plugin: click **Browse**, select **PostHog**, and install. The plugin stays in sync with this repo automatically. 3. Authenticate via OAuth: on first use of a PostHog tool, follow the browser prompts to log into PostHog. ## How to develop 1. Clone and install the plugin: ```bash git clone https://github.com/PostHog/ai-plugin claude --plugin-dir ./ai-plugin ``` 2. Authenticate via OAuth: ``` /mcp ``` Then follow the browser prompts to log into PostHog. ## Features This plugin provides access to 27+ PostHog tools across these categories: - **Feature flags** - Create, update, and manage feature flags - **Experiments** - Run and analyze A/B tests - **Insights** - Query analytics and create visualizations - **Dashboards** - Manage dashboards and add insights - **Error tracking** - View and debug errors - **LLM analytics** - Track AI/LLM costs and usage - **Documentation** - Search PostHog docs - And more ### Bundled skills The plugin also ships 30+ task-specific skills that your AI client loads on demand to follow PostHog best practices — covering HogQL query patterns, experiment creation and lifecycle, feature flags, data warehouse setup and troubleshooting, LLM analytics exploration, session replay diagnostics, and SDK instrumentation. Skills activate automatically when their description matches your request (e.g. "create an experiment", "why isn't my Stripe sync working?", "audit my feature flags"), so you generally don't need to invoke them by name. ## Example usage ``` > What feature flags do I have? > Create a feature flag called new-onboarding for 50% of users > Show me errors from the last 24 hours > Which errors are affecting the most users? > How many users signed up this week? > What's the conversion rate for the checkout funnel? > Show me all my experiments > What are the results of the checkout-flow experiment? > Create a new dashboard called Product Metrics > Add the signup funnel insight to the Growth dashboard > What are the responses to the NPS survey? > Create a feedback survey for the checkout page > What's my most triggered event? > Show me the top 10 pages by pageviews ``` ## Plugin usage telemetry In Claude Code, the plugin sends one anonymous `plugin skill invoked` event to PostHog Cloud each time one of this plugin's skills runs, whether Claude invokes it or you type `/posthog:<skill>`. Skills from other plugins and your own skills aren't counted. Each event contains only: - `skill`: the skill's name, such as `querying-posthog-data` - `invocation`: `model` when Claude invoked the skill, `user` when you typed it as a slash command - `args_present`: whether the skill was invoked with arguments, never the arguments themselves - `plugin_version`: the installed plugin version - `permission_mode`: Claude Code's permission mode, such as `default` or `plan` - `os`: the operating system name from `uname -s`, such as `Darwin` or `Linux` - `distinct_id`: a random UUID generated once per install and stored in the plugin's data directory - `$lib`: always `posthog-ai-plugin` - `$process_person_profile`, `$geoip_disable`, and `$ip`: fixed values (`false`, `true`, and `127.0.0.1`) so PostHog creates no person profile and runs no GeoIP lookup, and the stored event carries no client IP address. The request still reaches PostHog's capture endpoint from your IP, as any HTTPS request does No event is sent when `POSTHOG_MCP_URL` or `POSTHOG_HOST` points anywhere other than `posthog.com`, so self-hosted users don't report to PostHog Cloud. Like Claude Code's own telemetry, it's also off when Claude Code runs on Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, or Claude Platform on AWS (`CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, or `CLAUDE_CODE_USE_ANTHROPIC_AWS` set to `1`, `true`, `yes`, or `on`). To turn it off, set any of these in your shell or the `env` block of `~/.claude/settings.json`: ```bash export DO_NOT_TRACK=1 export POSTHOG_PLUGIN_TELEMETRY_DISABLED=1 export DISABLE_TELEMETRY=1 export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 ``` `DO_NOT_TRACK` and `DISABLE_TELEMETRY` turn off Claude Code's own telemetry too, and `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` turns off all of Claude Code's nonessential traffic. `POSTHOG_PLUGIN_TELEMETRY_DISABLED` turns off only this plugin's telemetry. ## Self-hosted For self-hosted PostHog instances, set the `POSTHOG_MCP_URL` environment variable to point to your instance: ```bash export POSTHOG_MCP_URL="https://mcp.your-posthog-instance.com/mcp" ``` ## Documentation - [PostHog MCP documentation](https://posthog.com/docs/model-context-protocol) - [PostHog API documentation](https://posthog.com/docs/api) ## License MIT

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

مطوّرو البرمجيات علماء البيانات

٢ فئات مهنية · 6% مصنفة

skill

المهنة

الوصف

آخر تحديث

creating-online-evaluations

غير مصنف

Author continuously-running online evaluations in PostHog AI observability, grounded in real failure modes you've identified. Use when the user wants evaluations that automatically score new generations or whole traces going forward — "create an eval to catch…

لغة النص الأصلي: الإنجليزية

2026-10-23

querying-posthog-data

غير مصنف

Explains how to query PostHog data, defaulting to typed runners for supported product analytics. Read it before you write HogQL/SQL. Also read it before you call execute-sql against PostHog. Use it to find or aggregate PostHog entities. These entities include…

لغة النص الأصلي: الإنجليزية

2026-10-23

reviewing-warehouse-suggestions

غير مصنف

Reviews PostHog's warehouse suggestions with a person and acts on them. Explains why a view should be materialized, unmaterialized, certified or deprecated using the numbers in the suggestion, changes a materialize suggestion's refresh mode, keys or interval…

لغة النص الأصلي: الإنجليزية

2026-10-23

signals-scout-product-analytics

غير مصنف

Signals scout for core product-analytics flows — funnels, retention, lifecycle, stickiness, and paths. Watches the team's saved flows for a derived-rate regression while entrants hold.

لغة النص الأصلي: الإنجليزية

2026-10-23

signals-scout-workflows

غير مصنف

Signals scout for PostHog workflows. Looks at the workflows whose owner asked for suggestions, reads each email step's per-version delivery metrics, and proposes one concrete change a person can approve, filed through the workflows suggestions API. It files…

لغة النص الأصلي: الإنجليزية

2026-10-23

understanding-billing-usage

غير مصنف

Explains PostHog billing usage and spend from the customer's visible Billing MCP tools. Use when the user asks why usage or spend is high, which product or project is driving usage, what a usage type means, how to reduce usage, what changed over time, why…

لغة النص الأصلي: الإنجليزية

2026-10-23

auditing-warehouse-view-health

غير مصنف

Audit the health of a PostHog project's materialized views (saved queries) — find every failed materialization and flag unused or stale materialized views that cost storage and compute. Use when the user asks "which of my views are broken?", "why is this…

لغة النص الأصلي: الإنجليزية

2026-10-22

authoring-scouts

غير مصنف

Write, edit, and adapt PostHog Signals scouts: scheduled agents that scan a project and report findings. Use to change a canonical scout's scope, thresholds, schedule, or dry-run settings; add a scout for an uncovered surface; record structured output from…

لغة النص الأصلي: الإنجليزية

2026-10-22

building-workflows

غير مصنف

Build, edit, test, enable, and monitor PostHog workflows over MCP. Author the action/edge graph so it runs and opens cleanly in the visual editor, then change drafts surgically with patch operations. Use when asked to build, set up, automate, change, fix, or…

لغة النص الأصلي: الإنجليزية

2026-10-22

configuring-experiment-analytics

غير مصنف

Configures the analytics side of a PostHog experiment — exposure criteria (server-resolved default exposure event vs custom exposure events), primary and secondary metrics, the supported metric types (count, sum, ratio with `math` and `math_property`,…

لغة النص الأصلي: الإنجليزية

2026-10-22

exploring-scouts

غير مصنف

How to explore and make sense of PostHog Signals scouts — the scheduled agents that scan a project and write reports into the Signals inbox. Use when a user wants to understand what scouts they have, how each one is behaving, and whether the fleet is actually…

لغة النص الأصلي: الإنجليزية

2026-10-22

setting-up-data-catalog

غير مصنف

Populates and maintains a project's data catalog (semantic layer): canonical metrics, trust marks (certifications) on warehouse tables/views, and reviewed table relationships. Use when asked to set up / seed / bootstrap the data catalog or semantic layer, to…

لغة النص الأصلي: الإنجليزية

2026-10-22

signals-scout-apm

غير مصنف

Signals scout for PostHog distributed tracing (APM / OpenTelemetry spans). Watches per-service RED metrics for error-rate and latency regressions, new error signatures, and traffic cliffs, and audits for standing performance issues: N+1 calls, expensive query…

لغة النص الأصلي: الإنجليزية

2026-10-22

working-with-autoresearch

غير مصنف

Use PostHog Autoresearch, agent-driven predictive models: ask "who will do X in the next N days?", let an agent train a model, then score people daily into a person property and `autoresearch_prediction` events. Use when a user wants to predict churn,…

لغة النص الأصلي: الإنجليزية

2026-10-22

working-with-scouts

غير مصنف

Work with PostHog Signals scouts: scheduled agents that monitor a project and write reports into the Signals inbox. Use to assign monitoring work, schedule quality scoring, find which scout covers a surface, act on reports, reduce noise, investigate missing…

لغة النص الأصلي: الإنجليزية

2026-10-22

analyzing-funnel-correlation

غير مصنف

Find the events and person properties that correlate with funnel conversion or drop-off. Use when the user asks why people convert or drop off in a funnel, what converters do differently, which events or properties predict success or failure, or asks for…

لغة النص الأصلي: الإنجليزية

2026-10-21

authoring-error-tracking-alerts

غير مصنف

Author error tracking alerts that fire when an issue is created, reopened, or starts spiking. Use when the user asks to set up error notifications, route exceptions to Slack/webhook/Linear, or evaluate which error events are worth alerting on. Covers…

لغة النص الأصلي: الإنجليزية

2026-10-21

context-layer-health-check

غير مصنف

Reviews context wiki quality after deterministic consolidation. Use when recent wiki-miss entries, contradictory or unsupported claims, stale priorities, near-duplicate subjects, or concepts without an owning page need semantic triage.

لغة النص الأصلي: الإنجليزية

2026-10-21

designing-email-templates

غير مصنف

Author, save, and edit email templates in the PostHog workflows library — compose email design JSON with Liquid personalization and create and round-trip-edit templates over MCP. Use when asked to design, build, update, or fix an email template for workflows,…

لغة النص الأصلي: الإنجليزية

2026-10-21

diagnosing-experiment-health

غير مصنف

Runs diagnostics and a health check on one PostHog experiment: its setup, exposures, results and changes during the run. Covers 0 exposures, sample ratio mismatch, lost or uneven exposures, users in multiple variants, identity faults, who the experiment…

لغة النص الأصلي: الإنجليزية

2026-10-21

diagnosing-failed-warehouse-syncs

غير مصنف

Diagnose why a data warehouse sync is failing and recommend the right recovery action. Use when the user asks "why isn't my Stripe/Postgres/Hubspot sync working?", "this table has been stuck for hours", "the data in the warehouse looks wrong", or wants to…

لغة النص الأصلي: الإنجليزية

2026-10-21

exploring-ai-failures

غير مصنف

Find where an AI/LLM application is failing in production and surface the failure patterns, working from real traces. Use when someone wants to understand what's going wrong with an AI feature, find and categorize failure modes, triage errors, or investigate…

لغة النص الأصلي: الإنجليزية

2026-10-21

exploring-apm-traces

غير مصنف

Investigates distributed application performance using PostHog APM (OpenTelemetry span) data via MCP. Use when the user asks about service traces, slow HTTP/database spans, error spans, error-rate trends or spikes, latency distributions, trace IDs, or span…

لغة النص الأصلي: الإنجليزية

2026-10-21

exploring-llm-clusters

غير مصنف

Investigate AI observability clusters — understand usage patterns in AI/LLM traffic, compare cluster behavior, compute cost/latency metrics, and drill into individual traces within clusters.

لغة النص الأصلي: الإنجليزية

2026-10-21

exploring-llm-costs

غير مصنف

Investigate LLM spend in PostHog — total cost over time, cost by model, provider, user, trace, or custom dimension, token and cache-hit economics, and cost regressions. Use when the user asks "how much are we spending on LLMs?", "which model / user / feature…

لغة النص الأصلي: الإنجليزية

2026-10-21

installing-posthog-from-chat

غير مصنف

Set up PostHog in a user's GitHub repository from a chat, without a terminal. Wizard, PostHog's setup agent, runs in the cloud, adds the SDK and first events, and opens a pull request. Use when a user in ChatGPT, Claude, or another chat client asks to…

لغة النص الأصلي: الإنجليزية

2026-10-21

instrument-error-tracking

غير مصنف

Add PostHog error tracking to capture and monitor exceptions. Use after implementing features or reviewing PRs to ensure errors are tracked with stack traces and source maps. Also handles initial PostHog SDK setup if not yet installed.

لغة النص الأصلي: الإنجليزية

2026-10-21

instrument-feature-flags

غير مصنف

Add PostHog feature flags to gate new functionality. Use after implementing features or reviewing PRs to ensure safe rollouts with feature flag controls. Also handles initial PostHog SDK setup if not yet installed.

لغة النص الأصلي: الإنجليزية

2026-10-21

instrument-integration

غير مصنف

Add PostHog SDK integration to your application. Use when setting up PostHog for the first time or reviewing PRs that need PostHog initialization. Covers SDK installation, provider setup, and basic configuration for any framework.

لغة النص الأصلي: الإنجليزية

2026-10-21

instrument-llm-analytics

غير مصنف

Add PostHog AI Observability to trace AI model usage. Use after implementing LLM features or reviewing PRs to ensure all generations are captured with token counts, latency, and costs. Also handles initial PostHog SDK setup if not yet installed.

لغة النص الأصلي: الإنجليزية

2026-10-21

instrument-logs

مطوّرو البرمجيات

Add PostHog log capture to track application logs. Use after implementing features or reviewing PRs to ensure meaningful log events are captured with structured properties. Also handles initial OTLP exporter setup if not yet configured.

لغة النص الأصلي: الإنجليزية

2026-10-21

instrument-metrics

غير مصنف

Add PostHog metric capture to track counters, gauges, and histograms. Use after implementing features or reviewing PRs to ensure key operations are measured, or when asked to add metrics, counters, or track a value over time. Also handles mirroring existing…

لغة النص الأصلي: الإنجليزية

2026-10-21

instrument-product-analytics

غير مصنف

Add PostHog product analytics events to track user behavior. Use after implementing new features or reviewing PRs to ensure meaningful user actions are captured. Also handles initial PostHog SDK setup if not yet installed.

لغة النص الأصلي: الإنجليزية

2026-10-21

setting-up-a-custom-rest-source

غير مصنف

Connect an arbitrary REST API to the PostHog data warehouse as a Custom source by authoring a JSON manifest, with no per-source code. Use when the user points at an API that has no built-in PostHog connector — "import data from this REST API", "sync my…

لغة النص الأصلي: الإنجليزية

2026-10-21

signals-scout-experiments

غير مصنف

Signals scout for PostHog A/B experiments. Watches running experiments for validity threats — sample ratio mismatch, contamination, exposure stalls, mid-run flag mutations — and lifecycle drift.

لغة النص الأصلي: الإنجليزية

2026-10-21

signals-scout-general

غير مصنف

Cross-product Signals scout. Looks for cross-product correlations and explores the surfaces the per-product specialist scouts don't cover.

لغة النص الأصلي: الإنجليزية

2026-10-21

tuning-incremental-sync-config

غير مصنف

Change the sync configuration of an existing data warehouse schema — switch sync_type, pick a different incremental_field, set primary_key_columns, choose cdc_table_mode, or change sync_frequency. Use when the user asks "switch my orders table from full…

لغة النص الأصلي: الإنجليزية

2026-10-21

creating-replay-vision-scanners

غير مصنف

Guides agents through creating and safely sizing a Replay Vision scanner: choosing the scanner type (monitor/classifier/scorer/summarizer), shaping the RecordingsQuery that selects sessions, and — crucially — estimating the credits it will spend and checking…

لغة النص الأصلي: الإنجليزية

2026-10-20

investigating-replay

غير مصنف

Investigates a session recording by gathering metadata, person profile, same-session events, and linked error tracking issues in one pass. Use when a user provides a recording or session ID and wants to understand what happened — who the user was, what they…

لغة النص الأصلي: الإنجليزية

2026-10-20

resolving-ingestion-warnings

غير مصنف

Diagnoses and resolves PostHog ingestion warnings — problems recorded while ingesting events (dropped events, rejected person merges, oversized payloads, invalid data). Use when a user asks why events are missing, dropped, or undercounted, why identify/alias…

لغة النص الأصلي: الإنجليزية

2026-10-20

عرض ٤٠ من أصل ١٣٩ skills مجمعة.