Official agent skill

Diagnosing SDK Health

by PostHog in PostHog/posthog

Diagnoses the health of a project's PostHog SDK integrations — which SDKs are out of date and how to fix them.

OfficialCustom licenceAuto-check passedBackend & APIs

Install Diagnosing SDK Health

skills CLI
$ npx skills add PostHog/posthog --skill diagnosing-sdk-health -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install PostHog/posthog diagnosing-sdk-health --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/PostHog/posthog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/products/growth/skills/diagnosing-sdk-health .claude/skills/diagnosing-sdk-health && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
diagnosing-sdk-health
GitHub stars
40k
Token cost
~2.7k tokens
SKILL.md length
1,442 words
Files
1
Skills in repo
254
Repo updated
First seen
Licence
Custom licence

At a glance

Diagnoses the health of a project's PostHog SDK integrations — which SDKs are out of date and how to fix them.

  • Works in 5 steps: Triage with the summary → List the SDK issues → Drill into an issue for the fix → …
  • A user asks about PostHog SDK versions
  • SKILL.md covers Available tools, Trust boundary (read this first), Workflow and Interpreting severity, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Diagnosing SDK Health is an agent skill from PostHog/posthog, published by the product's own GitHub organization. Diagnoses the health of a project's PostHog SDK integrations — which SDKs are out of date and how to fix them. Use when a user asks about PostHog SDK versions, outdated SDKs, upgrade recommendations, "SDK health", "SDK doctor" (the former name), or when events or features seem off and it might be due to an old SDK.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Third-party API integration. It works with PostHog. The repository describes itself as: :hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error…

When your agent uses it

  • A user asks about PostHog SDK versions
  • Upgrade recommendations
  • SDK doctor (the former name)
  • Features seem off and it might be due to an old SDK

Example prompts

  • “SDK health”
  • “SDK doctor”
  • “Use the diagnosing-sdk-health skill to diagnose the health of a project's PostHog SDK integrations — which SDKs are out of date and how to fix them”
  • “/diagnosing-sdk-health”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Triage with the summary
  2. List the SDK issues
  3. Drill into an issue for the fix
  4. Act on the remediation
  5. Link to the UI

What it can do on your machine

Read from SKILL.md and the folder at commit c012c8d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • posthog.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Diagnosing SDK Health loads about 2.7k tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 1,442 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,442 words (~2,713 tokens).

“Outdated PostHog SDKs surface through the project's generic health issues — the same framework that reports data-warehouse sync failures, missing web-analytics events, ingestion warnings, and more. SDK problems are the sdk_outdated kind. The backend has already applied smart semver rules…”

— opening of SKILL.md by PostHog, Custom licence
name
diagnosing-sdk-health

Read the full SKILL.md on GitHub

Files

Just SKILL.md in products/growth/skills/diagnosing-sdk-health of PostHog/posthog.

Open the folder on GitHubat commit c012c8d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in PostHog/posthog, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Diagnosing SDK Health next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Diagnosing SDK Health compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Diagnosing SDK Health this skillPostHog/posthog40k—~2.7kAutomated safety check: PassCustom licence
Sub2API AdminWei-Shaw/sub2api44k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
ToolJet Marketplace Plugin BuilderToolJet/ToolJet41k—~2.1kAutomated safety check: PassAGPL-3.0
Firecrawl Search Integrationfirecrawl/firecrawl190k1 repos~1.1kAutomated safety check: PassISC
CoinGecko API Reference2025Emma/vibe-coding-cn23k1 repos~646Automated safety check: PassMIT

Similar skills

  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    44k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Turns an API description, such as an OpenAPI file or a Postman collection, into a connector plugin for ToolJet's marketplace and checks it with the repo's validator.

    41k GitHub stars~2.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Firecrawl Search Integration

    firecrawl/firecrawl

    Guidance for adding Firecrawl's /search endpoint to product code and agent workflows when a feature starts from a query rather than a URL.

    190k GitHub starsUsed in 1 repo~1.1k tokens
    Backend & APIsAuto-check passed
  • CoinGecko API Reference

    2025Emma/vibe-coding-cn

    CoinGecko API documentation - cryptocurrency market data API, price feeds, market cap, volume, historical data. Use when integrating CoinGecko API, building…

    23k GitHub starsUsed in 1 repo~646 tokens
    Backend & APIsAuto-check passed
  • OmniRoute Provider Management

    diegosouzapw/OmniRoute

    Manages AI provider connections, API keys, OAuth flows and connection tests through OmniRoute's REST API across its 327-provider catalog.

    75k GitHub stars~2.4k tokensUpdated today
    Backend & APIsAuto-check passed

