Skip to content

fix(skills): list creating-product-tours in wizard skill list - #286

Draft
posthog[bot] wants to merge 1 commit into
mainfrom
posthog-code/list-creating-product-tours-skill
Draft

fix(skills): list creating-product-tours in wizard skill list#286
posthog[bot] wants to merge 1 commit into
mainfrom
posthog-code/list-creating-product-tours-skill

Conversation

@posthog

@posthog posthog Bot commented Jul 28, 2026

Copy link
Copy Markdown

Problem

creating-product-tours never shows up in wizard skill list. Its config.yaml
has no cli: block, and generateCliEntries() in scripts/lib/build-phases.js
filters on allSkills.filter(s => s.cli) — so it never reaches cliEntries in
skill-menu.json, which is the only thing wizard skill list prints. The skill
runs fine if you already know the id; it just can't be found.

Why

Product tours is sunsetting, and npx @posthog/wizard@latest skill creating-product-tours
is now the recommended path for people who want to build tours themselves. Support
has been handing out the exact id because the listing doesn't have it — two tickets
in the last eight days, one from a customer migrating off a paid guides vendor.
Wizard telemetry shows no traffic reaching the skill at all.

Changes

  • context/skills/creating-product-tours/config.yaml: declare cli: role: skill.
    It picks up an entry at build time and skill list shows it on the next release,
    with no wizard change needed.
  • Fix the contributor docs that made the omission look correct. CONTRIBUTING.md
    claimed skills with no cli: block "default to the skill role" and were
    "discoverable via wizard skill list" — they aren't; they get no entry at all.
    Same wording corrected in AGENTS.md and the two doc comments that repeated it.
  • Add a regression test asserting the real config produces a browsable entry.

What I checked while in here

Every other skill missing a cli: block is deliberately unlisted: sub-skills a
flow pulls in (posthog-best-practices, the integration-v2 steps), skills
fronted by a wizard-native command (data-warehouse-source, web-analytics,
self-driving), or internal test fixtures (quack). creating-product-tours
was the only standalone, user-facing one silently absent, so this is a one-line
fix rather than a sweep.

Not covered here: the support macro still uses the deprecated --skill <name>
flag instead of the wizard skill <name> positional — that lives outside this
repo and needs a separate update.

Verification

pnpm test (138 passing) and a full pnpm build, confirming the entry lands in
dist/skills/skill-menu.json:

{ "skillId": "creating-product-tours", "role": "skill", "displayName": "Creating product tours" }

Rendered as wizard skill list would print it:

  creating-product-tours                  wizard skill creating-product-tours   Build an in-app product tour that guides users through a feature...

Created with PostHog Desktop from this inbox report.

The skill had no `cli:` block, and `generateCliEntries()` only emits skills
that declare one. `wizard skill list` prints nothing but `cliEntries`, so the
skill has been invisible since it landed — runnable only by typing its exact
id, which is how support has had to hand it out.

Declare `cli: role: skill` so it lands in `cliEntries` on the next release.
No wizard change needed.

The contributor docs said a missing block "defaults to the `skill` role" and
was still discoverable, which is what made the omission look correct. Corrected
in CONTRIBUTING.md, AGENTS.md, and the two doc comments that repeated it.

Generated-By: PostHog Code
Task-Id: 58dc91a3-6df0-41a5-b8be-b6f9711a980e
@github-actions

Copy link
Copy Markdown

🧙 Wizard CI

Run the Wizard CI and test your changes against wizard-workbench example apps by replying with a GitHub comment using one of the following commands:

Test all apps:

  • /wizard-ci all

Test all apps in a directory:

  • /wizard-ci basic-integration
  • /wizard-ci mcp-analytics
  • /wizard-ci revenue
  • /wizard-ci self-driving

Test an individual app:

  • /wizard-ci basic-integration/android
  • /wizard-ci basic-integration/angular
  • /wizard-ci basic-integration/astro
Show more apps
  • /wizard-ci basic-integration/django
  • /wizard-ci basic-integration/fastapi
  • /wizard-ci basic-integration/flask
  • /wizard-ci basic-integration/javascript-node
  • /wizard-ci basic-integration/javascript-web
  • /wizard-ci basic-integration/laravel
  • /wizard-ci basic-integration/next-js
  • /wizard-ci basic-integration/nuxt
  • /wizard-ci basic-integration/python
  • /wizard-ci basic-integration/rails
  • /wizard-ci basic-integration/react-native
  • /wizard-ci basic-integration/react-router
  • /wizard-ci basic-integration/sveltekit
  • /wizard-ci basic-integration/swift
  • /wizard-ci basic-integration/tanstack-router
  • /wizard-ci basic-integration/tanstack-start
  • /wizard-ci basic-integration/vue
  • /wizard-ci mcp-analytics/custom-dispatcher
  • /wizard-ci mcp-analytics/typescript-sdk
  • /wizard-ci revenue/stripe
  • /wizard-ci self-driving/astro
  • /wizard-ci self-driving/fastapi
  • /wizard-ci self-driving/nuxt
  • /wizard-ci self-driving/react-router
  • /wizard-ci self-driving/sveltekit

Results will be posted here when complete.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants