Skip to content

Add Start building: quickstart, agent skills, integrations, cookbooks - #672

Open
andrewleesteele wants to merge 1 commit into
hypeship/ia-how-it-worksfrom
hypeship/ia-start-building
Open

andrewleesteele wants to merge 1 commit into
hypeship/ia-how-it-worksfrom
hypeship/ia-start-building

Conversation

@andrewleesteele

@andrewleesteele andrewleesteele commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Second layer of the guides IA restructure (stack: #671 → #672 → #673 → #674). Adds the Start building section: Quickstart, Agent Skills, Integrations, Cookbooks.

  • Quickstart (new): a grid of ways in (coding agent, SDK, REST API, CLI, MCP, skills, framework, cookbook), then two paths — hand it to your coding agent (copy prompt with a "what this prompt does" accordion) or write it yourself with an SDK (API key, install, create-and-drive in TypeScript, Python, and Go). Next steps at the bottom apply to either path.
  • Agent Skills: a card grid listing every skill in kernel/skills, with the most installed first, and a pointer to native plugin installs.
  • Integrations: a card grid replaces the long sidebar list. Sections follow what the reader is doing: add a browser to an agent you already use, build your own agent, computer use models, browser automation frameworks, credentials and payments, deploy, observability. Adds starter pages for Codex and the OpenAI Agents SDK, cards for OpenTelemetry export, e2e, and Docker Sandboxes, and logos for OpenAI, Yutori, OpenAGI, and Tzafon. The Foreman guide is removed in favor of its cookbook, with a redirect.
  • Cookbooks: moves from its own tab into the Guides sidebar. Common patterns are reordered by importance, and the harness recipes are grouped under subheadings by type.
  • /quickstart now redirects to the new quickstart.
  • Integration, skill, and cookbook pages are reached from their grids rather than the sidebar; seo.indexing keeps them indexed.

Testing

  • mint validate and mint broken-links pass on this branch.
  • Copy prompt button checked on the deployed preview.
  • The Go quickstart example compiles against the current kernel-go-sdk. The OpenAI Agents SDK example matches the installed openai-agents API but wasn't run end to end.

🤖 Generated with Claude Code


Note

Low Risk
Documentation and navigation IA only; redirects preserve old URLs. No runtime or API behavior changes.

Overview
Adds a Start building sidebar group in Guides (Quickstart, Agent Skills, Integrations, Cookbooks) and drops the standalone Cookbooks tab plus the long Integrations/Agent Skills nav trees—those pages are now hub grids under the new section.

Quickstart (start/quickstart.mdx) is new: an eight-way entry grid, a coding-agent copy-prompt path (full-width button via style.css), and SDK walkthroughs in TypeScript, Python, and Go. /quickstart redirects to /start/quickstart.

Integrations overview becomes a wide, task-based card hub (existing agents, build-your-own, computer use, automation, auth/payments, deploy, observability), with starter guides for Codex and the OpenAI Agents SDK, new integration icons, and removal of the Vercel Foreman page in favor of a redirect to /cookbooks/eve-foreman.

Agent Skills and Cookbooks hubs get card layouts; cookbooks reorder common patterns and split harness recipes into subsections (computer use, frameworks, hosted agents, sandboxes). Several overview pages get clearer titles (sidebarTitle where needed).

Reviewed by Cursor Bugbot for commit 58451c5. Bugbot is set up for automated code reviews on this repo. Configure here.

@andrewleesteele
andrewleesteele added this pull request to stack #675 October 5, 2026 19:58
@andrewleesteele andrewleesteele changed the title Restructure Start building: quickstart, skills, integrations, cookbooks Add Start building: quickstart, agent skills, integrations, cookbooks Oct 5, 2026
@dprevoznik
dprevoznik marked this pull request as ready for review October 5, 2026 21:15

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale Bugbot comment from a previous run.

Comment thread start/quickstart.mdx Outdated
Comment thread start/quickstart.mdx
Comment thread cookbooks.mdx
Comment thread integrations/overview.mdx Outdated
<Card title="Claude Managed Agents" icon="/images/integration-icons/claude.svg" href="/integrations/claude/claude-managed-agents">
Run Anthropic's hosted agent harness against Kernel browsers.
</Card>
<Card title="Codex" icon="openai" href="/integrations/openai/codex">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Codex is missing an icon here

@dprevoznik dprevoznik left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

leaving some comments - great work!

Comment thread integrations/overview.mdx Outdated
<Card title="fx" icon="/images/integration-icons/vercel.svg" href="/integrations/vercel/fx">
Give Vercel's fx coding agent a Kernel browser over MCP.
</Card>
<Card title="Foreman" icon="/images/integration-icons/vercel.svg" href="/integrations/vercel/foreman">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd just remove this guide. we have the cookbook already

Comment thread integrations/overview.mdx Outdated
<Card title="Vercel AI SDK" icon="/images/integration-icons/vercel.svg" href="/integrations/vercel/ai-sdk">
Give AI SDK agents Kernel browser tools.
</Card>
<Card title="Browser Use" icon="/images/integration-icons/browser-use-logo-transparent.svg" href="/integrations/browser-use">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

move browser use to browser automation framework section

Comment thread skills/overview.mdx
<Card title="Compare Profiles" icon="code-compare" href="https://www.skills.sh/kernel/skills/diff-profile-archives">
Compare two profile snapshots to find state differences that explain an issue.
</Card>
<Card title="Generate Video" icon="film" href="https://www.skills.sh/kernel/skills/generate-video">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i think we can leave this video skill out of the docs

Comment thread integrations/overview.mdx Outdated
<Card title="Anthropic" icon="/images/integration-icons/claude.svg" href="/integrations/computer-use/anthropic">
Claude computer use.
</Card>
<Card title="OpenAI" icon="openai" href="/integrations/computer-use/openai">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

missing a logo

Comment thread integrations/overview.mdx Outdated
<Card title="Gemini" icon="google" href="/integrations/computer-use/gemini">
Gemini 2.5 Computer Use.
</Card>
<Card title="Yutori" icon="/images/integration-icons/computer-cursor-rounded.svg" href="/integrations/computer-use/yutori">

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if possible i think we should get logos for these three as well. at least yutori

@andrewleesteele
andrewleesteele force-pushed the hypeship/ia-start-building branch from caf72ae to e5f64ef Compare October 6, 2026 19:58

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

There are 2 total unresolved issues (including 1 from previous review).

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit e5f64ef. Configure here.

Comment thread cookbooks.mdx
<Card title="Modal Web Scraper" img="/images/cookbooks/modal.png" href="https://github.com/kernel/cookbooks/tree/main/integrations/modal-web-scraper">
</Columns>

### Sandboxes and platforms

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cookbook search ignores new headings

Medium Severity

Harness recipes now sit under H3 groups, but CookbookSearch only toggles a section heading when the previous sibling is an H2. Filtering therefore leaves empty headings such as Harnesses & models and Computer use models on screen after cards are hidden.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit e5f64ef. Configure here.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@andrewleesteele
andrewleesteele force-pushed the hypeship/ia-start-building branch from 7d388fe to 58451c5 Compare October 6, 2026 22:03

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants