Official agent skill

Curate Whats New

by docker in docker/docs

Curate noteworthy Docker launches from documentation pull requests merged during a requested period.

OfficialApache-2.0Auto-check passedDevelopment

Install Curate Whats New

skills CLI
$ npx skills add docker/docs --skill curate-whats-new -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install docker/docs curate-whats-new --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/docker/docs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/curate-whats-new .claude/skills/curate-whats-new && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
curate-whats-new
GitHub stars
4.7k
Token cost
~1.3k tokens
SKILL.md length
688 words
Files
2
Skills in repo
13
Repo updated
First seen
Licence
Apache-2.0

At a glance

Curate noteworthy Docker launches from documentation pull requests merged during a requested period.

  • Works in 8 steps: Read data/whats-new.json. → Determine the review mode from the request → List PRs in the range that applies to… → …
  • Reviewing data/whats-new.json
  • SKILL.md covers Exclusions, Select highlights and Procedure
  • Calls gh

What it does

Curate Whats New is an agent skill from docker/docs, published by the product's own GitHub organization. Curate noteworthy Docker launches from documentation pull requests merged during a requested period. Use when generating or reviewing data/whats-new.json, preparing the Docker Docs What's new timeline, or deciding which documented releases merit Docker-wide highlights.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development, covering Changelog and release notes, Containers and Pull requests. It works with Docker. The repository describes itself as: Source repo for Docker's Documentation. The licence is Apache-2.0.

When your agent uses it

  • Reviewing data/whats-new.json
  • Preparing the Docker Docs Whats new timeline
  • Deciding which documented releases merit Docker-wide highlights

Example prompts

  • “/curate-whats-new”

Requirements

  • Docker

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Read data/whats-new.json.
  2. Determine the review mode from the request
  3. List PRs in the range that applies to the review mode
  4. Inspect the diff and resulting pages for every plausible new candidate.
  5. Decide what qualifies using only evidence in the merged documentation.
  6. Remove existing items published before the requested publication window.
  7. Replace period_start, period_end, and items in
  8. Report the curation outcome in the response

What it can do on your machine

Read from SKILL.md and the folder at commit 8582516. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Curate Whats New loads about 1.3k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 688 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from docker/docs at commit 8582516, republished under its Apache-2.0 licence (© docker). 688 words, ~1,295 tokens.

Download SKILL.mdSave it as .claude/skills/curate-whats-new/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
curate-whats-new
description
Curate noteworthy Docker launches from documentation pull requests merged during a requested period. Use when generating or reviewing data/whats-new.json, preparing the Docker Docs What's new timeline, or deciding which documented releases merit Docker-wide highlights.

Curate What's New

Treat merged documentation as evidence that a capability shipped, but do not treat a documentation change as news by itself.

Include an item only when the merged documentation directly shows all of the following:

  • A released user-facing feature, material enhancement, or broader availability milestone that was not available before the period
  • A substantial capability or workflow, not new syntax or a small control within an existing workflow
  • Enough Docker-wide editorial significance to merit proactively telling users about it outside product release notes
  • A useful published page and a factual title and description

Apply a high bar. The result is a curated launch archive, not a complete changelog. A specialized feature can qualify when its user impact is substantial. A quiet period can produce few or no items.

Exclusions

Exclude documentation maintenance; fixes; rewrites; guidance for old behavior; routine release or generated-content syncs; limitations, prerequisites, and workarounds; narrow flags, settings, command variants, protocols, and compatibility changes; incremental UI, safety, permissions, or observability improvements; and lower-level Engine, Build, networking, or storage changes. These qualify only when they are part of an independently newsworthy product-level launch.

Judge the user outcome, not PR size, product popularity, labels, changed lines, a dedicated page, or the existence of a new API or command.

Select highlights

Include every qualifying launch; do not impose a quota. Mark the five most important as featured: true, or all items when fewer than five qualify. Rank by the magnitude and distinctness of the user outcome and the value of helping its audience discover it. Breadth can matter, but a major capability for a specialized audience can outrank a smaller change for a broad audience. Recency and product variety are not ranking goals.

Create one item per launch and combine PRs that document the same launch. Preserve existing copy while it remains accurate and qualifies. Change featured status only when the relative importance of the candidate set changes.

Show full SKILL.md (381 more words)Show less

Procedure

  1. Read data/whats-new.json.

  2. Determine the review mode from the request:

    • If the request does not specify a publication window, end it on the previous UTC day and start it 29 days earlier.
    • For an incremental review, list PRs merged from the day after the supplied checkpoint through the end of the publication window. Retain existing items inside the publication window without re-reviewing their source PRs. If the request does not supply a checkpoint, use the existing period_end from data/whats-new.json.
    • For a full review, inspect every PR merged in the supplied publication window.
  3. List PRs in the range that applies to the review mode:

    console
    $ gh pr list --repo docker/docs --state merged --search 'merged:START..END' --limit 200

    If an incremental search returns no PRs, skip candidate inspection and only remove expired items.

  4. Inspect the diff and resulting pages for every plausible new candidate.

  5. Decide what qualifies using only evidence in the merged documentation.

  6. Remove existing items published before the requested publication window. Add newly qualifying launches, combine related PRs, and reconsider featured status across the resulting list. Do not replace or rewrite retained items merely because they were not part of the incremental candidate range.

  7. Replace period_start, period_end, and items in data/whats-new.json. Sort items by published date, newest first.

  8. Report the curation outcome in the response:

    • Enumerate every newly selected entry by product, title, and source PRs.
    • Summarize retained and expired entries by count. Identify any retained entry whose content or sources changed.
    • Explain only the most relevant plausible exclusions. Do not enumerate routine maintenance PRs that were never credible candidates.

If the request includes creating a pull request, use the same report in the PR body with ## Summary, ## Selected entries, and ## Curation notes sections. Put each selected entry on one Markdown bullet and reference PRs as #NNNN rather than full same-repository links. Do not hard-wrap bullets. Do not create .pr-body.md or another handoff file unless the request explicitly asks for one.

Each item must contain product, title, description, url, published, source_prs, and featured. Use the canonical product name, a published internal URL, the merge date in YYYY-MM-DD format, and source PR numbers.

Write factual, restrained copy. Avoid superlatives, promotional language, and claims about ease or importance. Do not modify tracked files other than data/whats-new.json.

© docker, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/curate-whats-new of docker/docs.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 8582516

Compare with similar skills

Curate Whats New next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Curate Whats New compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Curate Whats New this skilldocker/docs4.7k—~1.3kAutomated safety check: PassApache-2.0
ReleasePipelex/pipelex941—~4.8kAutomated safety check: NotesCustom licence
CI Act Runchewiebug/GCViewer4.6k—~2.4kAutomated safety check: NotesCustom licence
Review PRmicrosoft/vscode-containers141—~900Automated safety check: PassCustom licence
Project Docs Maintainerswimmwatch/cloakbrowser-mcp164—~569Automated safety check: PassMIT
Prepare Releasejpicklyk/task-orchestrator207—~5.3kAutomated safety check: PassMIT

Similar skills

  • Release

    Pipelex/pipelex

    Cut a release of pipelex, which ships the pipelex and pipelex-api packages and the pipelex/pipelex-api Docker image under one version: the gates, the migration-ledger cross-check, the CHANGELOG.md…

    941 GitHub stars~4.8k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • CI Act Run

    chewiebug/GCViewer

    Run the full build-and-deploy.yaml workflow locally via act + Docker.

    4.6k GitHub stars~2.4k tokensUpdated 3 mo ago
    DevelopmentAuto-check: notes
  • Review PR

    microsoft/vscode-containers

    Official

    Review a specific vscode-containers pull request on demand from the CLI (or any interactive agent), the way a Container Tools maintainer would.

    141 GitHub stars~900 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Project Docs Maintainer

    swimmwatch/cloakbrowser-mcp

    Maintain, organize, consolidate, or audit the cloakbrowser-mcp documentation set only when the user explicitly requests project documentation maintenance or an authorized public change requires it.

    164 GitHub stars~569 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Prepare Release

    jpicklyk/task-orchestrator

    End-to-end release automation — reads commits since last tag, infers semver bump, drafts changelog, creates release PR, merges it, waits for CI green, tags, and monitors the Docker build to…

    207 GitHub stars~5.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Code Review

    Azure/Azurite

    Official

    Review Azurite pull requests with service-aware checks for Blob, Queue, and Table behavior, API compatibility, tests, and release notes.

    2.3k GitHub stars~734 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from docker/docs

All 13 skills in this repo
  • Official

    Audit a documentation site for agent-friendliness: discovery, markdown delivery, crawlability, semantic structure, machine-readable surfaces, and content legibility.

    4.7k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Official

    Handle Hugo docs information-architecture moves: discover old vs new URLs, add front matter aliases (Phase 1), update in-repo links (Phase 2), interactive List 2 resolution and fragment validation…

    4.7k GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed
  • Write

    docker/docs

    Official

    Write or edit reader-facing technical prose for immediate comprehension.

    4.7k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Create Lab Guide

    docker/docs

    Official

    Clone a dockersamples Labspace repo, extract learning objectives and module structure from labspace.yaml, and produce a Hugo guide page under content/guides/ with correct frontmatter…

    4.7k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Fix Issue

    docker/docs

    Official

    Fix a single GitHub issue end-to-end: triage, research, write the fix, review, and create a PR.

    4.7k GitHub stars~595 tokensUpdated yesterday
    Auto-check passed
  • Maintain PR

    docker/docs

    Official

    Maintain and follow up on a single Docker documentation pull request that you own or are responsible for updating.

    4.7k GitHub stars~825 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Curate Whats New

What does Curate Whats New do?

Curate noteworthy Docker launches from documentation pull requests merged during a requested period. Curate Whats New is an agent skill from docker/docs, published by the product's own GitHub organization. Curate noteworthy Docker launches from documentation pull requests merged during a requested period.

When should I use Curate Whats New?

Curate Whats New fits situations like: reviewing data/whats-new.json; preparing the Docker Docs Whats new timeline; deciding which documented releases merit Docker-wide highlights.

How do I install Curate Whats New in Claude Code?

Run `npx skills add docker/docs --skill curate-whats-new -a claude-code`. Or copy the skill folder (.agents/skills/curate-whats-new in docker/docs) into .claude/skills/curate-whats-new in your project. Claude Code loads it when a task matches its description.

How do I install Curate Whats New in Codex?

Run `npx skills add docker/docs --skill curate-whats-new -a codex`. Or copy the skill folder (.agents/skills/curate-whats-new in docker/docs) into .agents/skills/curate-whats-new in your project. Codex loads it when a task matches its description.

Can I use Curate Whats New in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add docker/docs --skill curate-whats-new -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/curate-whats-new, .gemini/skills/curate-whats-new, .github/skills/curate-whats-new and .opencode/skills/curate-whats-new in your project.

What does Curate Whats New need to run?

Going by SKILL.md and its folder, Curate Whats New needs the command-line tools its instructions call (gh). Our summary lists: Docker.

Does Curate Whats New access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Curate Whats New safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Curate Whats New use?

Curate Whats New is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Curate Whats New use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Curate Whats New?

Skills that share tags, products or a category with Curate Whats New: Release (Pipelex/pipelex, 941 stars), CI Act Run (chewiebug/GCViewer, 4.6k stars), Review PR (microsoft/vscode-containers, 141 stars) and Project Docs Maintainer (swimmwatch/cloakbrowser-mcp, 164 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Curate Whats New?

docker (a GitHub organization, an official publisher) maintains it in docker/docs, which has 4,667 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 8, 2026.

Source: docker/docs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.