About docs-platform-rollout
docs-platform-rollout is a self-contained skill for setting up project documentation and publishing it with Docusaurus and Vercel. It guides documentation structure, site configuration, and local build validation in one workflow.
Key features
- 01Bootstraps a governed docs structure
- 02Sets up a Docusaurus site in website/
- 03Configures Vercel deployment
- 04Adds root npm scripts for docs
- 05Validates the local site build
Use cases
- 01Creating documentation for a new project
- 02Standardizing an existing docs/ directory
- 03Publishing root docs through Vercel
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ dhananjaypawar26/ docs-platform-rollout --skill docs-platform-rolloutAfter installing, type/docs-platform-rolloutin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
README.mdreferences/docs-docusaurus-vercel.SKILL.mdproject-docs-bootstrap.SKILL.mdskills-usage-and-vercel-deployment.mdDetails
From the project READMEDocs Platform Rollout
Use this skill when the user wants complete documentation setup in one run.
Scope
This skill is self-contained and ships the implementation details it needs in references/.
Bundled references:
references/project-docs-bootstrap.SKILL.mdreferences/docs-docusaurus-vercel.SKILL.mdreferences/skills-usage-and-vercel-deployment.md
How to load references
Read the references in this order before making changes:
references/project-docs-bootstrap.SKILL.mdreferences/docs-docusaurus-vercel.SKILL.mdreferences/skills-usage-and-vercel-deployment.mdonly when deployment or reuse guidance is needed
Workflow order
- Use
references/project-docs-bootstrap.SKILL.mdto create or standardize thedocs/structure and baseline content. - Use
references/docs-docusaurus-vercel.SKILL.mdto publish docs with Docusaurus and configure Vercel deployment. - Validate local docs build and list deployment steps.
Inputs to confirm
- Project/repo name
- Branch strategy (auto deploy or manual production promotion)
- Desired docs route (
/docsor/) - Vercel root strategy (repo root or
website)
Required outputs
- Production-ready
docs/structure with governance metadata. website/Docusaurus site consuming root docs.vercel.jsonaligned to root-directory strategy.- Root npm scripts for docs dev/build/serve.
- Validation result from local docs build.
Acceptance criteria
- Docs structure exists and is internally consistent.
npm --prefix website run buildsucceeds.- Sidebar renders all configured sections.
- Vercel deployment config is explicit and reproducible.
- The skill can be copied alone into another repo under
.agents/skills/docs-platform-rollout/and still be usable.
Failure handling
- If docs build fails, fix MDX/sidebar/routes before finishing.
- If Vercel setup fails, provide exact fallback mode (
Mode AorMode B) and branch/deploy instructions.
Comments
Markdown supported