Official agent skill

Warehouse Source New Version

by PostHog in PostHog/posthog

Add support for a new vendor API version to an existing Data warehouse import source, or deprecate an old one.

OfficialCustom licenceAuto-check passedDatabases

Install Warehouse Source New Version

skills CLI
$ npx skills add PostHog/posthog --skill warehouse-source-new-version -a claude-code

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

GitHub CLI
$ gh skill install PostHog/posthog warehouse-source-new-version --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/.agents/skills/warehouse-source-new-version .claude/skills/warehouse-source-new-version && 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
warehouse-source-new-version
GitHub stars
40k
Token cost
~8.6k tokens
SKILL.md length
5,004 words
Files
1
Skills in repo
252
Repo updated
First seen
Licence
Custom licence

At a glance

Add support for a new vendor API version to an existing Data warehouse import source, or deprecate an old one.

  • Works in 6 steps: Read the vendor's changelog (the… → Declare the version (only once the gate… → Dispatch on SourceInputs.api_version at… → …
  • A vendor ships a new API version (Stripe date versions
  • SKILL.md covers How versioning works, First: does the version need…, Adding a new version, step by… and Deprecating a version, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Warehouse Source New Version is an agent skill from PostHog/posthog, published by the product's own GitHub organization. Add support for a new vendor API version to an existing Data warehouse import source, or deprecate an old one. Use when a vendor ships a new API version (Stripe date versions, Shopify quarterly versions, header-pinned revisions, /vN/ URL bumps), when implementing a version-update or deprecation task for a source under products/warehousesources/backend/temporal/dataimports/sources, or when repinning an ExternalDataSource to a different version. Covers deciding whether a newly announced version needs supporting at…

Its SKILL.md is about 8.6k 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 Databases, covering Data warehousing and Database migrations. It works with PostHog, Shopify and Stripe. 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 vendor ships a new API version (Stripe date versions
  • Shopify quarterly versions
  • Header-pinned revisions
  • /vN/ URL bumps)

Example prompts

  • “/warehouse-source-new-version”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Read the vendor's changelog (the source's api_docs_url) and list what changed between the currently supported version(s) and the new one…
  2. Declare the version (only once the gate says the version has to exist): add the new label to supported_versions and flip default_version…
  3. Dispatch on SourceInputs.api_version at the request layer
  4. Keep old versions working: do not delete or alter the request path for previously supported versions. Removing a version is an explicit…
  5. Tests: extend the source's tests so both the old and new versions are exercised — at minimum that the version label reaches the…
  6. One PR per source. Conventional title: feat(warehouse_sources): support API version — the scope is always warehouse_sources (the product)…

What it can do on your machine

Read from SKILL.md and the folder at commit 10f9ad7. 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.

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

  • Network

    No URLs in SKILL.md.

    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

Warehouse Source New Version loads about 8.6k tokens when it runs. Until then it costs about 162 tokens; SKILL.md has 5,004 words of instructions outside code blocks.

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

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 5,004 words (~8,580 tokens).

“Use this skill when a vendor has released a new API version and an existing source under products/warehouse_sources/backend/temporal/data_imports/sources// must support it while keeping every previously supported version functional.”

— opening of SKILL.md by PostHog, Custom licence
name
warehouse-source-new-version

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/warehouse-source-new-version of PostHog/posthog.

Open the folder on GitHubat commit 10f9ad7

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 8, 2026.

Compare with similar skills

Warehouse Source New Version 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.

Warehouse Source New Version compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Warehouse Source New Version this skillPostHog/posthog40k—~8.6kAutomated safety check: PassCustom licence
Observal AdminObserval/Observal4.2k—~774Automated safety check: PassApache-2.0
Database MigrationRain-kl/OpenFlare288—~1.3kAutomated safety check: PassApache-2.0
dbt Snowflake to BigQuery Translatorgoogle/skills21k—~2.7kAutomated safety check: PassApache-2.0
Replica BackendJakeschincariol/replica-skill908—~997Automated safety check: NotesMIT
Migration Patternschmonitor/chmonitor299—~4.4kAutomated safety check: PassGPL-3.0

