feat: org architecture, docs hub, and data refresh (#4)

* fix(data): update stale skills, plugin counts, and hero stats

Add 10 missing skills (debate, enhance-orchestrator, enhance-agent-prompts,
enhance-claude-memory, perf-baseline-manager, perf-benchmarker, perf-profiler,
maintain-cross-platform, web-auth, web-browse). Update plugin agent/skill
counts to match actual repos. Update hero stats to 14 plugins, 43 agents,
38 skills, 230 lint rules. Mark web-ctl as active (no longer coming soon).

* fix(config): change base URL from /agent-sh.dev/ to /

The site will be served at the org root (agent-sh.github.io) rather
than a project subdirectory.

* docs: add org architecture decision record

Documents URL strategy, framework choices, design token ownership,
and future plans for unified search and shared components.

* feat(nav): add Docs link to navigation and footer

Add Docs link between Products dropdown and Plugins in desktop nav,
mobile menu, and footer Resources column.

* feat(pages): add documentation hub page

Central docs page linking to agentsys, agnix, and web-ctl documentation
sites, plus resources section with plugin catalog, skills directory,
and GitHub org links.

* fix(plugins): update plugin count from 13 to 14

* fix: address review findings - stale counts, a11y, consistency

- plugins.json: fix skill/agent counts (ship: 1 skill, audit-project: 1 skill, agnix: 1 agent)
- skills.json: remove orphan skills (enhance-agents, enhance-claudemd, baseline, benchmark, profile), fix maintain-cross-platform plugin ref
- index.astro: derive counts from data, fix em-dashes, fix title separator
- docs.astro: import data for dynamic counts, extract inline styles, fix title separator, add a11y text for external links
- plugins.astro: use dynamic plugin count, fix title separator
- Footer.astro: wrap link groups in nav elements with aria-label for a11y
- main.css: add footer nav flex layout for new nav wrappers

* fix: remove internal maintain-cross-platform skill from public catalog

* docs: replace stale Starlight template README with actual project description

Author: avifenesh

ORG_ARCHITECTURE.md

@@ -0,0 +1,38 @@
+# Org Architecture: Documentation & Website Strategy
+
+Architecture decision record for the agent-sh organization's web presence and documentation.
+
+## Decisions
+
+### URL Structure
+
+| Site | URL | Purpose |
+|------|-----|---------|
+| Landing page | `agent-sh.github.io` (root) | Org overview, plugin catalog, skills directory |
+| agentsys docs | `agent-sh.github.io/agentsys/` | Product docs for the agent runtime |
+| agnix docs | `agent-sh.github.io/agnix/` | Product docs for the config linter |
+
+Custom domain (`agent-sh.dev`) is a future step - configure via GitHub Pages CNAME when ready.
+
+### Frameworks
+
+| Site | Framework | Reason |
+|------|-----------|--------|
+| Landing page | Astro 5 | Static-first, zero JS by default, component islands |
+| agnix docs | Docusaurus 3 | WASM playground requires React, existing Docusaurus setup |
+| agentsys docs | Upgrade from static HTML | Currently hand-written HTML, planned upgrade to Astro or Docusaurus |
+
+### Design Tokens
+
+`agent-sh.dev/src/styles/tokens.css` is the canonical source for design tokens (colors, spacing, typography). Other sites mirror these values to maintain visual consistency.
+
+### Documentation Hub
+
+The landing site includes a `/docs/` page that links to all documentation sites. This provides a single entry point for users looking for docs.
+
+## Future Work
+
+- **Unified search** - Orama or similar for cross-site search
+- **Shared header/footer** - Web components or build-time includes for consistent navigation
+- **Custom domain** - `agent-sh.dev` pointing to GitHub Pages
+- **agentsys docs upgrade** - Migrate from static HTML to a framework with better DX

README.md

@@ -1,49 +1,44 @@
-# Starlight Starter Kit: Basics
+# agent-sh.dev
 
-[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+Landing site for the agent-sh organization. Static Astro 5 site deployed to `agent-sh.github.io`.
 
-```
-npm create astro@latest -- --template starlight
-```
-
-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
-
-## 🚀 Project Structure
-
-Inside of your Astro + Starlight project, you'll see the following folders and files:
+## Structure
 
 ```
 .
-├── public/
-├── src/
-│   ├── assets/
-│   ├── content/
-│   │   └── docs/
-│   └── content.config.ts
-├── astro.config.mjs
-├── package.json
-└── tsconfig.json
+├── ORG_ARCHITECTURE.md   Architecture decision record
+├── astro.config.mjs      Site config (base: /)
+├── public/               Static assets
+└── src/
+    ├── components/
+    │   ├── Nav.astro     Top navigation with Products dropdown
+    │   └── Footer.astro  Site footer
+    ├── data/
+    │   ├── plugins.json  Plugin catalog data
+    │   └── skills.json   Skills directory data
+    ├── layouts/
+    │   └── Base.astro    Base HTML layout
+    ├── pages/
+    │   ├── index.astro   Landing page - hero, stats, products, philosophy
+    │   ├── docs.astro    Documentation hub linking to all product docs
+    │   ├── plugins.astro Plugin catalog with filters
+    │   └── skills.astro  Skills directory with search
+    └── styles/
+        ├── tokens.css    Design tokens (canonical source for all sites)
+        └── main.css      Site styles
 ```
 
-Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
-
-Images can be added to `src/assets/` and embedded in Markdown with a relative link.
-
-Static assets, like favicons, can be placed in the `public/` directory.
-
-## 🧞 Commands
+## Commands
 
-All commands are run from the root of the project, from a terminal:
+| Command             | Action                                      |
+| :------------------ | :------------------------------------------ |
+| `npm install`       | Install dependencies                        |
+| `npm run dev`       | Start local dev server at localhost:4321    |
+| `npm run build`     | Build production site to ./dist/            |
+| `npm run preview`   | Preview build locally before deploying      |
 
-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npm run build`           | Build your production site to `./dist/`          |
-| `npm run preview`         | Preview your build locally, before deploying     |
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
+## Deployment
 
-## 👀 Want to learn more?
+Deployed to GitHub Pages via `.github/workflows/deploy.yml`. Base path is `/`.
 
-Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).
+See [ORG_ARCHITECTURE.md](./ORG_ARCHITECTURE.md) for the full architecture decision record covering URL structure, frameworks, design tokens, and future work.

astro.config.mjs

@@ -3,5 +3,5 @@ import { defineConfig } from 'astro/config';
 
 export default defineConfig({
   site: 'https://agent-sh.github.io',
-  base: '/agent-sh.dev/',
+  base: '/',
 });

src/components/Footer.astro

@@ -10,21 +10,28 @@ const base = import.meta.env.BASE_URL;
     </div>
     <div class="footer__col">
       <span class="footer__col-title">Products</span>
-      <a href="https://agent-sh.github.io/agentsys/" target="_blank" rel="noopener noreferrer">agentsys</a>
-      <a href="https://agent-sh.github.io/agnix/" target="_blank" rel="noopener noreferrer">agnix</a>
-      <a href="https://github.com/agent-sh/web-ctl" target="_blank" rel="noopener noreferrer">web-ctl</a>
+      <nav aria-label="Products">
+        <a href="https://agent-sh.github.io/agentsys/" target="_blank" rel="noopener noreferrer">agentsys</a>
+        <a href="https://agent-sh.github.io/agnix/" target="_blank" rel="noopener noreferrer">agnix</a>
+        <a href="https://github.com/agent-sh/web-ctl" target="_blank" rel="noopener noreferrer">web-ctl</a>
+      </nav>
     </div>
     <div class="footer__col">
       <span class="footer__col-title">Resources</span>
-      <a href={`${base}plugins/`}>Plugin Catalog</a>
-      <a href={`${base}skills/`}>Skills Directory</a>
-      <a href="https://github.com/agent-sh" target="_blank" rel="noopener noreferrer">GitHub Org</a>
+      <nav aria-label="Resources">
+        <a href={`${base}docs/`}>Documentation</a>
+        <a href={`${base}plugins/`}>Plugin Catalog</a>
+        <a href={`${base}skills/`}>Skills Directory</a>
+        <a href="https://github.com/agent-sh" target="_blank" rel="noopener noreferrer">GitHub Org</a>
+      </nav>
     </div>
     <div class="footer__col">
       <span class="footer__col-title">Community</span>
-      <a href="https://github.com/agent-sh/agentsys/discussions" target="_blank" rel="noopener noreferrer">Discussions</a>
-      <a href="https://github.com/agent-sh/agentsys/issues" target="_blank" rel="noopener noreferrer">Issues</a>
-      <a href="https://www.npmjs.com/package/agentsys" target="_blank" rel="noopener noreferrer">npm</a>
+      <nav aria-label="Community">
+        <a href="https://github.com/agent-sh/agentsys/discussions" target="_blank" rel="noopener noreferrer">Discussions</a>
+        <a href="https://github.com/agent-sh/agentsys/issues" target="_blank" rel="noopener noreferrer">Issues</a>
+        <a href="https://www.npmjs.com/package/agentsys" target="_blank" rel="noopener noreferrer">npm</a>
+      </nav>
     </div>
   </div>
   <div class="footer__bottom">

src/components/Nav.astro

@@ -30,12 +30,13 @@ function isActive(path: string) {
             <strong>agnix</strong>
             <span>Agent config linter</span>
           </a>
-          <a href="https://github.com/agent-sh/web-ctl" class="nav__dropdown-item nav__dropdown-item--soon" target="_blank" rel="noopener noreferrer">
+          <a href="https://github.com/agent-sh/web-ctl" class="nav__dropdown-item" target="_blank" rel="noopener noreferrer">
             <strong>web-ctl</strong>
-            <span>Browser automation (coming soon)</span>
+            <span>Browser automation</span>
           </a>
         </div>
       </div>
+      <a href={`${base}docs/`} class:list={["nav__link", { "nav__link--active": isActive('docs') }]}>Docs</a>
       <a href={`${base}plugins/`} class:list={["nav__link", { "nav__link--active": isActive('plugins') }]}>Plugins</a>
       <a href={`${base}skills/`} class:list={["nav__link", { "nav__link--active": isActive('skills') }]}>Skills</a>
     </div>
@@ -53,6 +54,7 @@ function isActive(path: string) {
   <a href={base} class="mobile-menu__link">Home</a>
   <a href="https://agent-sh.github.io/agentsys/" class="mobile-menu__link" target="_blank" rel="noopener noreferrer">agentsys</a>
   <a href="https://agent-sh.github.io/agnix/" class="mobile-menu__link" target="_blank" rel="noopener noreferrer">agnix</a>
+  <a href={`${base}docs/`} class="mobile-menu__link">Docs</a>
   <a href={`${base}plugins/`} class="mobile-menu__link">Plugins</a>
   <a href={`${base}skills/`} class="mobile-menu__link">Skills</a>
   <a href="https://github.com/agent-sh" class="mobile-menu__link" target="_blank" rel="noopener noreferrer">GitHub</a>

src/data/plugins.json

@@ -3,7 +3,7 @@
     "name": "next-task",
     "description": "Task to production. 12-phase pipeline: discovery, exploration, planning, implementation, review, and shipping.",
     "category": "workflow",
-    "agents": 8,
+    "agents": 10,
     "skills": 3,
     "commands": 1,
     "repo": "https://github.com/agent-sh/next-task",
@@ -14,7 +14,7 @@
     "name": "ship",
     "description": "Branch to merged PR in one command. Commits, pushes, creates PR, monitors CI, addresses reviewer comments, merges.",
     "category": "workflow",
-    "agents": 3,
+    "agents": 0,
     "skills": 1,
     "commands": 1,
     "repo": "https://github.com/agent-sh/ship",
@@ -23,7 +23,7 @@
   },
   {
     "name": "agnix",
-    "description": "Lint agent configurations with 229 validation rules across 10+ AI tools. SARIF output for GitHub Code Scanning.",
+    "description": "Lint agent configurations with 230 validation rules across 10+ AI tools. SARIF output for GitHub Code Scanning.",
     "category": "quality",
     "agents": 1,
     "skills": 1,
@@ -36,7 +36,7 @@
     "name": "deslop",
     "description": "Kill AI slop before it ships. 3-phase detection pipeline finds debug statements, placeholder text, verbose comments.",
     "category": "quality",
-    "agents": 2,
+    "agents": 1,
     "skills": 1,
     "commands": 1,
     "repo": "https://github.com/agent-sh/deslop",
@@ -45,10 +45,10 @@
   },
   {
     "name": "enhance",
-    "description": "Seven parallel analyzers check prompts, agents, plugins, docs, hooks, and skills. Certainty-graded findings.",
+    "description": "Eight parallel analyzers check prompts, agents, plugins, docs, hooks, skills, and cross-file consistency. Certainty-graded findings.",
     "category": "quality",
-    "agents": 7,
-    "skills": 8,
+    "agents": 8,
+    "skills": 9,
     "commands": 1,
     "repo": "https://github.com/agent-sh/enhance",
     "install": "agentsys install enhance",
@@ -59,7 +59,7 @@
     "description": "Evidence-backed performance investigation. 10-phase methodology with baselines, profiling, and controlled experiments.",
     "category": "research",
     "agents": 6,
-    "skills": 7,
+    "skills": 8,
     "commands": 1,
     "repo": "https://github.com/agent-sh/perf",
     "install": "agentsys install perf",
@@ -78,7 +78,7 @@
   },
   {
     "name": "audit-project",
-    "description": "Multi-agent code review. Up to 10 specialized agents review security, performance, architecture, and more.",
+    "description": "Multi-agent code review. Up to 10 specialized role-based agents review security, performance, architecture, and more.",
     "category": "quality",
     "agents": 10,
     "skills": 1,
@@ -131,16 +131,26 @@
     "install": "agentsys install consult",
     "dependencies": []
   },
+  {
+    "name": "debate",
+    "description": "Structured multi-round AI debates. Proposer vs challenger with evidence-backed arguments and synthesis.",
+    "category": "research",
+    "agents": 1,
+    "skills": 1,
+    "commands": 1,
+    "repo": "https://github.com/agent-sh/debate",
+    "install": "agentsys install debate",
+    "dependencies": ["consult"]
+  },
   {
     "name": "web-ctl",
-    "description": "Browser automation and web testing toolkit for AI agents. Coming soon.",
+    "description": "Browser automation and web testing toolkit for AI agents. Headless browser control, authentication, and page interaction.",
     "category": "infrastructure",
-    "agents": 0,
-    "skills": 0,
-    "commands": 0,
+    "agents": 1,
+    "skills": 2,
+    "commands": 1,
     "repo": "https://github.com/agent-sh/web-ctl",
-    "install": "",
-    "dependencies": [],
-    "comingSoon": true
+    "install": "agentsys install web-ctl",
+    "dependencies": []
   }
 ]

src/data/skills.json

@@ -2,17 +2,18 @@
   { "name": "orchestrate-review", "plugin": "next-task", "description": "Multi-agent code review loop that iterates until clean", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "discover-tasks", "plugin": "next-task", "description": "Scan GitHub Issues, GitLab, or local files for prioritized tasks", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "validate-delivery", "plugin": "next-task", "description": "Pre-ship quality gate: tests, build, requirements check", "platforms": ["Claude Code", "OpenCode", "Codex"] },
-  { "name": "enhance-agents", "plugin": "enhance", "description": "Analyze agent configuration quality and completeness", "platforms": ["Claude Code", "OpenCode", "Codex"] },
-  { "name": "enhance-claudemd", "plugin": "enhance", "description": "Optimize CLAUDE.md project memory files", "platforms": ["Claude Code"] },
+  { "name": "enhance-orchestrator", "plugin": "enhance", "description": "Coordinate all enhancement analyzers in parallel and produce a unified report", "platforms": ["Claude Code", "OpenCode", "Codex"] },
+  { "name": "enhance-agent-prompts", "plugin": "enhance", "description": "Analyze agent prompts for prompt engineering best practices", "platforms": ["Claude Code", "OpenCode", "Codex"] },
+  { "name": "enhance-claude-memory", "plugin": "enhance", "description": "Analyze and optimize CLAUDE.md or AGENTS.md project memory files", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "enhance-docs", "plugin": "enhance", "description": "Documentation quality improvement analysis", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "enhance-hooks", "plugin": "enhance", "description": "Git hooks and automation analysis", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "enhance-plugins", "plugin": "enhance", "description": "Plugin configuration validation and optimization", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "enhance-prompts", "plugin": "enhance", "description": "Prompt engineering best practices analysis", "platforms": ["Claude Code", "OpenCode", "Codex", "Cursor"] },
   { "name": "enhance-skills", "plugin": "enhance", "description": "Skill definition quality and spec compliance", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "enhance-cross-file", "plugin": "enhance", "description": "Cross-file semantic analysis for consistency", "platforms": ["Claude Code", "OpenCode", "Codex"] },
-  { "name": "baseline", "plugin": "perf", "description": "Establish performance baselines before changes", "platforms": ["Claude Code", "OpenCode", "Codex"] },
-  { "name": "benchmark", "plugin": "perf", "description": "Run controlled benchmarks with statistical analysis", "platforms": ["Claude Code", "OpenCode", "Codex"] },
-  { "name": "profile", "plugin": "perf", "description": "CPU and memory profiling with flamegraph generation", "platforms": ["Claude Code", "OpenCode", "Codex"] },
+  { "name": "perf-baseline-manager", "plugin": "perf", "description": "Manage performance baselines, consolidate results, and compare versions", "platforms": ["Claude Code", "OpenCode", "Codex"] },
+  { "name": "perf-benchmarker", "plugin": "perf", "description": "Run sequential benchmarks with strict duration and warmup rules", "platforms": ["Claude Code", "OpenCode", "Codex"] },
+  { "name": "perf-profiler", "plugin": "perf", "description": "CPU and memory profiling with flamegraph and hotspot evidence", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "theory-tester", "plugin": "perf", "description": "Test performance hypotheses with controlled experiments", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "code-paths", "plugin": "perf", "description": "Identify hot code paths and bottleneck functions", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "theory-gatherer", "plugin": "perf", "description": "Generate performance hypotheses from profiling data", "platforms": ["Claude Code", "OpenCode", "Codex"] },
@@ -23,8 +24,12 @@
   { "name": "repo-mapping", "plugin": "repo-map", "description": "Build AST-based symbol and import map of codebase", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "sync-docs", "plugin": "sync-docs", "description": "Find and fix documentation drift from source code", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "learn-topic", "plugin": "learn", "description": "Research topics online and create structured learning guides", "platforms": ["Claude Code", "OpenCode", "Codex"] },
-  { "name": "agnix-lint", "plugin": "agnix", "description": "Validate agent configs with 229 rules across AI tools", "platforms": ["Claude Code", "OpenCode", "Codex", "Cursor"] },
+  { "name": "agnix-lint", "plugin": "agnix", "description": "Validate agent configs with 230 rules across AI tools", "platforms": ["Claude Code", "OpenCode", "Codex", "Cursor"] },
   { "name": "ship-pr", "plugin": "ship", "description": "Full PR lifecycle: create, monitor CI, address reviews, merge", "platforms": ["Claude Code", "OpenCode", "Codex"] },
   { "name": "consult-tool", "plugin": "consult", "description": "Cross-tool AI consultation for second opinions", "platforms": ["Claude Code", "OpenCode", "Codex"] },
-  { "name": "audit-review", "plugin": "audit-project", "description": "Multi-domain code review with specialized agents", "platforms": ["Claude Code", "OpenCode", "Codex"] }
+  { "name": "audit-review", "plugin": "audit-project", "description": "Multi-domain code review with specialized agents", "platforms": ["Claude Code", "OpenCode", "Codex"] },
+  { "name": "debate", "plugin": "debate", "description": "Structured multi-round debates between AI tools with evidence-backed arguments", "platforms": ["Claude Code", "OpenCode", "Codex"] },
+
+  { "name": "web-auth", "plugin": "web-ctl", "description": "Authenticate to websites with human-in-the-loop browser handoff for login, 2FA, and CAPTCHAs", "platforms": ["Claude Code", "OpenCode", "Codex"] },
+  { "name": "web-browse", "plugin": "web-ctl", "description": "Headless browser control for navigating and interacting with web pages", "platforms": ["Claude Code", "OpenCode", "Codex"] }
 ]