MCP Agent Skill — sidebutton
SideButton Skill for MCP Agent
Knowledge pack for sidebutton.com — public marketing site (homepage, /skills catalog, /contribute publishing guide, /media news, legal pages) plus Auth0-gated Fleet Control portal (/portal/*). April 2026 redesign: removed pricing, feature pages, solutions, demo, integrations; added /media; migrated auth to Auth0 Universal Login.
sidebutton install sidebutton SideButton
What This Is
SideButton.com is the public marketing website and Fleet Control portal for the SideButton AI Agent Platform. Built with Astro, it serves as the product homepage, skills directory (/skills), publishing guide (/create-agentic-ai-skill, formerly /contribute), news page (/media), and authenticated Fleet Control portal (/portal/*). The site targets developers and engineering teams looking to deploy self-learning AI agents. As of the April 2026 redesign the site is heavily simplified: the old pricing page, feature pages, solutions page, interactive demo, and integrations marketplace have all been removed. The product positioning is now "Open source MCP server for AI agents". Portal auth migrated to Auth0 Universal Login.
Authentication
Major change (April 2026): Migrated from email-only custom login to Auth0 Universal Login at sidebutton.eu.auth0.com/u/login.
- Public pages (no auth):
/,/skills,/skills/*,/create-agentic-ai-skill,/media,/privacy,/terms,/content-policy,/imprint - Portal pages (
/portal/*): Auth0-gated. Unauthenticated requests 302-redirect to/portal/login→ 302 → Auth0. /login: 308-redirect to/portal/login/connect: 308-redirect to/(page removed — old extension auth flow replaced)
Auth Flow
| Route | Behavior | Notes |
|---|---|---|
/ | 200 | Public homepage |
/skills | 200 | Knowledge pack directory |
/skills/{slug} | 200 | Pack detail page |
/skills/{slug}/roles/{role} | 200 | Role playbook page |
/create-agentic-ai-skill | 200 | Publishing guide ("Create Skills for Agentic AI") — replaces /contribute |
/contribute | 404 | Removed late-April 2026; no redirect to the new URL |
/media | 200 | News & releases |
/privacy, /terms, /content-policy, /imprint | 200 | Static legal pages |
/login | 308 → /portal/login | Legacy redirect |
/connect | 308 → / | Removed — extension auth changed |
/dmca, /trademarks | 301 → / | Removed |
/demo, /pricing, /solutions | 301 → / | Removed |
/integrations | 301 → /skills | Removed — replaced by knowledge packs catalog |
/features/* (all 5) | 301 → / | Removed |
/portal/login (unauthenticated) | 302 → Auth0 | Real login happens on sidebutton.eu.auth0.com |
/portal (unauthenticated) | 302 → /portal/chat → 302 → /portal/login → Auth0 | |
/portal/{chat,agents,jobs,queue,automations,workflows,settings} | Auth required | Fleet Control portal pages |
Global Navigation
Header (sticky, banner) — verified 2026-04-26
| Element | Selector | Notes |
|---|---|---|
| Logo link | banner > link (first) | SideButton logo + "SideButton" text → / |
| MCP Server | link "MCP Server" | → /mcp (NEW late-April 2026) |
| Skills | link "Skills" | → /skills (renamed from "Knowledge Packs" in late-April 2026) |
| Media | link "Media" | → /media |
| Docs | link "Docs" | External → docs.sidebutton.com |
| Book a Demo | link "Book a Demo" (in banner) | Green primary button → external Typeform |
| GitHub | link "View SideButton on GitHub" | Dark button → github.com/sidebutton/sidebutton |
Nav change late-April 2026: "Knowledge Packs" was RENAMED to "Skills"; "MCP Server" was ADDED. New order: MCP Server | Skills | Media | Docs.
Earlier April 2026 nav change: "Contribute" was REMOVED from the header (replaced in footer by "Create a skill" → /create-agentic-ai-skill); "Media" was ADDED.
Removed from nav (prior redesigns): Chat, Browser MCP, AI Automations dropdown, Integrations dropdown, Pricing, Solutions, user dropdown.
Fleet Control Sidebar Navigation (Portal)
On /portal/* routes, the portal uses its own sidebar layout (no marketing Header/Footer). The sidebar contains:
| Link | URL | Notes |
|---|---|---|
| Chat | /portal/chat | Default landing page |
| Agents | /portal/agents | Agent fleet management |
| Jobs | /portal/jobs | Job execution history |
| Queue | /portal/queue | Dispatch queue |
| Automations | /portal/automations | Workflow trigger automations (Jira/SideButton/Cron) |
| Workflows | /portal/workflows | Workflow definitions |
| Settings | /portal/settings | Fleet configuration |
| User info | Sidebar bottom | Avatar initial + email |
| Log out | Sidebar bottom | Ends session |
Footer (contentinfo) — verified 2026-04-26
Single-row nav layout:
| Element | Notes |
|---|---|
| Logo + copyright | "© 2026 SideButton. Free & open source under Apache 2.0." |
| GitHub | → github.com/sidebutton/sidebutton |
| Docs | → docs.sidebutton.com |
| Skills | → /skills (renamed from "Knowledge Packs" in late-April 2026) |
| Create a skill | → /create-agentic-ai-skill (replaces "Contribute" → /contribute in late-April 2026) |
| Media | → /media |
| Privacy | → /privacy |
| Terms | → /terms |
| Content Policy | → /content-policy |
| Imprint | → /imprint |
| AI Engineering Department | External → aictpo.com |
| → [email protected] (mailto) |
Footer change late-April 2026: "Knowledge Packs" link renamed to "Skills"; "Contribute" link replaced with "Create a skill" linking to /create-agentic-ai-skill.
Floating Elements
| Element | Selector | Notes |
|---|---|---|
| Cookie consent dialog | #cookie-consent (div[role="dialog"]) | Fixed bottom bar on first visit; Accept/Reject buttons; links to Privacy Policy; dismissed via CSS translate-y-full (element stays in DOM) |
Technology Stack
- Framework: Astro (SSG for public pages, SSR for portal)
- Styling: Tailwind CSS
- Auth: Auth0 Universal Login for
/portal/*pages - Deployment: Static + server-rendered hybrid
Key Sections (verified 2026-04-20 via curl)
| Section | URL Pattern | Status | Purpose |
|---|---|---|---|
| Homepage | / | ✅ 200 | Landing page (redesigned Apr 2026): hero with arch diagram, Ready-to-get-started + testimonials, compat, how-it-works, quick start, 6 featured packs, role playbooks |
| Knowledge Packs | /skills | ✅ 200 | Directory: 16 available packs (no Coming Soon section, no category filters); simple search box |
| Knowledge Pack Detail | /skills/{slug} | ✅ 200 | Single pack: modules, roles, install command |
| Role Playbook | /skills/{slug}/roles/{role} | ✅ 200 | Role playbook for a pack (NEW pattern — e.g. /skills/agents/roles/se) |
| Create a skill | /create-agentic-ai-skill | ✅ 200 | Publishing guide ("Create Skills for Agentic AI") — renamed from /contribute late-April 2026 |
| Media | /media | ✅ 200 | News & releases (NEW) |
| Privacy | /privacy | ✅ 200 | Privacy policy |
| Terms | /terms | ✅ 200 | Terms of service (14 sections now) |
| Content Policy | /content-policy | ✅ 200 | Content policy |
| Imprint | /imprint | ✅ 200 | Legal notice / Impressum |
| Portal — Chat | /portal/chat | 🔒 Auth0 | Fleet Control chat (default portal landing) |
| Portal — Agents | /portal/agents | 🔒 Auth0 | Agent fleet management |
| Portal — Jobs | /portal/jobs | 🔒 Auth0 | Job execution history |
| Portal — Job Detail | /portal/jobs/{id} | 🔒 Auth0 | Job detail view |
| Portal — Queue | /portal/queue | 🔒 Auth0 | Dispatch queue |
| Portal — Automations | /portal/automations | 🔒 Auth0 | Trigger automations |
| Portal — Automation Detail | /portal/automations/{id} | 🔒 Auth0 | Automation config |
| Portal — Workflows | /portal/workflows | 🔒 Auth0 | Workflow definitions |
| Portal — Workflow Detail | /portal/workflows/{id} | 🔒 Auth0 | Workflow step definitions |
| Portal — Settings | /portal/settings | 🔒 Auth0 | Fleet configuration (7 tabs) |
Module Inventory
Verification pass completed 2026-04-20. Public pages verified via browser snapshot + curl; portal pages blocked on Auth0 credentials.
| Module | Features | _skill.md | qa.md | se.md | Status | Brief Description |
|---|---|---|---|---|---|---|
| homepage | ~8 | 90% | — | — | ✅ VERIFIED 2026-04-20 | Redesigned: hero with arch diagram, Ready-to-get-started + inline testimonials, compat, how-it-works, quick start, 6 featured packs, 10 role groups |
| skills | ~4 | 85% | — | — | ✅ VERIFIED 2026-04-20 | Flat list of 16 available packs; simplified UI (no coming-soon, no filter tabs); single search box |
| legal | ~4 | 85% | — | — | ✅ VERIFIED 2026-04-20 | 4 remaining pages (privacy, terms, content-policy, imprint); DMCA+Trademarks 301→/ |
| create-agentic-ai-skill | ~12 | 92% | — | — | ✅ VERIFIED 2026-04-26 | Publishing guide (replaces contribute module — old /contribute URL now 404). H1 "Create Skills for Agentic AI"; 8 H2 regions including 5-item FAQ accordion (1st open by default), 3 Copy-command buttons, 7-item Skill authoring guidelines, 7-item Related list. Reachable via footer/homepage CREATE card//skills bottom CTA. |
| media | ~5 | 92% | — | — | ✅ VERIFIED 2026-04-26 | News & releases: index + post detail (/media/{slug}) + 404; 1 post (sidebutton-open-source-platform-release) with long-form layout (badge/date/lede/hero/5 H2 sections/CTA/Back link), copy-command widgets, outbound CTAs. Card title ≠ article H1 |
| login | ~7 | 85% | — | — | ✅ VERIFIED 2026-04-20 | Auth0 Universal Login at sidebutton.eu.auth0.com; email+password form |
| portal-chat | ~13 | 88% | 90% (stale) | — | ✅ VERIFIED 2026-04-20 | Sidebar adds Automations; empty state now "Welcome to Fleet Control" with 4 quick-action buttons; user avatar/email removed |
| portal-agents | ~14 | 88% | 90% (stale) | — | ✅ VERIFIED 2026-04-20 | Share + Run Workflow top buttons; per-card Copy hostname/IP, Refresh, Run Job |
| portal-jobs | ~14 | 92% | 92% | — | ✅ VERIFIED 2026-04-27 | NEW Apr 2026: inline $cost {model_short} per row (e.g. $9.79 opus-4-7); token-usage span ("N in · N,NNN out · N turns · claude-{model}"); detail page LLM USAGE card with Cost/Turns/Input/Output stats + Cache read/write + Prompt sha + PER STEP table; yellow Status-mismatch inline alert; Effort badge colors are level-specific (MAX=purple, HIGH=orange, MEDIUM=grey, NOT all green); active filter pill is dark grey (not emerald). 29 workflow filter options. "Report a Bug" floating button (global). Resend post-click label needs reverification |
| portal-queue | ~15 | 88% | 90% (stale) | — | ✅ VERIFIED 2026-04-20 | "+ Add Item" opens modal with ticket input + extras textarea; Retry / Resend actions per row |
| portal-automations | ~11 | 88% | 90% (stale) | — | ✅ VERIFIED 2026-04-20 | "+ New Automation" modal with priority buttons (Max/High/Medium); delete-confirm H2; auto name pattern JIRA>state >> action - A{id} |
| portal-workflows | ~10 | 92% | 90% (stale) | — | ✅ VERIFIED 2026-04-26 | Read-only list (no "New Workflow" — YAML-defined); 16 workflows; role-badged rows (CSM/PM/Ops/QA/SD/SE — CSM role added Apr 6); all workflows now expose entry_path input; pm-sprint expanded to project_key + capacity + hint + entry_path; new se-review-merge workflow |
| portal-settings | ~40 | 92% | 92% (stale) | — | ✅ VERIFIED 2026-04-26 | 7 tabs: General / Agents / Assistant / Issue Tracking / Slack / Knowledge Packs / Logs (General was NOT removed — earlier note was wrong). Agents has 5 roles (added csm); entry paths now have .mcp.json + new CLAUDE.md textarea; Active Role expanded to 11 options; new Domains chip selector + Role Context Files viewer on Assistant; emerald "Connected" pill on Jira card; Knowledge Pack card displays sync version + SYNCED badge + Last synced; avatar modal heading h2 with close button |
Summary
- Verified & current: 13 modules (6 public + 7 portal). portal-jobs re-verified 2026-04-27; portal-settings + portal-workflows re-verified 2026-04-26; remaining 10 re-verified 2026-04-20.
- qa.md files still stale on 6 of 7 portal modules — portal-jobs qa.md refreshed 2026-04-27; rest pending. SE files TODO.