Skip to content

chore: fallback language skills v2#123

Open
sarahxsanders wants to merge 2 commits into
mainfrom
basic-skills-v2
Open

chore: fallback language skills v2#123
sarahxsanders wants to merge 2 commits into
mainfrom
basic-skills-v2

Conversation

@sarahxsanders
Copy link
Copy Markdown
Collaborator

@sarahxsanders sarahxsanders commented May 1, 2026

loosening the reigns on the fallback language skillz. they're too constrained today, making them fail in some cases, or just implement posthog "meh"ly in others

sister PR: PostHog/wizard#431

changes

  • adds fallback-description.md - a separate skill template for non-framework languages
  • updates config.yaml to point the four fallback skills at the new template
  • added error tracking and other docs_urls to fallback skills since they don't have example apps to teach patterns
  • Disconnected example apps from fallback skills. the agent actually produces better results working from docs alone 😱

why a new template?

framework skills have a specific example project to copy from. fallback skills don't have that luxury, the agent needs more freedom to explore the project and figure out where PostHog fits.

putting both sets of guidance in one file would mean every tweak to help vanilla JS projects risks changing behavior for Next.js or Django runs that already work well

this creates a clean blast radius so changes to either never impact the other

why disconnect example apps

I tested thoroughly with and without them. without them, the agent leaned on the SDK docs and produced more complete integrations across ALL four languages. the examples in this case were actually constraining the agent more than helping it

imo this is the right thing to do, as fallback language skills often get used in "odd" ways sometimes and we should let the agent do the thinking

testing

I've A/B tested this, see the wizard PR test results

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 1, 2026

🧙 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 misc
  • /wizard-ci revenue

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 misc/quack-quack
  • /wizard-ci revenue/stripe

Results will be posted here when complete.

@sarahxsanders sarahxsanders marked this pull request as ready for review May 1, 2026 20:29
@sarahxsanders
Copy link
Copy Markdown
Collaborator Author

/wizard-ci all

@wizard-ci-bot
Copy link
Copy Markdown

wizard-ci-bot Bot commented May 1, 2026

🧙 Wizard CI Results

Trigger ID: cef44b4
Workflow: View run

App Confidence PR YARA
basic-integration/android/Jetchat 4/5 #1389 (logs)
basic-integration/angular/angular-saas 5/5 #1387 (logs)
basic-integration/astro/astro-hybrid-marketing 4/5 #1381 (logs)
basic-integration/astro/astro-ssr-docs 4/5 #1386 (logs)
basic-integration/astro/astro-static-marketing 4/5 #1384 (logs)
basic-integration/astro/astro-view-transitions-marketing 4/5 #1382 (logs)
basic-integration/django/django3-saas 4/5 #1383 (logs)
basic-integration/fastapi/fastapi3-ai-saas 5/5 #1388 (logs)
basic-integration/flask/flask3-social-media 4/5 #1385 (logs)
basic-integration/javascript-node/express-todo 4/5 #1380 (logs)
basic-integration/javascript-node/fastify-blog 4/5 #1390 (logs)
basic-integration/javascript-node/hono-links 4/5 #1392 (logs)
basic-integration/javascript-node/koa-notes 4/5 #1391 (logs)
basic-integration/javascript-node/native-http-contacts 4/5 #1393 (logs)
basic-integration/javascript-web/saas-dashboard 4/5 #1396 (logs)
basic-integration/laravel/laravel12-saas 4/5 #1395 (logs)
basic-integration/next-js/15-app-router-saas 4/5 #1398 (logs)
basic-integration/next-js/15-app-router-todo 4/5 #1394 (logs)
basic-integration/next-js/15-pages-router-saas 4/5 #1399 (logs)
basic-integration/next-js/15-pages-router-todo 5/5 #1397 (logs)
basic-integration/nuxt/movies-nuxt-3-6 2/5 #1402 (logs)
basic-integration/nuxt/movies-nuxt-4 4/5 #1401 (logs)
basic-integration/python/meeting-summarizer 4/5 #1400 (logs)
basic-integration/rails/fizzy 4/5 #1408 (logs)
basic-integration/react-native/expo-react-native-hacker-news 4/5 #1406 (logs)
basic-integration/react-native/react-native-saas 4/5 #1403 (logs)
basic-integration/react-router/react-router-v7-project 4/5 #1405 (logs)
basic-integration/react-router/rrv7-starter 4/5 #1404 (logs)
basic-integration/react-router/saas-template 4/5 #1409 (logs)
basic-integration/react-router/shopper 4/5 #1407 (logs)
basic-integration/sveltekit/CMSaasStarter 4/5 #1410 (logs)
basic-integration/swift/hackers-ios 3/5 #1415 (logs)
basic-integration/tanstack-router/tanstack-router-code-based-saas 5/5 #1412 (logs)
basic-integration/tanstack-router/tanstack-router-file-based-saas 4/5 #1413 (logs)
basic-integration/tanstack-start/tanstack-start-saas 4/5 #1416 (logs)
basic-integration/vue/movies 4/5 #1414 (logs)
revenue/stripe/stripe-next-js-saas-starter 3/5 #1411 (logs)
revenue/stripe/stripe-saas-demo 3/5 #1417 (logs)

Configuration

Setting Value
Wizard ref main
Context Mill ref basic-skills-v2
PostHog ref master

Search for trigger ID cef44b4 in wizard-workbench PRs.

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.

1 participant