test-the-docs
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
About
- Publisher
- Supabase
- Tool
- Supabase
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- reference/sandbox-setup.md
- reference/snippet-classes.md
- reference/verification-report.md
- sandbox/.empty/.keep
- sandbox/.gitignore
- sandbox/Dockerfile
- sandbox/compose.yaml
- sandbox/run.sh
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
This skill includes scripts that your agent may run.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tools | Supabase, Testing, Documentation | |
| Publisher | Supabase | source |
| Official status | Officialin Supabase's own monorepo under the supabase organisation | source |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | Apache-2.0 | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 11, 2026114,826 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
More from Supabase
1 server · 23 skills
- Supabase (MCP server)
- supabase-postgres-best-practices (Skill)
- supabase (Skill)
- supabase-server (Skill)
- clickhouse-logs-queries (Skill)
- edit-the-docs (Skill)
Also listed under: Testing, Documentation
Sources
- Skill file (SKILL.md)github.com/supabase/supabase · Backs: Official status, Includes scriptsNov 10, 2026
- GitHub repositorygithub.com/supabase/supabase · Backs: Licence, Publisher, ActivityNov 11, 2026
- Folder in the repository (test-the-docs)github.com/supabase/supabase · Backs: Includes scriptsNov 10, 2026