Official agent skill

Ink Tui

by PostHog in PostHog/wizard

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

OfficialMITAuto-check passed

Install Ink Tui

skills CLI
$ npx skills add PostHog/wizard --skill ink-tui -a claude-code

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

GitHub CLI
$ gh skill install PostHog/wizard ink-tui --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/ink-tui .claude/skills/ink-tui && 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
ink-tui
GitHub stars
197
Token cost
~1.2k tokens
SKILL.md length
507 words
Files
5 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: Create the component in… → Add its id to that folder's screen-ids.ts. → Map the id to the component in the… → …
  • TUI work in this repository
  • SKILL.md covers Start with the existing surface, Add a screen, Preserve the UI boundary and Reuse and check
  • Calls pnpm

What it does

Ink Tui is an agent skill from PostHog/wizard, published by the product's own GitHub organization. Build or modify the PostHog wizard's Ink screens, primitives, keyboard interactions, and session-driven screen flow. Use for TUI work in this repository.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/ARCHITECTURE.md`, `references/PATTERNS.md` and `references/PRIMITIVES.md`).

It works with PostHog. The repository describes itself as: Quickly add PostHog to your project using the setup wizard ✨. The licence is MIT.

When your agent uses it

  • TUI work in this repository

Example prompts

  • “/ink-tui”

Workflow steps

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

  1. Create the component in src/tui/programs//screens/.
  2. Add its id to that folder's screen-ids.ts.
  3. Map the id to the component in the screens of the folder's entry
  4. Reference it through screenId in the program's flow (flow.ts, or the

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:

    • pnpm

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

  • Network

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

Ink Tui loads about 1.2k tokens when it runs, and up to ~6.3k if it reads all its reference files. Until then it costs about 40 tokens; SKILL.md has 507 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.3k

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). 507 words, ~1,163 tokens.

Download SKILL.mdSave it as .claude/skills/ink-tui/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
ink-tui
description
Build or modify the PostHog wizard's Ink screens, primitives, keyboard interactions, and session-driven screen flow. Use for TUI work in this repository.
license
MIT
metadata.author
posthog
metadata.version
3.1

Ink TUI

The wizard renders its terminal interface with Ink and React. Pi is an agent harness; it does not replace this renderer. Read wizard-development for architecture and harness/sequence policy before structural changes.

Start with the existing surface

package.json owns supported versions: currently Node ≥22.22.0, Ink ^6.8.0, React ^19.2.4, and @inkjs/ui ^2.0.0. Use installed package types for API details; keep this skill focused on the wizard's conventions rather than copying upstream component manuals.

Add a screen

A screen one program owns:

  1. Create the component in src/tui/programs/<id>/screens/.
  2. Add its id to that folder's screen-ids.ts.
  3. Map the id to the component in the screens of the folder's entry (index.ts(x)), and add its commits to the harness action registry, or list it in NO_ACTION_SCREENS if it has none. The registry's exhaustiveness test in e2e-harness/__tests__/wizard-ci-driver.test.ts fails a screen in neither.
  4. Reference it through screenId in the program's flow (flow.ts, or the AGENT_SKILL_STEPS a skill program adapts), with the appropriate visibility, completion, and gate predicates.

A tool's screens follow the same steps in src/tui/tools/<id>/, whose entry exports TUI_TOOLS; see src/tools.

A screen several programs or the core use lives in screens, with its id in screen-ids.ts and its mount in screen-registry.tsx. Screen sequences derive from each program's flow. Do not hand-maintain a second sequence array or add program navigation to the router. Additional state or service wiring depends on the screen's needs; App remains the shared shell.

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

Preserve the UI boundary

Programs never use the UI. They get a runner context from runner-context.ts. TUI code, the login included, takes the WizardStore it reports through as an argument: pushStatus for a line, showOutroError for an error outro, and abortOnScreens for a decided failure. There is no UI interface shared with headless or the CLI. Screens use store setters for reactive changes. The router resolves program screens from step predicates over the session and the TUI state; overlays interrupt that resolution. Local state is appropriate for presentation details such as tab selection, not wizard progression.

For new state, first decide whether it belongs in the shared WizardSession, which extends the ProgramSession programs read, in the TUI's own TuiState when only screens read it, or in display-only store state. Use an explicit setter that notifies subscribers. When TUI code needs a new operation to report through, add it to the store; a run's progress reaches the store through agent-progress.ts. Reuse existing enums and union types rather than introducing competing status vocabularies.

Reuse and check

Compose existing primitives and use styles.ts for shared colors, icons, and alignment. Export new public primitives from primitives/index.ts, add a realistic playground demo, and register it in PlaygroundApp.tsx.

Run pnpm try --playground to inspect primitives. Use exploring-the-wizard when exercising actual screen flows. Follow the repository's validation guidance; choose focused behavior checks for changed predicates or input handling, and visual inspection for layout changes.

© 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

SKILL.md and 4 other files (references) in .claude/skills/ink-tui of PostHog/wizard.

  • SKILL.md
  • references/ARCHITECTURE.md
  • references/PATTERNS.md
  • references/PRIMITIVES.md
  • references/TERMINAL-COMPAT.md

Open the folder on GitHubat commit 77055d2

Compare with similar skills

Ink Tui 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.

Ink Tui compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ink Tui this skillPostHog/wizard197—~1.2kAutomated safety check: PassMIT
Opik Analytics Instrumentationcomet-ml/opik22k—~4.4kAutomated safety check: PassApache-2.0
C15tc15t/c15t1.9k1 repos~1.6kAutomated safety check: PassApache-2.0
Define Feature Flagmacro-inc/macro4.6k—~780Automated safety check: PassAGPL-3.0
Soku CLIAbout-Intelligence/soku-cli304—~2.4kAutomated safety check: PassMIT
Compare Array Bundle SizePostHog/posthog-js613—~599Automated safety check: PassCustom licence

Similar skills

  • Shows how to add product analytics events to Opik's frontend, Java backend and Python SDK, all reporting through Segment to PostHog with an opik_ name prefix.

    22k GitHub stars~4.4k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • C15t

    c15t/c15t

    Work with c15t consent management docs, APIs, and integrations for Next.js, React, and JavaScript.

    1.9k GitHub starsUsed in 1 repo~1.6k tokens
    Legal & ComplianceAuto-check passed
  • Define Feature Flag

    macro-inc/macro

    Define a frontend feature flag with defineFlag and wire its readers.

    4.6k GitHub stars~780 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Soku CLI

    About-Intelligence/soku-cli

    Guides an agent through the soku command line tool for ads, GA4 and PostHog data reads, ads writes, SEO hosting, automations, files and skill management.

    304 GitHub stars~2.4k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Compare Array Bundle Size

    PostHog/posthog-js

    Official

    Quickly compare the posthog-js array.js bundle size in the current working tree against a git baseline using the repository's esbuild proxy.

    613 GitHub stars~599 tokensUpdated today
    Frontend & DesignAuto-check passed
  • 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

More from PostHog/wizard

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

    PostHog/wizard

    Official

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

    197 GitHub stars~2.2k 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

Works with

Questions about Ink Tui

What does Ink Tui do?

Build or modify the PostHog wizard's Ink screens, primitives, keyboard interactions, and session-driven screen flow. Ink Tui is an agent skill from PostHog/wizard, published by the product's own GitHub organization. Build or modify the PostHog wizard's Ink screens, primitives, keyboard interactions, and session-driven screen flow.

When should I use Ink Tui?

Ink Tui fits situations like: TUI work in this repository.

How do I install Ink Tui in Claude Code?

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

How do I install Ink Tui in Codex?

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

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

What does Ink Tui need to run?

Going by SKILL.md and its folder, Ink Tui needs the command-line tools its instructions call (pnpm).

Does Ink Tui 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 Ink Tui 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 Ink Tui use?

Ink Tui is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ink Tui use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.2k tokens, read only when the agent opens those files.

What are the alternatives to Ink Tui?

Skills that share tags, products or a category with Ink Tui: Opik Analytics Instrumentation (comet-ml/opik, 22k stars), C15t (c15t/c15t, 1.9k stars), Define Feature Flag (macro-inc/macro, 4.6k stars) and Soku CLI (About-Intelligence/soku-cli, 304 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ink Tui?

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.