⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

build-a-nimbus-site

@cloudflare⭐ 1.4k stars

Create, write and deploy a documentation site with Nimbus (Astro). Use when a user wants a new docs site, wants to add pages or components to a Nimbus site, or wants to check, upgrade or deploy one.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐⭐⭐ 1.4k on GitHubGitHub ↗

Very popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

Nimbus

Nimbus is an authoring tool for docs, built on Astro. It creates a docs site in your repo, checks the content you and your agents write, and publishes it as HTML for people and Markdown for agents.

Docs: nimbus-docs.com

Quickstart

Requires Node.js 22.12.0 or later.

npx @cloudflare/create-nimbus-docs@latest my-docs --yes --package-manager npm
cd my-docs
npm run dev

Pages live in src/content/docs/ as MDX or Markdown. Start with src/content/docs/index.mdx, and set the site's URL, title and description in astro.config.ts; they ship as placeholders.

How it works

  • Your repo holds the site: layouts, components, styles, routes and content, copied in by the scaffolder. Edit any of it.
  • @cloudflare/nimbus-docs is the dependency: the Astro integration, the helpers your routes call, and the nimbus-docs CLI.
  • The registry holds optional components and features. nimbus-docs add copies components in as source; features are Markdown recipes a coding agent applies to your project.

Features

Writing:

  • MDX components: code blocks, tabs, steps, cards, file trees, reusable snippets and interactive diagrams. Some install on demand with nimbus-docs add.
  • An API reference generated from OpenAPI 3.x, including multiple API versions.
  • Docs versions, search, and pages loaded from other Git repositories or Notion.

Checking:

  • Config, frontmatter and MDX components are validated during the build.
  • nimbus-docs lint reports authoring mistakes with rules configured in astro.config.ts. It doesn't block the build.
  • nimbus-docs check checks the environment, structure, content, types and pending upgrades without building. --fix applies safe fixes; --json gives an agent the findings.

Publishing for agents:

  • Markdown versions of docs and API reference pages, plus llms.txt and llms-full.txt. Hidden versions are left out.
  • Optional Agent Skills, WebMCP search and a remote MCP server.

Deploy

Sites are static by default: npm run build, then host the output anywhere. Rendering pages on request and the remote MCP server need a server adapter (Cloudflare, Netlify, Vercel or Node); see Deploy.

Packages

PackageWhat it is
@cloudflare/create-nimbus-docsCreates a new site.
@cloudflare/nimbus-docsThe Astro integration and the nimbus-docs CLI.

Status

Pre-1.0. The public API can change between minor releases. Pin your versions and read each package's changelog (nimbus-docs, create-nimbus-docs) before upgrading.

Contributing

Start with an issue or a discussion. Once a maintainer approves it, your pull requests go through normal review. See CONTRIBUTING.md, and CLAUDE.md for the architecture and agent context.

License

MIT

// HOW IT'S BUILT

KEY FILES

apps/www/skills/build-a-nimbus-site/SKILL.mdREADME.md

// REPO STATS

1.4k stars

// SHARE

Share on XShare on LinkedIn