Official agent skill

Running CI Preflight

by PostHog in PostHog/posthog

Catch the deterministic CI failures reachable from your diff before pushing, with hogli ci:preflight.

OfficialCustom licenceAuto-check passedBackend & APIs

Install Running CI Preflight

skills CLI
$ npx skills add PostHog/posthog --skill running-ci-preflight -a claude-code

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

GitHub CLI
$ gh skill install PostHog/posthog running-ci-preflight --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/running-ci-preflight .claude/skills/running-ci-preflight && 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
running-ci-preflight
GitHub stars
40k
Token cost
~1.5k tokens
SKILL.md length
829 words
Files
1
Skills in repo
252
Repo updated
First seen
Licence
Custom licence

At a glance

Catch the deterministic CI failures reachable from your diff before pushing, with hogli ci:preflight.

  • Works in 5 steps: Run with --fix — it formats, lints, and… → Read each line: ✓ pass, ✗ fail, ⚠… → Resolve every ✗ fail — these are what… → …
  • The pre-push hook blocks a push
  • SKILL.md covers The loop (when the hook…, Notes and Why it matters
  • Calls git, pnpm and uv

What it does

Running CI Preflight is an agent skill from PostHog/posthog, published by the product's own GitHub organization. Catch the deterministic CI failures reachable from your diff before pushing, with hogli ci:preflight. Use when the pre-push hook blocks a push, before reporting a task done, or after editing Python, serializers, migrations, workflows, or dependency manifests — to avoid burning a CI matrix on a failure you could catch locally (formatting, lint, broken lockfiles, OpenAPI drift, migration conflict, stale branch). Trigger terms: ci:preflight, preflight, pre-push checks, pre-push hook failed, "will this break CI".

Its SKILL.md is about 1.5k 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 OpenAPI specifications, Dependency management and Failing and flaky tests. It works with OpenAPI and Python. 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

  • The pre-push hook blocks a push
  • Before reporting a task done
  • After editing Python
  • Dependency manifests — to avoid burning a CI matrix on a failure you could catch locally (formatting

Example prompts

  • “will this break CI”
  • “/running-ci-preflight”

Workflow steps

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

  1. Run with --fix — it formats, lints, and auto-fixes what is safe.
  2. Read each line: ✓ pass, ✗ fail, ⚠ warning (non-blocking finding), → advisory (do it yourself), · skipped (capability absent).
  3. Resolve every ✗ fail — these are what --fix could not (real lint error, broken lockfile, migration conflict). These block the push.
  4. Act on every → advisory — e.g. openapi advisory → run hogli build:openapi and commit the drift; staleness advisory → git merge…
  5. Re-run until clean, then push.

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • git
    • pnpm
    • uv

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

  • Network

    No URLs in SKILL.md. Its commands use git, pnpm and uv, which can reach the network depending on how they are called.

    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

Running CI Preflight loads about 1.5k tokens when it runs. Until then it costs about 134 tokens; SKILL.md has 829 words of instructions outside code blocks.

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

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 829 words (~1,515 tokens).

“hogli ci:preflight scopes a curated set of checks to the files your branch touched — each mapped to a CI failure class that has taken master down — plus an always-on branch-freshness check. It is the pre-push counterpart to hogli…”

— opening of SKILL.md by PostHog, Custom licence
name
running-ci-preflight

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/running-ci-preflight of PostHog/posthog.

Open the folder on GitHubat commit 812e5c6

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

Running CI Preflight 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.

Running CI Preflight compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Running CI Preflight this skillPostHog/posthog40k—~1.5kAutomated safety check: PassCustom licence
Assisted Service Dev Modeopenshift/assisted-service138—~1.3kAutomated safety check: PassApache-2.0
Land TS MonoUKGovernmentBEIS/inspect_ai3k—~3kAutomated safety check: PassMIT
Code Documenterzebbern/claude-code-guide4.7k—~1kAutomated safety check: PassMIT
Cloud Agents Starterscalar/scalar16k—~1.4kAutomated safety check: PassMIT
Databricks CLI SDK Bumpdatabricks/cli404—~2kAutomated safety check: NotesCustom licence

Similar skills

  • Assisted Service Dev Mode

    openshift/assisted-service

    Build and code-generate assisted-service using skipper with podman.

    138 GitHub stars~1.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Land TS Mono

    UKGovernmentBEIS/inspect_ai

    Land a PR that requires a coordinated ts-mono submodule change.

    3k GitHub stars~3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Code Documenter

    zebbern/claude-code-guide

    A skill your agent uses when adding docstrings, creating API documentation, or building documentation sites.

    4.7k GitHub stars~1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Minimal starter runbook for cloud agents to install dependencies, run packages, execute tests, and troubleshoot the Scalar monorepo quickly.

    16k GitHub stars~1.4k tokensUpdated today
    Testing & QAAuto-check passed
  • Official

    Bumps the databricks-sdk-go dependency in the Databricks CLI together with its pinned OpenAPI spec SHA, then regenerates the files that depend on them.

    404 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check: notes
  • Kingdee MCP Dev

    WaHaiLong/KingdeeMCP

    Knowledge base for the Kingdee MCP Dev Squad. An agent skill from WaHaiLong/KingdeeMCP.

    105 GitHub stars~853 tokensUpdated 1 mo ago
    Backend & APIsAuto-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

Works with

Questions about Running CI Preflight

What does Running CI Preflight do?

Catch the deterministic CI failures reachable from your diff before pushing, with hogli ci:preflight. Running CI Preflight is an agent skill from PostHog/posthog, published by the product's own GitHub organization. Catch the deterministic CI failures reachable from your diff before pushing, with hogli ci:preflight.

When should I use Running CI Preflight?

Running CI Preflight fits situations like: the pre-push hook blocks a push; before reporting a task done; after editing Python; dependency manifests — to avoid burning a CI matrix on a failure you could catch locally (formatting.

How do I install Running CI Preflight in Claude Code?

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

How do I install Running CI Preflight in Codex?

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

Can I use Running CI Preflight 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 running-ci-preflight -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/running-ci-preflight, .gemini/skills/running-ci-preflight, .github/skills/running-ci-preflight and .opencode/skills/running-ci-preflight in your project.

What does Running CI Preflight need to run?

Going by SKILL.md and its folder, Running CI Preflight needs the command-line tools its instructions call (git, pnpm and uv).

Does Running CI Preflight access the network?

SKILL.md contains no URLs. Its commands use git and uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Running CI Preflight 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 Running CI Preflight use?

Running CI Preflight 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 Running CI Preflight use?

About 1.5k tokens (SKILL.md is roughly 6.1k 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 Running CI Preflight?

Skills that share tags, products or a category with Running CI Preflight: Assisted Service Dev Mode (openshift/assisted-service, 138 stars), Land TS Mono (UKGovernmentBEIS/inspect_ai, 3k stars), Code Documenter (zebbern/claude-code-guide, 4.7k stars) and Cloud Agents Starter (scalar/scalar, 16k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Running CI Preflight?

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