Agent skill · supabase
review-the-docs
Review Supabase docs changes locally in your `supabase/supabase` checkout — either an open PR (triage, classify, verify) or your own branch before opening a PR (local self-review). Covers markdown pipeline, MDX content, tutorials, examples, Studio links, and docs tooling. Use when asked to review docs PRs, self-review a draft branch, check who has approved, verify build output, or evaluate supabase/supabase documentation changes.
What it needs
About 8k tokens when loaded.
What this skill does
Review docs PRs Local review workflow for supabase/supabase docs changes. Classify first, then follow the matching checklist. Two modes: Open PR review (default) — triage via gh, checkout, verify, report. Start at Phase 1. Local self-review — no open PR yet; verify the current branch before opening one. Start at Local self-review. For implementing docs fixes (Linear tickets, worktrees, platform E2E), use work-linear-issue instead. Core rules 1. Classify before reviewing — path patterns determine which checklist applies. 2. Review stacked PRs bottom-up — each PR may base on the previous branch. 3. Run verification locally — do not approve from diff alone. 4. Compare against master when the PR claims to fix missing or broken output. 5. One report per batch — sequential review, consolidated output at the end. 6. Separate blockers from nits — type/style notes are suggestions unless output breaks. Repository layout Path Purpose --------------------------------------- ---------------------------------------------------------------- your local supabase/supabase checkout Main clone for review checkouts apps/docs/content/guides/ Source MDX apps/docs/internals/ Markdown pipeline (generate-guides-markdown.ts, etc.) apps/docs/internals/markdown-schema/ Component handlers → plain markdown strings apps/docs/public/markdown/guides/ Generated output (produced by build) apps/docs/components/ React MDX components examples/ Tutorial/quickstart apps referenced via $CodeSample apps/studio/ Dashboard UI; may link to hosted docs .agents/skills/ In-repo agent skills (canonical; .claude/skills symlinks here) Local self-review (no open PR) Use this on your own branch before opening a PR (checklist Stage 4). No gh pr required. 1. Classify from git diff --name-only master...HEAD using the Phase 2 table. 2. Walk the bar in pm-the-docs's checklist — "What good looks like" and the Self-review checkboxes. 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills supabase/review-the-docs