feat(skills): move Write the docs skills into the monorepo — DO NOT REVIEW YET - #48914
Draft
nrichers wants to merge 1 commit into
Draft
Conversation
…the-docs from docs-agent-skills Relocates the four "Write the docs" checklist skills into the monorepo so contributors get them in the standard workflow instead of a separate repo plus manual symlink install. `.agents/skills/` is the canonical location (matching the existing `vitest` skill precedent), with pointer symlinks in `.claude/skills/` and `.cursor/skills/`. `pm-the-docs` here is new content scoped to the "Write the docs" checklist's Frame/Shape stages, not a copy of docs-agent-skills' personal, vault-bound version (renamed pm-the-docs-full there, see companion PR). The checklist itself is mirrored in-repo at pm-the-docs/reference/write-the-docs-checklist.md since the Linear source doc is private. Closes DOCS-1287.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
|
Important Review skippedDraft detected. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
I have read the CONTRIBUTING.md file.
YES
What kind of change does this PR introduce?
Adds four AI agent skills that support docs contributors across the authoring lifecycle, intended to lower the barrier to entry for contributing to our docs.
Closes DOCS-1287.
What is the current behavior?
Our process for writing docs is somewhat undefined beyond some general guidance in CONTRIBUTING.md and we don't make as easy to contribute to our docs as we could. As a result, content often needs additional changes during PR reviews or requires further revisions after merging.
The four AI agent skills in this PR already existed in a private repo where I've been testing them but they were not previously available for general use until now.
What is the new behavior?
.agents/skills/, symlinked from.claude/skills/and.cursor/skills/(same pattern as the existingvitestskill).ask-the-docs: answers architecture and design questions about apps/docs (MDX pipeline, content components, federated docs) and checks whether a proposed change fits existing docs app patterns.write-the-docs: drafts net-new or substantially rewritten docs content for a feature or launch, grounded in the Linear ticket, the actual code, and the docs style guide.review-the-docs: runs a local, PR-type-specific review checklist against any open supabase/supabase docs PR (markdown pipeline, MDX content, tutorials, examples, Studio links) and produces a consolidated report.pm-the-docs: supports "Write the docs" authoring process across the different phases.apps/docs/CONTRIBUTING.mdgets a new "AI agent skills for docs authoring" section mapping each skill to its checklist stagedocs-agent-skills(work-linear-issue,audit-docs-ia,create-pull-request,proof-it-works,pm-the-docs-full) now point there via absolute GitHub links instead of relative pathsAdditional context
pm-the-docstopm-the-docs-full, and fixes now-dangling inbound links.~/GitHub/supabase/supabase-worktrees/nikrichers/docs-1287-move-skills-mentioned-in-write-the-docs-from-docs-agentTest plan
ls -la .claude/skills/{ask-the-docs,pm-the-docs,write-the-docs,review-the-docs}resolves to.agents/skills/.../ask-the-docs,/pm-the-docs,/write-the-docs,/review-the-docsare availableapps/docs/CONTRIBUTING.mdin context.agents/skills/pm-the-docs/reference/write-the-docs-checklist.mdhas nolinear.applinks and carries the snapshot disclaimer