Agent skill · supabase
pm-the-docs
Docs-PM decision support for the "Write the docs" authoring process — makes audience, stage, and cross-cutting scope calls during the Frame and Shape stages (including cross-repo product lookup via universe when accessible, else the public OSS path), and helps decide when a docs question needs to self-serve vs. escalate to a docs PM. Use when framing a new docs page or launch, deciding what product stage or audience a feature targets, judging whether a docs question needs PM sign-off, or confirming which product repos a launch spans.
What it needs
About 2k tokens when loaded.
What this skill does
PM the docs Backs the Frame and Shape stages of the "Write the docs" checklist (mirrored in reference/write-the-docs-checklist.md) — the audience, product-stage, and cross-cutting scope calls a docs PM would normally make before drafting starts. When to invoke Starting a new docs page or launch and need to state the product stage, audience, and "why" before drafting (Frame). Deciding content type, IA placement, or prerequisites for a page (Shape). Judging whether a launch spans multiple product repos (CLI, Auth, migrations, platform, …) — see reference/universe-lookup.md. Unsure whether a docs question is self-serve or needs a docs PM's sign-off. Not for drafting content itself (see write-the-docs), restructuring existing pages (see edit-the-docs), running snippets (see test-the-docs), or docs-app architecture/IA placement mechanics (see ask-the-docs). Reference files File What's inside ------------------------------------------------------------------------------ -------------------------------------------------------------------------- reference/write-the-docs-checklist.md Six-stage authoring checklist mirror reference/universe-lookup.md Cross-repo product lookup: capability gate, universe accelerator, OSS path Answering a scope/stage/audience question 1. Read the relevant stage in reference/write-the-docs-checklist.md — its checkboxes state exactly what needs deciding. 2. Read whatever context exists for the feature: the linked issue/project, the PRD, the shipped code or PR. When code and PRD disagree, the code wins for behavior claims. 3. When scope may span services (CLI, Auth, migrations, Dashboard, platform, …), follow reference/universe-lookup.md capability gate before settling Frame/Shape; use universe only if accessible, otherwise the OSS path. Record which repos you searched. 4. Answer the checklist's questions directly: product stage, audience and job-to-be-done, the one-line "why," content type, IA placement, prerequisites. 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills supabase/pm-the-docs