Skip to content

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

Merged
andrewleesteele merged 1 commit into
hypeship/ia-how-it-worksfrom
hypeship/ia-start-building
Oct 7, 2026
Merged

andrewleesteele merged 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
Docs-only navigation and content reshuffle with redirects; no runtime or API changes. Main review risk is broken links or stale bookmarks to removed sidebar paths.

Overview
Adds a Start building sidebar group in Guides (Quickstart, Agent Skills, Integrations, Cookbooks) and removes the standalone Cookbooks tab plus the deep Integrations / Agent Skills nav trees—those pages are now discovery hubs reached from card grids.

Quickstart (/start/quickstart) is new: entry cards for agent, SDK, API, CLI, MCP, skills, frameworks, and cookbooks; Path 1 uses a full-width copy prompt; Path 2 walks through API key, SDK install, and create-and-drive examples in TypeScript, Python, and Go. /quickstart redirects here.

Integrations overview is rewritten as task-based card sections (attach to existing agents, build your own, computer use, automation, auth/payments, deploy, observability). Starter pages for Codex and OpenAI Agents SDK are added; integration icons for OpenAI, OpenAGI, and Tzafon are added. The Foreman integration doc is removed in favor of the Eve × Foreman cookbook, with a redirect from /integrations/vercel/foreman.

Agent Skills and Cookbooks pages get wide card layouts (skills by popularity; cookbooks reordered and split into computer use, frameworks, hosted agents, sandboxes). Several hub pages rename title from “Overview” to clearer labels; quickstart copy-prompt styling is tweaked in style.css.

Reviewed by Cursor Bugbot for commit d7688e6. 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

@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
Comment thread integrations/overview.mdx Outdated
Comment thread skills/overview.mdx Outdated
Comment thread integrations/overview.mdx Outdated
Comment thread integrations/overview.mdx Outdated
@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.

@andrewleesteele
andrewleesteele force-pushed the hypeship/ia-start-building branch from 7d388fe to 58451c5 Compare October 6, 2026 22:03
@andrewleesteele
andrewleesteele force-pushed the hypeship/ia-start-building branch from eecc361 to 241fc81 Compare October 7, 2026 15:17
@andrewleesteele
andrewleesteele force-pushed the hypeship/ia-start-building branch from 241fc81 to 0520f87 Compare October 7, 2026 18:21
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@andrewleesteele
andrewleesteele force-pushed the hypeship/ia-start-building branch from 0520f87 to d7688e6 Compare October 7, 2026 18:23

@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.

LGTM

@andrewleesteele
andrewleesteele merged commit 17283eb into main Oct 7, 2026
3 checks passed
@andrewleesteele
andrewleesteele deleted the hypeship/ia-start-building branch October 7, 2026 18:44
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