From 0f122472341759f8eb5df1a9b23d0b198f112951 Mon Sep 17 00:00:00 2001 From: Avi Fenesh Date: Sun, 22 Feb 2026 01:35:40 +0200 Subject: [PATCH 1/9] 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). --- src/components/Nav.astro | 4 ++-- src/data/plugins.json | 48 ++++++++++++++++++++++++---------------- src/data/skills.json | 14 ++++++++++-- src/pages/index.astro | 41 ++++++++++++++++++++-------------- 4 files changed, 68 insertions(+), 39 deletions(-) diff --git a/src/components/Nav.astro b/src/components/Nav.astro index 3721e37..b8edb78 100644 --- a/src/components/Nav.astro +++ b/src/components/Nav.astro @@ -30,9 +30,9 @@ function isActive(path: string) { agnix Agent config linter - + web-ctl - Browser automation (coming soon) + Browser automation diff --git a/src/data/plugins.json b/src/data/plugins.json index e9fad77..2127f75 100644 --- a/src/data/plugins.json +++ b/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,8 +14,8 @@ "name": "ship", "description": "Branch to merged PR in one command. Commits, pushes, creates PR, monitors CI, addresses reviewer comments, merges.", "category": "workflow", - "agents": 3, - "skills": 1, + "agents": 0, + "skills": 0, "commands": 1, "repo": "https://github.com/agent-sh/ship", "install": "agentsys install ship", @@ -23,9 +23,9 @@ }, { "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, + "agents": 0, "skills": 1, "commands": 1, "repo": "https://github.com/agent-sh/agnix", @@ -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,10 +78,10 @@ }, { "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, + "skills": 0, "commands": 1, "repo": "https://github.com/agent-sh/audit-project", "install": "agentsys install audit-project", @@ -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": [] } ] diff --git a/src/data/skills.json b/src/data/skills.json index 2210946..c8e53d0 100644 --- a/src/data/skills.json +++ b/src/data/skills.json @@ -2,7 +2,10 @@ { "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-orchestrator", "plugin": "enhance", "description": "Coordinate all enhancement analyzers in parallel and produce a unified report", "platforms": ["Claude Code", "OpenCode", "Codex"] }, { "name": "enhance-agents", "plugin": "enhance", "description": "Analyze agent configuration quality and completeness", "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-claudemd", "plugin": "enhance", "description": "Optimize CLAUDE.md project memory files", "platforms": ["Claude Code"] }, { "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"] }, @@ -10,6 +13,9 @@ { "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": "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": "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"] }, @@ -23,8 +29,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": "maintain-cross-platform", "plugin": "agentsys", "description": "Meta-skill for maintaining 3-platform architecture across releases", "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"] } ] diff --git a/src/pages/index.astro b/src/pages/index.astro index 993c6ad..3cb5f22 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -18,10 +18,10 @@ const philosophy = [ const stats = [ { value: "18", label: "Repos" }, - { value: "13", label: "Plugins" }, - { value: "42", label: "Agents" }, - { value: "28", label: "Skills" }, - { value: "229", label: "Lint Rules" }, + { value: "14", label: "Plugins" }, + { value: "43", label: "Agents" }, + { value: "38", label: "Skills" }, + { value: "230", label: "Lint Rules" }, ]; --- @@ -30,7 +30,7 @@ const stats = [
-
18 repos · 13 plugins · 42 agents · 28 skills
+
18 repos · 14 plugins · 43 agents · 38 skills

Code does code work.
AI does AI work.

@@ -67,7 +67,7 @@ const stats = [ Flagship
agentsys
-

Agent runtime and orchestration system. 13 plugins, 42 agents, 28 skills. Task to merged PR with one plan approval.

+

Agent runtime and orchestration system. 14 plugins, 43 agents, 38 skills. Task to merged PR with one plan approval.

12 commands · 3 platforms · 6 languages
npm install -g agentsys @@ -79,8 +79,8 @@ const stats = [ Tool
agnix
-

Agent config linter. 229 validation rules across 10+ AI tools. SARIF output for GitHub Code Scanning integration.

- 229 rules · 10+ tools · SARIF output +

Agent config linter. 230 validation rules across 10+ AI tools. SARIF output for GitHub Code Scanning integration.

+ 230 rules · 10+ tools · SARIF output
npx agnix .
- Coming Soon + Tool
web-ctl
-

Browser automation and web testing toolkit for AI agents. Headless browser control, visual regression, and E2E testing.

- In development +

Browser automation and web testing toolkit for AI agents. Headless browser control, authentication, and page interaction.

+ 1 agent · 2 skills · Playwright-based +
+ agentsys install web-ctl + +
@@ -111,7 +117,7 @@ const stats = [
-

Workflow orchestration — 13 plugins, 42 agents, 28 skills.

+

Workflow orchestration — 14 plugins, 43 agents, 38 skills.

-

Agent config linter — 229 rules across 10+ AI tools.

+

Agent config linter — 230 rules across 10+ AI tools.

-

Browser automation for AI agents — Playwright-based, no MCP overhead.

-
+

Browser automation for AI agents - Playwright-based, no MCP overhead.

+
+ 
$ agentsys install web-ctl
-

Coming soon. Follow progress

+

Skills: web-browse (headless navigation) and web-auth (login handoff)

From 9c3c696175f175cffb5ed52dfa7f6bbe2edebe5f Mon Sep 17 00:00:00 2001 From: Avi Fenesh Date: Sun, 22 Feb 2026 01:35:48 +0200 Subject: [PATCH 2/9] 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. --- astro.config.mjs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/astro.config.mjs b/astro.config.mjs index ec60461..224c428 100644 --- a/astro.config.mjs +++ b/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: '/', }); From 6eae30dccd81b2125f3852dea4c82461708a1a73 Mon Sep 17 00:00:00 2001 From: Avi Fenesh Date: Sun, 22 Feb 2026 01:36:06 +0200 Subject: [PATCH 3/9] docs: add org architecture decision record Documents URL strategy, framework choices, design token ownership, and future plans for unified search and shared components. --- ORG_ARCHITECTURE.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 ORG_ARCHITECTURE.md diff --git a/ORG_ARCHITECTURE.md b/ORG_ARCHITECTURE.md new file mode 100644 index 0000000..da12ce2 --- /dev/null +++ b/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 From 35995b6a7eadc3f5ae29afdb9c871191a34385d7 Mon Sep 17 00:00:00 2001 From: Avi Fenesh Date: Sun, 22 Feb 2026 01:36:24 +0200 Subject: [PATCH 4/9] 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. --- src/components/Footer.astro | 1 + src/components/Nav.astro | 2 ++ 2 files changed, 3 insertions(+) diff --git a/src/components/Footer.astro b/src/components/Footer.astro index 427acf0..f92ab57 100644 --- a/src/components/Footer.astro +++ b/src/components/Footer.astro @@ -16,6 +16,7 @@ const base = import.meta.env.BASE_URL;
Resources + Documentation Plugin Catalog Skills Directory GitHub Org diff --git a/src/components/Nav.astro b/src/components/Nav.astro index b8edb78..35aacdc 100644 --- a/src/components/Nav.astro +++ b/src/components/Nav.astro @@ -36,6 +36,7 @@ function isActive(path: string) {
+ Docs Plugins Skills @@ -53,6 +54,7 @@ function isActive(path: string) { Home agentsys agnix + Docs Plugins Skills GitHub From 74b3283978dae5009ea1ae8390cd060ff44c9509 Mon Sep 17 00:00:00 2001 From: Avi Fenesh Date: Sun, 22 Feb 2026 01:36:53 +0200 Subject: [PATCH 5/9] 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. --- src/pages/docs.astro | 80 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 src/pages/docs.astro diff --git a/src/pages/docs.astro b/src/pages/docs.astro new file mode 100644 index 0000000..fa72aea --- /dev/null +++ b/src/pages/docs.astro @@ -0,0 +1,80 @@ +--- +import Base from '../layouts/Base.astro'; +import Nav from '../components/Nav.astro'; +import Footer from '../components/Footer.astro'; +import '../styles/tokens.css'; +import '../styles/main.css'; + +const base = import.meta.env.BASE_URL; + +const docSites = [ + { + name: "agentsys", + description: "Agent runtime and orchestration system. Installation, plugin development, cross-platform compatibility, and API reference.", + url: "https://agent-sh.github.io/agentsys/", + badge: "Flagship", + badgeClass: "product-card__badge--flagship" + }, + { + name: "agnix", + description: "Agent config linter. Rule reference, SARIF integration, WASM playground, and custom rule development.", + url: "https://agent-sh.github.io/agnix/", + badge: "Tool", + badgeClass: "product-card__badge--tool" + }, + { + name: "web-ctl", + description: "Browser automation toolkit. Session management, authentication handoff, headless navigation, and selector reference.", + url: "https://github.com/agent-sh/web-ctl", + badge: "Tool", + badgeClass: "product-card__badge--tool" + } +]; + +const resources = [ + { name: "Plugin Catalog", description: "Browse all 14 plugins with install commands", url: `${base}plugins/` }, + { name: "Skills Directory", description: "38 skills across the ecosystem", url: `${base}skills/` }, + { name: "GitHub Org", description: "Source code, issues, and discussions", url: "https://github.com/agent-sh" } +]; +--- + +