Official agent skill

Exploring The Wizard

by PostHog in PostHog/wizard

Drive the PostHog wizard headlessly against a throwaway app through wizard-ci MCP tools, inspect decisions, and capture the real TUI.

OfficialMITAuto-check passedTesting & QA

Install Exploring The Wizard

skills CLI
$ npx skills add PostHog/wizard --skill exploring-the-wizard -a claude-code

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

GitHub CLI
$ gh skill install PostHog/wizard exploring-the-wizard --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/wizard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/exploring-the-wizard .claude/skills/exploring-the-wizard && 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
exploring-the-wizard
GitHub stars
197
Token cost
~2.2k tokens
SKILL.md length
868 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Drive the PostHog wizard headlessly against a throwaway app through wizard-ci MCP tools, inspect decisions, and capture the real TUI.

  • Works in 6 steps: Open the app, then poll read_state until… → Capture render_screen before each… → Commit only actions currently offered.… → …
  • Detection checks and end-to-end exploration
  • SKILL.md covers Prepare the run, Tool contract, Drive and record and Sweep the workbench
  • Calls rsync

What it does

Exploring The Wizard is an agent skill from PostHog/wizard, published by the product's own GitHub organization. Drive the PostHog wizard headlessly against a throwaway app through wizard-ci MCP tools, inspect decisions, and capture the real TUI. Use for detection checks and end-to-end exploration.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for coding agents working on the PostHog wizard codebase with the wizard-ci MCP server.

It sits in Testing & QA, covering MCP servers and End-to-end testing. It works with PostHog and Model Context Protocol. The repository describes itself as: Quickly add PostHog to your project using the setup wizard ✨. The licence is MIT.

When your agent uses it

  • Detection checks and end-to-end exploration
  • Tasks that involve MCP servers
  • Tasks that involve End-to-end testing

Example prompts

  • “/exploring-the-wizard”

Requirements

  • Compatibility (from SKILL.md): Designed for coding agents working on the PostHog wizard codebase with the wizard-ci MCP server.

Workflow steps

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

  1. Open the app, then poll read_state until session.detectionComplete before
  2. Capture render_screen before each decision and during task or phase
  3. Commit only actions currently offered. Common choices are below; the
  4. For a full run, confirm setup and call run_agent at auth. Continue
  5. Check runPhase (idle, running, completed, error), background
  6. After successful agent completion, finish the offered outro and follow-up

What it can do on your machine

Read from SKILL.md and the folder at commit 77055d2. 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:

    • rsync

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

  • Network

    No URLs in SKILL.md. Its commands use rsync, 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.

  • Compatibility

    Designed for coding agents working on the PostHog wizard codebase with the wizard-ci MCP server.

    From compatibility in the SKILL.md frontmatter.

Context cost

Exploring The Wizard loads about 2.2k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 868 words of instructions outside code blocks.

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

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

The full file from PostHog/wizard at commit 77055d2, republished under its MIT licence (© PostHog). 868 words, ~2,182 tokens.

