Official agent skill

Create Release Note Doc PR

by kubernetes-sigs in kubernetes-sigs/cloud-provider-azure

Generate or update the documentation-site release note for a given tag, commit it on a branch, push it to a writable remote, and open a GitHub PR to the docs branch.

OfficialApache-2.0Auto-check passedDevelopment

Install Create Release Note Doc PR

skills CLI
$ npx skills add kubernetes-sigs/cloud-provider-azure --skill create-release-note-doc-pr -a claude-code

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

GitHub CLI
$ gh skill install kubernetes-sigs/cloud-provider-azure create-release-note-doc-pr --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/kubernetes-sigs/cloud-provider-azure.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/create-release-note-doc-pr .claude/skills/create-release-note-doc-pr && 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
create-release-note-doc-pr
GitHub stars
294
Token cost
~768 tokens
SKILL.md length
323 words
Files
2 (incl. scripts)
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Generate or update the documentation-site release note for a given tag, commit it on a branch, push it to a writable remote, and open a GitHub PR to the docs branch.

  • Works in 8 steps: Resolves remotes, repo, and owner… → Resolves GitHub credentials from… → Checks whether an open PR already exists… → …
  • The user wants to create
  • SKILL.md covers Overview, Quick Start, Requirements and What It Does, plus 3 more sections
  • Runs Python scripts from its folder; calls gh and python3; needs GITHUB_TOKEN and GH_TOKEN

What it does

Create Release Note Doc PR is an agent skill from kubernetes-sigs/cloud-provider-azure, published by the product's own GitHub organization. Generate or update the documentation-site release note for a given tag, commit it on a branch, push it to a writable remote, and open a GitHub PR to the docs branch. Use when the user wants to create or update release notes, generate a changelog for a tag, or mentions release notes, docs PR, or documentation for a release.

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/create_release_note_doc_pr.py`).

It sits in Development, covering Changelog and release notes. It works with Kubernetes and GitHub. The repository describes itself as: Cloud provider for Azure. The licence is Apache-2.0.

When your agent uses it

  • The user wants to create
  • Update release notes
  • Generate a changelog for a tag
  • Mentions release notes

Example prompts

  • “/create-release-note-doc-pr”

Requirements

  • Python 3
  • A credential in GITHUB_TOKEN

Workflow steps

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

  1. Resolves remotes, repo, and owner defaults for a fork-to-upstream workflow
  2. Resolves GitHub credentials from environment variables or gh auth token
  3. Checks whether an open PR already exists for the branch
  4. Fetches the base branch and creates doc/release-note- from it
  5. Runs ./hack/generate-release-note.sh true by default
  6. Validates the generated docs content before commit
  7. Commits only content/en/blog/releases/.md, pushes the branch, and
  8. Restores the original branch after completion

What it can do on your machine

Read from SKILL.md and the folder at commit bac9134. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • gh
    • python3

    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 these keys or tokens, usually read from environment variables:

    • GITHUB_TOKEN
    • GH_TOKEN

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

Context cost

Create Release Note Doc PR loads about 768 tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 323 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from kubernetes-sigs/cloud-provider-azure at commit bac9134, republished under its Apache-2.0 licence (© kubernetes-sigs). 323 words, ~768 tokens.

Download SKILL.mdSave it as .claude/skills/create-release-note-doc-pr/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
create-release-note-doc-pr
description
Generate or update the documentation-site release note for a given tag, commit it on a branch, push it to a writable remote, and open a GitHub PR to the docs branch. Use when the user wants to create or update release notes, generate a changelog for a tag, or mentions release notes, docs PR, or documentation for a release.

Release Note Docs PR

Overview

Turn a release tag such as v1.35.7 into an updated docs-site release note and open a PR targeting the documentation branch.

Quick Start

Replace <SKILL_DIR> with the path of this skill directory.

bash
python3 <SKILL_DIR>/scripts/create_release_note_doc_pr.py --tag v1.35.7

Requirements

  • Clean git working tree
  • gh CLI installed and authenticated
  • GitHub token available through GITHUB_TOKEN, GH_TOKEN, or gh auth token

Default remote behavior:

  • Base remote defaults to upstream when it has the docs branch; otherwise origin
  • Push remote defaults to origin
  • PR target repo and head owner are derived from the selected remotes unless overridden

What It Does

  1. Resolves remotes, repo, and owner defaults for a fork-to-upstream workflow
  2. Resolves GitHub credentials from environment variables or gh auth token
  3. Checks whether an open PR already exists for the branch
  4. Fetches the base branch and creates doc/release-note-<tag> from it
  5. Runs ./hack/generate-release-note.sh <tag> <temp-output> true by default
  6. Validates the generated docs content before commit
  7. Commits only content/en/blog/releases/<tag>.md, pushes the branch, and opens a PR with labels kind/documentation and release-note-none
  8. Restores the original branch after completion

Script Usage

bash
python3 <SKILL_DIR>/scripts/create_release_note_doc_pr.py \
  --tag <vX.Y.Z> [--no-generate] [--dry-run] [--force-push] \
  [--base-remote <name>] [--push-remote <name>] [--base-branch <name>] \
  [--target-repo <owner/repo>] [--head-owner <owner>]

Common flags:

  • --no-generate: Skip hack/generate-release-note.sh when the file is already updated
  • --dry-run: Print commands without executing them
  • --force-push: Push with --force-with-lease
  • --base-remote: Override the remote used for the base branch
  • --push-remote: Override the remote used to push the branch
  • --base-branch: Override the docs base branch, default documentation
  • --target-repo: Set the PR target repo explicitly
  • --head-owner: Set the PR head owner explicitly

Error Handling

If the script or any command fails, do not make up new scripts to work around the error and do not fabricate or guess at content. Instead, report the failure and exact error message to the user and let them decide how to proceed.

Troubleshooting

  • If repo or owner detection is wrong, pass --target-repo and --head-owner explicitly
  • If token resolution fails, export GITHUB_TOKEN or GH_TOKEN, or run gh auth login
  • If the generated file is empty or malformed, rerun without --no-generate

© kubernetes-sigs, 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 (scripts) in .agents/skills/create-release-note-doc-pr of kubernetes-sigs/cloud-provider-azure.

  • SKILL.md
  • scripts/create_release_note_doc_pr.py

Open the folder on GitHubat commit bac9134

Compare with similar skills

Create Release Note Doc PR 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.

Create Release Note Doc PR compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Create Release Note Doc PR this skillkubernetes-sigs/cloud-provider-azure294—~768Automated safety check: PassApache-2.0
Mariadb Operator Release Notesmariadb-operator/mariadb-operator1k—~3.3kAutomated safety check: PassApache-2.0
Lade Releasezifeo/lade133—~749Automated safety check: PassMPL-2.0
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
Mole CLI Release Flowtw93/Mole70k—~2.5kAutomated safety check: PassGPL-3.0
Draft Release Notesjamiepine/voicebox57k—~941Automated safety check: PassMIT

Similar skills

  • Mariadb Operator Release Notes

    mariadb-operator/mariadb-operator

    Create the release notes and upgrade guide for a mariadb-operator release.

    1k GitHub stars~3.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Lade Release

    zifeo/lade

    Prepare a Lade release: update CHANGELOG.md and bump crate versions with cargo set-version.

    133 GitHub stars~749 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Cutting A Release

    TriliumNext/Trilium

    A skill your agent uses when cutting, preparing, or debugging a Trilium release — bumping the monorepo version, tagging, or diagnosing a failed "Release" workflow run.

    38k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Draft Release Notes

    jamiepine/voicebox

    Writes or refreshes the Unreleased section of CHANGELOG.md as a themed narrative built from the commits, PRs and diff since the last version tag.

    57k GitHub stars~941 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Publishes curated, bilingual release notes for an existing Mole version tag with gh release edit, including contributor thanks and reactions, after the release workflow finishes.

    70k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed

More from kubernetes-sigs/cloud-provider-azure

All 12 skills in this repo
  • Run E2E Test

    kubernetes-sigs/cloud-provider-azure

    Official

    Parse a Go e2e test from tests/e2e/, translate each step to kubectl and az CLI commands, and interactively replay the test against a live cluster.

    294 GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Build Images

    kubernetes-sigs/cloud-provider-azure

    Official

    Build cloud-provider-azure container images through the repo Makefile with explicit IMAGETAG and IMAGEREGISTRY inputs, optional make flag overrides, and opt-in bounded Docker or Podman retries.

    294 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Cherry Pick PR

    kubernetes-sigs/cloud-provider-azure

    Official

    Cherry-pick a merged pull request onto a release branch with Prow-style branch naming, manual conflict resolution, targeted validation, and GitHub PR creation.

    294 GitHub stars~636 tokensUpdated today
    Auto-check passed
  • Create Release Tags

    kubernetes-sigs/cloud-provider-azure

    Official

    Create and optionally push the next Kubernetes-style release tag (vX.Y.Z) from a release-X.Y branch by resolving the remote branch tip, computing the next patch tag, and tagging the commit directly…

    294 GitHub stars~574 tokensUpdated today
    Auto-check passed
  • Cve Remediator V2

    kubernetes-sigs/cloud-provider-azure

    Official

    Raise Go modules to caller-supplied minimum fixed versions from CVE/GO findings in any format, per tracked module root, sync go.mod/go.sum and root vendor/, audit the source module graphs, run the…

    294 GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Debug E2E Pipeline

    kubernetes-sigs/cloud-provider-azure

    Official

    Fetch and analyze Prow e2e pipeline failures for cloud-provider-azure.

    294 GitHub stars~3.4k tokensUpdated today
    Auto-check passed

Categories

Questions about Create Release Note Doc PR

What does Create Release Note Doc PR do?

Generate or update the documentation-site release note for a given tag, commit it on a branch, push it to a writable remote, and open a GitHub PR to the docs branch. Create Release Note Doc PR is an agent skill from kubernetes-sigs/cloud-provider-azure, published by the product's own GitHub organization. Generate or update the documentation-site release note for a given tag, commit it on a branch, push it to a writable remote, and open a GitHub PR to the docs branch.

When should I use Create Release Note Doc PR?

Create Release Note Doc PR fits situations like: the user wants to create; update release notes; generate a changelog for a tag; mentions release notes.

How do I install Create Release Note Doc PR in Claude Code?

Run `npx skills add kubernetes-sigs/cloud-provider-azure --skill create-release-note-doc-pr -a claude-code`. Or copy the skill folder (.agents/skills/create-release-note-doc-pr in kubernetes-sigs/cloud-provider-azure) into .claude/skills/create-release-note-doc-pr in your project. Claude Code loads it when a task matches its description.

How do I install Create Release Note Doc PR in Codex?

Run `npx skills add kubernetes-sigs/cloud-provider-azure --skill create-release-note-doc-pr -a codex`. Or copy the skill folder (.agents/skills/create-release-note-doc-pr in kubernetes-sigs/cloud-provider-azure) into .agents/skills/create-release-note-doc-pr in your project. Codex loads it when a task matches its description.

Can I use Create Release Note Doc PR 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 kubernetes-sigs/cloud-provider-azure --skill create-release-note-doc-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-release-note-doc-pr, .gemini/skills/create-release-note-doc-pr, .github/skills/create-release-note-doc-pr and .opencode/skills/create-release-note-doc-pr in your project.

What does Create Release Note Doc PR need to run?

Going by SKILL.md and its folder, Create Release Note Doc PR needs Python for the scripts in its folder, the command-line tools its instructions call (gh and python3) and credentials named GITHUB_TOKEN and GH_TOKEN. Our summary lists: Python 3; A credential in GITHUB_TOKEN.

Does Create Release Note Doc PR 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 Create Release Note Doc PR 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Create Release Note Doc PR use?

Create Release Note Doc PR 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 Create Release Note Doc PR use?

About 768 tokens (SKILL.md is roughly 3.1k 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 Create Release Note Doc PR?

Skills that share tags, products or a category with Create Release Note Doc PR: Mariadb Operator Release Notes (mariadb-operator/mariadb-operator, 1k stars), Lade Release (zifeo/lade, 133 stars), Cutting A Release (TriliumNext/Trilium, 38k stars) and Mole CLI Release Flow (tw93/Mole, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Create Release Note Doc PR?

kubernetes-sigs (a GitHub organization, an official publisher) maintains it in kubernetes-sigs/cloud-provider-azure, which has 294 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 8, 2026.

Source: kubernetes-sigs/cloud-provider-azure on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.