Skip to content
Kitbay

test-the-docs

Apache-2.0Updated on Nov 11, 2026114,826GitHub starsIncludes scripts

A skill in the Supabase monorepo for checking that the code in changed Supabase docs pages actually runs.

What the skill teaches

A skill in the Supabase monorepo for checking that the code in changed Supabase docs pages actually runs. The agent finds the changed MDX files, pulls out shell, SQL, JavaScript and TypeScript blocks and linked example apps, sorts them into runnable, needs-setup, example app, illustrative or deferred, and runs one end-to-end path plus spot checks of new blocks inside a throwaway Docker Compose sandbox with a local Supabase stack started by the Supabase CLI. It never runs anything on the host or against production, applies time limits, redacts secrets, tears the sandbox down and writes a verification report for the pull request. Product bugs it finds are filed separately.

Capabilities

  • Extract runnable code blocks from changed docs pages
  • Run docs snippets in a Docker sandbox with a local Supabase stack
  • Build linked example apps with time limits
  • Write a verification report for a docs pull request