Download SKILL.mdSave it as .claude/skills/exploring-the-wizard/SKILL.md (or your agent's skills folder).
name
exploring-the-wizard
description
Drive the PostHog wizard headlessly against a throwaway app through wizard-ci MCP tools, inspect decisions, and capture the real TUI. Use for detection checks and end-to-end exploration.
compatibility
Designed for coding agents working on the PostHog wizard codebase with the wizard-ci MCP server.
metadata.author
posthog
metadata.version
5.0.1

Exploring the wizard as an agent

Drive the real TUI from this checkout using the wizard-ci MCP server in .mcp.json. If its tools are unavailable, check registration and startup errors; request approval only if the client reports that approval is missing.

Follow the runner policy for harness, sequence, and gateway policy. For new exploration, launch the server with SNAP_HARNESS=pi; prefer SNAP_SEQUENCE=orchestrator for the integration flow. These are server environment variables, not MCP arguments. Restart an existing server to change its environment. See the host architecture for other programs, overrides, and current limitations.

Prepare the run

Copy the target app to a throwaway directory under /tmp: a full run edits files and can create real PostHog resources. open_app replaces the active wizard, so finish recording one app before opening another.

  • Detection only: pass appDir and projectId (both required strings), with no key. Stop at auth without calling run_agent.
  • Full integration: reuse the authorized phx key file path, separate gateway token file path, and project id; ask only for missing inputs. Prefer keyFile so the key stays out of tool arguments. Set WIZARD_CI_GATEWAY_TOKEN_FILE in the MCP server environment before launch (restart an existing server); it is not an open_app argument. The file must contain an already-issued gateway bearer, not the phx key. CI does not mint or refresh it. Never print or commit either secret. See local credential setup. Read the credential and region limitations before starting: an inherited key can shadow keyFile, and the host currently hardcodes the US region.
  • Questions during the run: launch the server with E2E_ASK=true to keep wizard_ask available in this CI session. Handle questions yourself through the actions below; fixed-route answer profiles do not drive the MCP route.

Tool contract

The schema lives in scripts/wizard-ci-mcp.no-jest.ts. It exposes exactly these tools:

ToolArgumentsResult
open_appappDir, projectId; optional keyFile, apiKey, region (us or eu)First state, possibly before detection finishes
read_stateNoneCurrent state, legal actions, and background run status
perform_actionaction; optional params objectState after committing a legal action
render_screenNoneCurrent rendered screen as plain text, with ANSI removed
run_agentNoneStarts the real program in the background and returns immediately

Use read_state.actions for action ids and parameters; there is no list_actions MCP tool. Framework identity is session.integration, with session.detectedFrameworkLabel and session.detectionComplete. The separate top-level integration field is the background status: idle, running, done, or failed; integrationError holds a caught failure. Those two fields are added by read_state and are absent from perform_action replies.

Show full SKILL.md (458 more words)Show less

Drive and record

This walk targets the default integration program; other programs expose their own decisions through the same state and action contract.

  1. Open the app, then poll read_state until session.detectionComplete before judging detection. Inspect session.integration and setupQuestions.
  2. Capture render_screen before each decision and during task or phase changes. Save numbered frames such as /tmp/wz-explore-snaps/01-intro.txt.
  3. Commit only actions currently offered. Common choices are below; the action registry defines the full set.
  4. For a full run, confirm setup and call run_agent at auth. Continue reading state and handling overlays while it runs; polling alone cannot answer them.
  5. Check runPhase (idle, running, completed, error), background status, and the rendered outro. On error, capture the frame and reason before dismissing it. integration says failed once the run's phase is error; a host exit can instead surface as a socket error.
  6. After successful agent completion, finish the offered outro and follow-up actions. For the integration flow, session.skillsComplete marks the tail's completion. Other programs can have a terminal outro or exit screen.
DecisionAction and params
Confirm intro / dismiss blocking outageconfirm_setup / dismiss_outage
Answer setup questionchoose, { key, value } from setupQuestions
Answer every question in a pending batchanswer_question, { answers: { questionId: value } }; values are strings or string arrays
Cancel a question batchcancel_question
Accept or decline an optional taskresolve_notice, { keep: true } or { keep: false }
Finish outrodismiss_outro
Record MCP outcomeset_mcp_outcome, { outcome: "skipped" } or { outcome: "installed", clients: [...] }
Dismiss suggested prompts / Slack stepdismiss / dismiss_slack
Record keep-skills choicekeep_skills, { kept: true } or { kept: false }

MCP and keep-skills actions commit store state; recording an outcome does not perform the corresponding installation or cleanup. Report which outcomes were simulated. A completed run also needs a review of the app diff and expected integration behavior before calling the integration valid.

MCP snapshots are plain .txt; the CI snapshot route writes colored .ans frames. Keep the screen path and failure evidence with the snapshots. Do not stop a progressing run at an invented turn count: the MCP exposes no turn limit; Pi's continuation and tool-call guards are described in its harness README.

Sweep the workbench

Fixtures live in the sibling repo at wizard-workbench/apps/basic-integration/<framework>/<app>. Copy each app with rsync -a, excluding .git, node_modules, and ecosystem build/dependency directories such as vendor, venv, Pods, build, and dist. Verify a failed copy before treating null detection as a regression; remove throwaway copies after recording their results.

The shared log is /tmp/posthog-wizard.log unless the server's environment sets POSTHOG_WIZARD_LOG_FILE. Record its byte count before a run and read from that count plus one afterward. Run sweeps serially so their logs remain attributable. read_state omits frameworkContext; an empty setupQuestions list alone does not prove a router mode. When necessary, inspect the detector under src/programs/frameworks/ against the same fixture.

© PostHog, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/exploring-the-wizard of PostHog/wizard.

Open the folder on GitHubat commit 77055d2

Compare with similar skills

Exploring The Wizard 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.

Exploring The Wizard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Exploring The Wizard this skillPostHog/wizard197—~2.2kAutomated safety check: PassMIT
Qwen Code E2E TestingQwenLM/qwen-code28k—~2.1kAutomated safety check: PassApache-2.0
Edt MCP TestingDitriXNew/EDT-MCP295—~2.1kAutomated safety check: PassAGPL-3.0
Edt MCP Ready To DeployDitriXNew/EDT-MCP295—~1.6kAutomated safety check: PassAGPL-3.0
Glance TestDebugBase/glance156—~827Automated safety check: PassMIT
Edt MCP Build TestDitriXNew/EDT-MCP295—~1.4kAutomated safety check: PassAGPL-3.0

Similar skills

  • Qwen Code E2E Testing

    QwenLM/qwen-code

    Guides end-to-end testing of the Qwen Code CLI in headless mode with real model calls, MCP test servers and inspection of raw API traffic.

    28k GitHub stars~2.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Edt MCP Testing

    DitriXNew/EDT-MCP

    How to manually e2e-test each EDT-MCP server tool against a live EDT workbench + TestConfiguration.

    295 GitHub stars~2.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Edt MCP Ready To Deploy

    DitriXNew/EDT-MCP

    The final "definition of done" / ready-to-deploy checklist for EDT-MCP — the ordered gate to run when a piece of work is finished, before declaring it done or merging.

    295 GitHub stars~1.6k tokensUpdated today
    Testing & QAAuto-check passed
  • Glance Test

    DebugBase/glance

    Run E2E browser tests on any web application using Glance MCP.

    156 GitHub stars~827 tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • Edt MCP Build Test

    DitriXNew/EDT-MCP

    How to build the EDT-MCP Eclipse plugin (Tycho/Maven) and run its unit and e2e tests, plus the test conventions for this repo.

    295 GitHub stars~1.4k tokensUpdated today
    Testing & QAAuto-check passed
  • Tauri Dev MCP Bridge

    jerrywu001/cc-sessions-viewer

    Launches a Tauri app's dev build with the MCP bridge compiled in, so an agent can take screenshots, read the live DOM, click real buttons and call real backend commands.

    394 GitHub stars~1.4k tokensUpdated yesterday
    Testing & QAAuto-check: warnings

More from PostHog/wizard

  • Ink Tui

    PostHog/wizard

    Official

    Build or modify the PostHog wizard's Ink screens, primitives, keyboard interactions, and session-driven screen flow.

    197 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Official

    Add or extend language and framework support in the PostHog wizard, including detection, framework configuration, registration, and matching context-mill content.

    197 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Wizard Development

    PostHog/wizard

    Official

    Architectural guidance for changes to the PostHog Wizard: program and framework boundaries, agent routing, gateway admission, security, and TUI state.

    197 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Adding Skill Program

    PostHog/wizard

    Official

    Add a PostHog wizard capability backed by context-mill content.

    197 GitHub stars~2.6k tokensUpdated today
    Auto-check passed

Questions about Exploring The Wizard

What does Exploring The Wizard do?

Drive the PostHog wizard headlessly against a throwaway app through wizard-ci MCP tools, inspect decisions, and capture the real TUI. Exploring The Wizard is an agent skill from PostHog/wizard, published by the product's own GitHub organization. Drive the PostHog wizard headlessly against a throwaway app through wizard-ci MCP tools, inspect decisions, and capture the real TUI.

When should I use Exploring The Wizard?

Exploring The Wizard fits situations like: detection checks and end-to-end exploration; tasks that involve MCP servers; tasks that involve End-to-end testing.

How do I install Exploring The Wizard in Claude Code?

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

How do I install Exploring The Wizard in Codex?

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

Can I use Exploring The Wizard 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/wizard --skill exploring-the-wizard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/exploring-the-wizard, .gemini/skills/exploring-the-wizard, .github/skills/exploring-the-wizard and .opencode/skills/exploring-the-wizard in your project.

What does Exploring The Wizard need to run?

Going by SKILL.md and its folder, Exploring The Wizard needs the command-line tools its instructions call (rsync). Compatibility (from SKILL.md): Designed for coding agents working on the PostHog wizard codebase with the wizard-ci MCP server..

Does Exploring The Wizard 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 Exploring The Wizard 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 Exploring The Wizard use?

Exploring The Wizard is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Exploring The Wizard use?

About 2.2k tokens (SKILL.md is roughly 8.7k 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 Exploring The Wizard?

Skills that share tags, products or a category with Exploring The Wizard: Qwen Code E2E Testing (QwenLM/qwen-code, 28k stars), Edt MCP Testing (DitriXNew/EDT-MCP, 295 stars), Edt MCP Ready To Deploy (DitriXNew/EDT-MCP, 295 stars) and Glance Test (DebugBase/glance, 156 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Exploring The Wizard?

PostHog (a GitHub organization, an official publisher) maintains it in PostHog/wizard, which has 197 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

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