Similar skills

  • Observal Admin

    Observal/Observal

    Administers Observal users, settings, diagnostics, review queues, security events, audit logs, SAML, SCIM, the local Observal server, its upgrades and rollback, and its own PostgreSQL and ClickHouse…

    4.2k GitHub stars~774 tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Database Migration

    Rain-kl/OpenFlare

    Wavelet 项目专用:当新增或修改数据库表结构、索引、初始化数据、系统配置 seed、模板 seed、默认管理员、goose SQL 迁移、internal/infra/persistence/migrator、ClickHouse 分析库 DDL 或数据库升级流程时必须使用。本技能指导在 internal/infra/persistence/migrator/goose 下编写…

    288 GitHub stars~1.3k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Translates Snowflake dbt SQL models into standardized BigQuery SQL, keeping Jinja constructs and tracking progress in a migration tasks file.

    21k GitHub stars~2.7k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Replica Backend

    Jakeschincariol/replica-skill

    Builds the backend of an app clone: auth, database migrations and access rules, payments with Stripe, email, background jobs and third-party integrations through official APIs only, plus a security…

    908 GitHub stars~997 tokensUpdated 5 days ago
    Backend & APIsAuto-check: notes
  • Migration Patterns

    chmonitor/chmonitor

    Schema migrations: ALTER patterns, engine changes, zero-downtime swaps, clickhouse-local offline migrations, lightweight UPDATE/DELETE strategies, and Postgres→ClickHouse migration planning (type…

    299 GitHub stars~4.4k tokensUpdated 3 days ago
    DatabasesAuto-check passed
  • Clickhouse Migration Deep Dive

    jeremylongshore/tons-of-skills-marketplace

    Execute ClickHouse schema migrations — ALTER TABLE operations, data migration between engines, versioned migration runners, and zero-downtime schema changes.

    2.8k GitHub stars~1.4k tokensUpdated today
    DatabasesAuto-check passed

More from PostHog/posthog

All 252 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

Categories

Questions about Warehouse Source New Version

What does Warehouse Source New Version do?

Add support for a new vendor API version to an existing Data warehouse import source, or deprecate an old one. Warehouse Source New Version is an agent skill from PostHog/posthog, published by the product's own GitHub organization. Add support for a new vendor API version to an existing Data warehouse import source, or deprecate an old one.

When should I use Warehouse Source New Version?

Warehouse Source New Version fits situations like: A vendor ships a new API version (Stripe date versions; shopify quarterly versions; header-pinned revisions; /vN/ URL bumps).

How do I install Warehouse Source New Version in Claude Code?

Run `npx skills add PostHog/posthog --skill warehouse-source-new-version -a claude-code`. Or copy the skill folder (.agents/skills/warehouse-source-new-version in PostHog/posthog) into .claude/skills/warehouse-source-new-version in your project. Claude Code loads it when a task matches its description.

How do I install Warehouse Source New Version in Codex?

Run `npx skills add PostHog/posthog --skill warehouse-source-new-version -a codex`. Or copy the skill folder (.agents/skills/warehouse-source-new-version in PostHog/posthog) into .agents/skills/warehouse-source-new-version in your project. Codex loads it when a task matches its description.

Can I use Warehouse Source New Version 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 warehouse-source-new-version -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/warehouse-source-new-version, .gemini/skills/warehouse-source-new-version, .github/skills/warehouse-source-new-version and .opencode/skills/warehouse-source-new-version in your project.

What does Warehouse Source New Version need to run?

SKILL.md names no scripts, command-line tools or credentials: Warehouse Source New Version is instructions for the agent only.

Does Warehouse Source New Version access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Warehouse Source New Version 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 Warehouse Source New Version use?

Warehouse Source New Version 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 Warehouse Source New Version use?

About 8.6k tokens (SKILL.md is roughly 34k 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 Warehouse Source New Version?

Skills that share tags, products or a category with Warehouse Source New Version: Observal Admin (Observal/Observal, 4.2k stars), Database Migration (Rain-kl/OpenFlare, 288 stars), dbt Snowflake to BigQuery Translator (google/skills, 21k stars) and Replica Backend (Jakeschincariol/replica-skill, 908 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Warehouse Source New Version?

PostHog (a GitHub organization, an official publisher) maintains it in PostHog/posthog, which has 40,182 GitHub stars. The repository holds 252 skills in this directory. The repository was last updated on October 8, 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.