Name: website
Author: XoRHub

Imported from XoRHub/website (AGENTS.md). Install upstream with npx skills add XoRHub/website. Copyright stays with the author.

AGENTS.md — working on the WaaS docs site as a coding agent

Docusaurus site (docs-only mode) documenting WaaS (XoRHub/waas) and waas-images (XoRHub/waas-images) for end users. Published to GitHub Pages at https://xorhub.github.io/website/.

Ground rules

Facts come from the source repos. This site paraphrases waas/docs/*.md, waas/helm/waas/README.md and the waas-images README/CONTRIBUTING/HARDENING — never invent behavior; when in doubt, read the source repo (often available as sibling checkouts ../waas and ../waas-images). Never modify those repos from here.
Audience is the end user (platform admin or workspace user) — not contributors to the waas codebase. Internal CI, code structure and contributor workflows stay in the source repos.
Generated files are never hand-edited: docs/reference/crds/*.mdx (gitignored, regenerated by npm run gen:crd before every start/build) and versioned_docs/**/reference/crds/*.mdx (frozen snapshots cut by docusaurus docs:version).
versioned_docs/ is frozen history — edit docs/ (the Next version) unless fixing a factual error in a released snapshot.
Missing screenshots are gray placeholders tracked in IMAGES_TODO.md + a TODO(image) MDX comment at each use site. Adding one: update all three (image file, comment, TODO list).

Toolchain

Everything through mise (.mise.toml is the single source, CI installs from it via jdx/mise-action):

mise install
npm ci
npm start            # dev server (runs gen:crd first)
npm run build        # what CI runs — must pass, fails on broken links
npm run typecheck

Key moving parts

What	Where
CRD schema sync (from waas, ref pinned)	`scripts/sync-crd-schemas.mjs`, `crd-schemas/WAAS_REF`
CRD page generator	`scripts/generate-crd-docs.mjs` (`npm run gen:crd`)
Docs version cut (on waas release)	`.github/workflows/version-cut.yml`; procedure in CONTRIBUTING.md
Pages deploy	`.github/workflows/deploy.yml` (build PRs, deploy main)
Sidebar	`sidebars.ts` — new pages must be added there

Commits

Conventional Commits, atomic: docs: content, feat: site/generator features, ci:, chore:, fix:. Same doctrine as the source repos.

Definition of done

npm run build green (it regenerates the CRD pages and checks every link across all versions), npm run typecheck green, new pages wired into sidebars.ts, placeholders tracked in IMAGES_TODO.md.

Install website and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "xorhub-website-website", "kind": "skill", "name": "website", "description": "Docusaurus site (docs-only mode) documenting **WaaS** ([XoRHub/waas](https://github.com/XoRHub/waas)) and **waas-images** ([XoRHub/waas-images](https://github.com/XoRHub/waas-images)) for end users. Published to GitHub Pages at `https://xorhub.github.io/website/`.", "publisher": "XoRHub", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Docusaurus site (docs-only mode) documenting **WaaS** ([XoRHub/waas](https://github.com/XoRHub/waas)) and **waas-images** ([XoRHub/waas-images](https://github.com/XoRHub/waas-images)) for end users. Published to GitHub Pages at `https://xorhub.github.io/website/`." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/XoRHub/website", "path": "AGENTS.md", "ref": "ee82a6b391f5de9edc112a7402a4f190f644b6fa", "url": "https://github.com/XoRHub/website/blob/ee82a6b391f5de9edc112a7402a4f190f644b6fa/AGENTS.md", "key": "XoRHub/website/AGENTS.md" } }, "instructions": "# AGENTS.md — working on the WaaS docs site as a coding agent\n\nDocusaurus site (docs-only mode) documenting **WaaS**\n([XoRHub/waas](https://github.com/XoRHub/waas)) and **waas-images**\n([XoRHub/waas-images](https://github.com/XoRHub/waas-images)) for end\nusers. Published to GitHub Pages at `https://xorhub.github.io/website/`.\n\n## Ground rules\n\n- **Facts come from the source repos.** This site paraphrases\n `waas/docs/*.md`, `waas/helm/waas/README.md` and the waas-images\n README/CONTRIBUTING/HARDENING — never invent behavior; when in doubt,\n read the source repo (often available as sibling ch", "cost": { "context_tokens": 643 } }

website

About

AGENTS.md — working on the WaaS docs site as a coding agent

Ground rules

Toolchain

Key moving parts

Commits

Definition of done

Install website and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews