Add Cookbooks page - #537
Conversation
New Cookbooks tab with a card gallery for all 16 kernel/cookbooks recipes, per-card feature/integration labels, live search filter (snippets/cookbook-search.jsx), sidebar external links to each cookbook subdirectory, and card artwork in images/cookbooks/.
…links Add cookbook Tips to the five integration pages with a matching cookbook, and point claude-managed-agents-kernel links (integration page + changelog) at kernel/cookbooks subdirectories.
…ookbooks-page-94e601 # Conflicts: # style.css
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit 10dcac3. Configure here.
| so hide pagination that would point at them */ | ||
| #pagination a[href^="/cookbooks/"] { | ||
| display: none; | ||
| } |
There was a problem hiding this comment.
Pagination hide misses production URLs
Medium Severity
The pagination hide rule matches only hrefs that start with /cookbooks/. Docs are served under /docs, so production pagination links likely will not match and will still send readers to the empty cookbook stubs this rule is meant to hide.
Reviewed by Cursor Bugbot for commit 10dcac3. Configure here.
|
|
||
| <CookbookSearch /> | ||
|
|
||
| <Columns className="responsive-columns" cols={3}> |
There was a problem hiding this comment.
Remove features section per canvas notes
| Apply Chromium Enterprise Policies to browser sessions. | ||
| </Card> | ||
| <Card title="Modal Web Scraper" img="/images/cookbooks/modal-web-scraper.png" href="https://github.com/kernel/cookbooks/tree/main/integrations/modal-web-scraper"> | ||
| <div className="cookbook-tag">integration</div> |
There was a problem hiding this comment.
Remove this "integration" subheader
| ] | ||
| }, | ||
| { | ||
| "group": "Integrations", |
There was a problem hiding this comment.
Naming this "integrations" is confusing imo because we have guides called "Integrations" --> https://www.kernel.sh/docs/integrations/overview . What should this be called, "Examples?" "Samples?" "Reference Implementations?"
| </Card> | ||
| <Card title="AI SDK Agent" img="/images/cookbooks/ai-sdk-agent.png" href="https://github.com/kernel/cookbooks/tree/main/integrations/ai-sdk-agent"> | ||
| <div className="cookbook-tag">integration</div> | ||
| Natural language browser automation with the Vercel AI SDK and Kernel's Playwright execution API. |
There was a problem hiding this comment.
Let's try to get this in the default desktop presentation in under 3 lines:
Browser automation with the Vercel AI SDK and Kernel's Playwright execution API.
|
|
||
| Every cookbook is self-contained: clone it, set your secrets, run. Use them as 1-click starts for your agents or as templates for your own automations. | ||
|
|
||
| import { CookbookSearch } from '/snippets/cookbook-search.jsx'; |
There was a problem hiding this comment.
Risk assessment: Low
Verdict: Low risk. Re-evaluated after 287b9e9 (copy edit on cookbooks.mdx). Risk did not increase. Prior approval stands; not re-approving.
What changed (from the diff)
- New docs tab and landing page (
docs.json,cookbooks.mdx) cataloguing 16 cookbooks as cards that link out togithub.com/kernel/cookbooks. - 16 stub MDX pages under
cookbooks/whose only content is title + externalurlfrontmatter. - Card images under
images/cookbooks/. - Tip/link updates on existing integration pages and a changelog URL rewrite from absorbed repo paths to
kernel/cookbooks. - Client-side search snippet (
snippets/cookbook-search.jsx) that filters existing cards bytextContentand togglesstyle.display. - Scoped CSS: hide pagination links whose
hrefstarts with/cookbooks/, plus.cookbook-tagstyling. - Latest commit vs prior approval: one intro sentence rewrite on
cookbooks.mdx. No new files, logic, or nav changes.
Why Low (not Very Low)
This is more than a typo or copy-only edit: it adds a new nav tab, a new interactive snippet, and CSS that hides pagination for cookbook routes. Those are easy to reason about but they are a real user-facing surface on the docs site.
Why not Medium+
- No auth, billing, permissions, APIs, or infrastructure.
- No production application logic; this repo is a Mintlify docs site.
- Search uses the query only for string matching (
includes) and does not inject user input as HTML or make network calls. - CSS and navigation changes are limited to the new Cookbooks surface.
- No CODEOWNERS file and no code-owner review requirement found.
Approval is not revoked. If later commits expand beyond docs/nav/UI (for example CI, secrets, or site-wide behavior), this approval must be re-evaluated.
Sent by Cursor Automation: Assign PR reviewers
2 participants
Adds a Cookbooks tab to the docs, cataloguing all 16 recipes in kernel/cookbooks. Related to the strawman in #525 — built as a separate take from main; happy to reconcile whichever direction wins.
Note
Low Risk
Documentation and front-end-only docs UI changes with no API, auth, or runtime product impact.
Overview
Adds a new Cookbooks docs tab that catalogs all 16 recipes in
kernel/cookbooks, with a searchable card grid oncookbooks.mdxand sidebar stubs (cookbooks/*.mdx) that redirect viaurlfrontmatter to GitHub.Navigation is wired in
docs.jsonunder Features and Integrations groups. A smallCookbookSearchReact snippet filters cards client-side;style.csshides misleading pagination on external cookbook routes and styles category tags.Several integration guides (Browser Use, Claude computer use, Managed Agents, Stagehand, AI SDK, Vibium) now include Tip blocks pointing at the matching cookbook. The changelog and Managed Agents doc update the Claude Managed Agents cookbook link from the old standalone repo to
kernel/cookbooks/tree/main/integrations/claude-managed-agents.Reviewed by Cursor Bugbot for commit 287b9e9. Bugbot is set up for automated code reviews on this repo. Configure here.