SideButton Marketing Website Contribute (Publish Knowledge Packs) — Knowledge Module

Contribute (Publish Knowledge Packs)

What This Is

Public-facing guide for publishing knowledge packs. The page explains what files a pack contains, how to scaffold + publish via the sidebutton CLI, and lists community guidelines. Reachable from the homepage publish banner, the footer "Contribute" link, and the /skills directory bottom CTA. Not linked in the main header as of the 2026-04 redesign (moved to footer-only).

URL Patterns

Pattern	HTTP	Description
/contribute	200	Publishing guide (static page)

Page Title & Meta

• <title>: Publish Coding Agent Knowledge Packs — MCP Server CLI
• H1: Publish Knowledge Packs for Coding Agents

Page Structure

+--[Header: standard marketing layout]--------------+
|                                                    |
|  H1: Publish Knowledge Packs for Coding Agents     |
|                                                    |
|  H2: What's in a knowledge pack                    |
|    H3: _skill.md                                   |
|    H3: _roles/*.md                                 |
|    H3: *.yaml                                      |
|    H3: skill-pack.json                             |
|                                                    |
|  H2: How to publish                                |
|    H3: Scaffold a knowledge pack                   |
|    H3: Document the app                            |
|    H3: Validate                                    |
|    H3: Publish                                     |
|                                                    |
|  H2: Guidelines                                    |
|  H2: Related                                       |
|  H2: Resources                                     |
|                                                    |
+--[Footer: standard]--------------------------------+

Key Elements

Element	Selector	Notes
H1	heading "Publish Knowledge Packs for Coding Agents"	Primary page heading
Section 1	heading "What's in a knowledge pack" (H2)	Describes pack file types (_skill.md, _roles/, YAML workflows, skill-pack.json)
Section 2	heading "How to publish" (H2)	Step-by-step: scaffold → document → validate → publish
Section 3	heading "Guidelines" (H2)	Community publishing guidelines
Section 4	heading "Related" (H2)	Cross-links
Section 5	heading "Resources" (H2)	External resources

Data Model

Pack File Structure (documented on page)

File	Purpose
_skill.md	Root skill description with frontmatter (name, domain, modules, …)
_roles/*.md	Role playbooks (qa.md, se.md, pm.md, sd.md, etc.)
*.yaml	Workflow definitions bound to the pack
skill-pack.json	Package manifest (name, version, title, description, roles, private flag)

CLI Commands (documented on page)

Command	Purpose
sidebutton init	Scaffold a new pack locally
sidebutton publish	Push pack to the SideButton registry
(validate step)	Likely sidebutton validate or similar — verify by scrolling section

Common Tasks

1. Reach the contribute page from anywhere on the site

1. Click footer link "Contribute" OR click homepage publish banner "Learn how" OR click /skills bottom "Learn how to contribute"
2. Lands on /contribute

2. Start a new pack

1. Read "Scaffold a knowledge pack" section (H3)
2. Run sidebutton init locally
3. Follow prompts

Tips

• The contribute link was removed from the header nav in April 2026 — it's now only in the footer and the homepage publish banner.
• This page is the canonical documentation for the pack format (the packages/core/ SkillRegistry consumes packs in the format described here).

Gotchas

• No longer in header: Header nav reads Knowledge Packs | Docs | Media (not Contribute). Tests asserting Contribute in banner will fail.
• Details of each section are not fully documented in this skill file — page body content (prose, code samples, tables) has not been captured section-by-section. Re-read with snapshot(includeContent=true) if workflows need exact text.