add-capsule
Produces a complete release capsule:
- Creates
models/<publisher>/<model>/<release_date>/with a README whose frontmatter matchescapsule.schema.json— including a Before You Begin section with pricing, release / expiry dates, model-card link, and a link tomodels/quickstart/. - Scaffolds one or more notebooks under
notebooks/following the pedagogy rules inplan.md§15:- Each notebook covers 1–3 concepts. If the release needs more,
the skill scaffolds additional notebooks (
01-…,02-…,03-…) rather than growing a single long notebook. The author declares the split up front via theconceptsprompt. - Every notebook is independently runnable — it repeats the Before You Begin + env-precheck cells at the top.
- Numbered, alternating markdown ↔ code sections so the Outline reads like a tutorial table of contents. Section titles are verbs (e.g. "Send a chat request", "Attach an image").
## 1. Before You Begin(markdown) — pricing, dates, model card, link tomodels/quickstart/.## 2. Verify your environment(code) — env precheck against the vars listed inmodels/quickstart/README.mdfrontmatter (required_env).- Content sections
3..N-2alternating markdown/code. ## N-1. Your Turn to Explore(markdown + empty code cell) — required. Suggests 2–3 concrete directions without solutions.## N. Summary(markdown) — required. What was covered, when to reach for this model, links to primers and glossary terms.## N+1. References(markdown) — required. A bulleted list of the author-supplied references, written directly as markdown (- [title](url) — note). References are body content, not frontmatter. If the author supplied none, the scaffold prints a TODO reminder rather than silently omitting the section.- Voice: action-focused, no hype/marketing language.
- Each notebook covers 1–3 concepts. If the release needs more,
the skill scaffolds additional notebooks (
- Appends any capsule-specific
dependenciesunder the# Capsule dependenciessection ofrequirements-dev.txt. - Prepends (or updates in place) a row in
CHANGELOG.md, in the table under the## <Month> <Year>heading for its release date — creating that heading and a table header when the month is new. Column shape:Date | Publisher | Model | Capabilities— exactly four cells. The Date cell is a markdown link to the announcement URL (there is no separate Announcement column). The Model cell is a markdown link to the model card when known — no separate Model card column either. The Publisher cell links to that publisher's filtered view in the Foundry catalog. Pricing is not a column: rates go stale silently, so price lives on the model card the capsule links to. If an announcement-only row already exists for the same Date + Model, the skill updates it in place — adding any newly known fields — instead of duplicating. - Adds a members-table row to
models/<publisher>/README.md. - Regenerates
CAPSULE-TOC.md,catalog.json,llms.txt, and the repo README capsule block by runningpython scripts/generate-catalog.py. These are generated from frontmatter - never hand-edit them. The capsule's row appears under its publisher's## <Provider>heading automatically; the generator creates that heading when the publisher has no capsules yet. - Invokes
refresh-recent-activityso the repo README's Recently added table (Model / Release date / Capabilities) stays current.