More from PostHog/posthog

All 254 skills in this repo
  • Authoring Log Alerts

    PostHog/posthog

    Official

    Author useful, low-noise log alerts on services in a PostHog project.

    40k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Official

    Operating procedure for the conflict-autoresolver agent: sweep open PostHog/posthog PRs that conflict with master, resolve the trivial conflicts (generated artifacts deterministically, source…

    40k GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Official

    Help users debug PostHog Error Tracking stack-trace symbolication for any supported platform — JavaScript/TypeScript web, React Native (Hermes), Android (Proguard / R8), or iOS / macOS (dSYM).

    40k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Exploring Apm Traces

    PostHog/posthog

    Official

    Investigates distributed application performance using PostHog APM (OpenTelemetry span) data via MCP.

    40k GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Exploring LLM Traces

    PostHog/posthog

    Official

    Debug and inspect LLM/AI agent traces using PostHog's MCP tools.

    40k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Investigate Metric

    PostHog/posthog

    Official

    Diagnose why a product metric changed (dropped, spiked, or plateaued) by orchestrating breakdowns, actors, paths, lifecycle, retention, and annotations queries.

    40k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Diagnosing SDK Health

What does Diagnosing SDK Health do?

Diagnoses the health of a project's PostHog SDK integrations — which SDKs are out of date and how to fix them. Diagnosing SDK Health is an agent skill from PostHog/posthog, published by the product's own GitHub organization. Diagnoses the health of a project's PostHog SDK integrations — which SDKs are out of date and how to fix them.

When should I use Diagnosing SDK Health?

Diagnosing SDK Health fits situations like: A user asks about PostHog SDK versions; upgrade recommendations; SDK doctor (the former name); features seem off and it might be due to an old SDK.

How do I install Diagnosing SDK Health in Claude Code?

Run `npx skills add PostHog/posthog --skill diagnosing-sdk-health -a claude-code`. Or copy the skill folder (products/growth/skills/diagnosing-sdk-health in PostHog/posthog) into .claude/skills/diagnosing-sdk-health in your project. Claude Code loads it when a task matches its description.

How do I install Diagnosing SDK Health in Codex?

Run `npx skills add PostHog/posthog --skill diagnosing-sdk-health -a codex`. Or copy the skill folder (products/growth/skills/diagnosing-sdk-health in PostHog/posthog) into .agents/skills/diagnosing-sdk-health in your project. Codex loads it when a task matches its description.

Can I use Diagnosing SDK Health in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add PostHog/posthog --skill diagnosing-sdk-health -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/diagnosing-sdk-health, .gemini/skills/diagnosing-sdk-health, .github/skills/diagnosing-sdk-health and .opencode/skills/diagnosing-sdk-health in your project.

What does Diagnosing SDK Health need to run?

SKILL.md names no scripts, command-line tools or credentials: Diagnosing SDK Health is instructions for the agent only.

Does Diagnosing SDK Health access the network?

SKILL.md names 1 domain. As links in the text: posthog.com. This is read from the text; nothing was executed.

Is Diagnosing SDK Health safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Diagnosing SDK Health use?

Diagnosing SDK Health has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Diagnosing SDK Health use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Diagnosing SDK Health?

Skills that share tags, products or a category with Diagnosing SDK Health: Sub2API Admin (Wei-Shaw/sub2api, 44k stars), Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars), ToolJet Marketplace Plugin Builder (ToolJet/ToolJet, 41k stars) and Firecrawl Search Integration (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Diagnosing SDK Health?

PostHog (a GitHub organization, an official publisher) maintains it in PostHog/posthog, which has 40,209 GitHub stars. The repository holds 254 skills in this directory. The repository was last updated on October 10, 2026.

Source: PostHog/posthog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.