cookbook-add-model

Adds a new model page to the SGLang Cookbook docs using config-driven templates.

33.0k|8.4k|Updated Jan 8, 2024
One-click install
npx skills add https://github.com/sgl-project/sglang --skill cookbook-add-model
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cookbook-add-model
Source: https://github.com/sgl-project/sglang/tree/main/.claude/skills/cookbook-add-model
Command: npx skills add https://github.com/sgl-project/sglang --skill cookbook-add-model

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Adding a new model to the SGLang Cookbook documentation requires coordinated edits across many files — a per-model JSX config, benchmarks data, an MDX page, docs.json navigation, NEW-tag hygiene, and homepage vendor cards — and doing this by hand is error-prone and inconsistent.

Core Features & Use Cases

  • Template instantiation: Copies model-agnostic templates (config.jsx, benchmarks.jsx, page.mdx) into per-model files and replaces all __TOKEN__ placeholders with verified model data.
  • Verified deployment matrix: Builds the 5-dimension cells[] matrix (hardware × variant × quantization × strategy × nodes) from tested sglang serve recipes, with TP sizing sanity checks and platform-specific flags for NVIDIA and AMD GPUs.
  • Site wiring and validation: Updates docs.json navigation, enforces one NEW tag per vendor directory, creates homepage vendor cards and logos, then validates with mint validate, mint broken-links, and check_cookbook_configs.mjs.
  • Use Case: When SGLang adds day-0 support for a new model like DeepSeek-V4, use this Skill to generate the complete cookbook page with deployment matrix, playground config, benchmarks, and prose, then open a PR.

Quick Start

Ask the assistant to add a new model to the SGLang Cookbook by providing the model's HuggingFace repo URL and its tested hardware and launch recipes.

Frequently Asked Questions about cookbook-add-model

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new model to the SGLang Cookbook docs?

Run the cookbook-add-model skill with the model's HuggingFace URL, tested hardware, and verified launch recipes. It instantiates the config, benchmarks, and MDX templates, wires docs.json navigation and the homepage card, then validates with mint validate before opening a PR.

What files are created when adding an SGLang cookbook model page?

Three files are created from templates: a per-model config JSX under docs/src/snippets/configs/<hf-org>/, an optional benchmarks JSX file, and an MDX page under docs/cookbook/<category>/<Vendor>/. The skill also edits docs.json and the category intro.mdx homepage card.

Does the SGLang cookbook support AMD GPUs like MI300X?

Yes, the deployment matrix supports AMD platforms including MI300X, MI325X, MI350X, and MI355X with ROCm Docker images. AMD recipes typically need --attention-backend triton and env vars like SGLANG_USE_AITER=1, with EP equal to TP for MoE models.

How do I migrate an existing legacy SGLang cookbook page?

Use the cookbook-migrate-model skill instead of this one. It targets the same config-driven format but treats the existing legacy page, rather than user input, as the source of truth for recipes and data.

Why does my cookbook config crash with ReferenceError in Mintlify?

Mintlify re-evaluates the config export at hydration with module-level identifiers out of scope, so the config must be a single export const literal. Function calls, spreads, fragment refs, and IIFEs all crash; keep cells denormalized with flat literal env and flags arrays.

When should I not add a deployment cell to the matrix?

Only add a cell for a hardware-variant-quantization-strategy-nodes combination that has a tested or sanity-checked recipe. The engine automatically greys out unlisted combinations, so premature or invented cells should be avoided.