feat: configure Starlight site for multi-product agent-sh org

- Sidebar with AgentSys, Agnix, and Skills sections
- Homepage with product cards, quick start, and philosophy
- AgentSys section: overview, getting-started, plugin catalog, CLI reference
- Agnix section: overview and getting-started
- Skills catalog with all 28 skills across 13 plugins
- GitHub Pages deploy workflow
- public/llms.txt for AI discoverability
- Pagefind search enabled across all products

Author: avifenesh

.github/workflows/deploy.yml

@@ -0,0 +1,46 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - name: Install dependencies
+        run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,21 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

astro.config.mjs

@@ -0,0 +1,42 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+// https://astro.build/config
+export default defineConfig({
+	site: 'https://agent-sh.github.io',
+	base: '/agent-sh.dev',
+	integrations: [
+		starlight({
+			title: 'agent-sh',
+			tagline: 'Code does code work. AI does AI work.',
+			social: [
+				{ icon: 'github', label: 'GitHub', href: 'https://github.com/agent-sh' },
+			],
+			sidebar: [
+				{
+					label: 'AgentSys',
+					items: [
+						{ label: 'Overview', slug: 'agentsys' },
+						{ label: 'Getting Started', slug: 'agentsys/getting-started' },
+						{ label: 'Plugin Catalog', slug: 'agentsys/plugins' },
+						{ label: 'CLI Reference', slug: 'agentsys/cli' },
+					],
+				},
+				{
+					label: 'Agnix',
+					items: [
+						{ label: 'Overview', slug: 'agnix' },
+						{ label: 'Getting Started', slug: 'agnix/getting-started' },
+					],
+				},
+				{
+					label: 'Skills',
+					items: [
+						{ label: 'Agent Skills Catalog', slug: 'skills' },
+					],
+				},
+			],
+		}),
+	],
+});