Official agent skill

Create Release Note

by DataDog in DataDog/datadog-agent

Create a reno release note for a PR or change. An agent skill from DataDog/datadog-agent.

OfficialApache-2.0Auto-check: notesDevelopment

Install Create Release Note

skills CLI
$ npx skills add DataDog/datadog-agent --skill create-release-note -a claude-code

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

GitHub CLI
$ gh skill install DataDog/datadog-agent create-release-note --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/DataDog/datadog-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/create-release-note .claude/skills/create-release-note && 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
GitHub stars
3.8k
Token cost
~1.4k tokens
SKILL.md length
634 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
Apache-2.0

At a glance

Create a reno release note for a PR or change. An agent skill from DataDog/datadog-agent.

  • Works in 4 steps: Gather information from the user → Create the release note file → Content formatting rules → …
  • Tasks that involve Changelog and release notes
  • SKILL.md covers Instructions, Section Guidelines, When to skip (use… and Usage
  • Calls pip and openssl

What it does

Create Release Note is an agent skill from DataDog/datadog-agent, published by the product's own GitHub organization. Create a reno release note for a PR or change

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Changelog and release notes. The repository describes itself as: Main repository for Datadog Agent. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Changelog and release notes

Example prompts

  • “/create-release-note”

Requirements

  • Python 3
  • Docker
  • Pre-approved tools (allowed-tools): Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Gather information from the user
  2. Create the release note file
  3. Content formatting rules
  4. Verify

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Edit
    • Glob
    • Grep
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip
    • openssl

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

  • Network

    Links to these hosts (documentation or services it may open):

    • datadoghq.dev

    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

Create Release Note loads about 1.4k tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 634 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion

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 DataDog/datadog-agent at commit a706f1a, republished under its Apache-2.0 licence (© DataDog). 634 words, ~1,399 tokens.

Download SKILL.mdSave it as .claude/skills/create-release-note/SKILL.md (or your agent's skills folder).
name
create-release-note
description
Create a reno release note for a PR or change
allowed-tools
Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
argument-hint
[topic]
model
sonnet

Create a release note file using the reno format. Release notes are mandatory for all PRs unless labeled changelog/no-changelog.

Instructions

Step 1: Gather information from the user

Use AskUserQuestion to collect the following. If $ARGUMENTS provides the topic, skip that question.

  1. Topic: A short kebab-case identifier for the change (e.g. fix-ntp-timeout, add-gpu-metrics). Used in the filename.

  2. Section: Which section does this change belong to?

    • features — New functionality (e.g. "Add support for GPU metrics collection")
    • enhancements — Small improvements to existing features (e.g. "Improve log rotation performance")
    • fixes — Bug fixes (e.g. "Fix memory leak in forwarder")
    • deprecations — Deprecation notices (e.g. "Deprecate log_enabled in favor of logs_enabled")
    • upgrade — Breaking changes requiring user action (must include steps for users to identify if affected)
    • security — Security fixes or improvements
    • issues — Known issues or limitations
    • other — Miscellaneous (rarely used)
  3. Content: A user-facing description of the change. This is read by customers, not developers. Ask the user to describe what changed and why.

  4. Target: Which release notes directory?

    • releasenotes/notes/ — Main agent (default, most common)
    • releasenotes-dca/notes/ — Cluster Agent (DCA)
  5. APM-related?: If the change affects cmd/trace-agent or pkg/trace, the content must be prefixed with APM : and the topic should be prefixed with apm-.

Step 2: Create the release note file

Generate the file using reno:

bash
reno new <topic> --no-edit

Or for non-default directories:

bash
reno --rel-notes-dir <directory> new <topic> --no-edit

This creates a file at <directory>/notes/<topic>-<hash>.yaml with a template.

Always create the file with reno. The <hash> suffix is reno's unique note ID — it must be a real, unique 16-character hex string that reno generates for you. Never hand-write a placeholder like a1b2c3d4e5f6a7b8 or any sequential/guessed value: reno treats the suffix as the note's UID and fails release-note-check with a "UID collision" when two notes share one (this placeholder has broken main more than once).

If reno is not installed, install it rather than creating the file by hand: pip install reno (see the contributing guide). Only if you genuinely cannot install it, generate a real random suffix with openssl rand -hex 8 and name the file <topic>-<hash>.yaml — never a placeholder.

Then replace the template content with only the relevant section. Remove all unused sections (don't leave them commented out — reno template comments are noisy).

Final file format:

yaml
---
<section>:
  - |
    Description of the change written for end users.
    Can span multiple lines.
Show full SKILL.md (292 more words)Show less
Step 3: Content formatting rules

Release note content must follow these rules:

  1. ReStructuredText (RST) format, NOT Markdown:

    • Links: `link text <https://example.com>`_ (NOT [text](url))
    • Bold: **text**
    • Inline code: ``code`` (double backticks, NOT single)
    • Code blocks: use .. code-block:: <lang> directive
  2. User-facing language: Write for Datadog customers, not developers. Describe the impact, not the implementation.

  3. Self-contained: Each note must be readable independently. Don't reference other release notes.

  4. For APM changes: Prefix with APM : (e.g. APM : Fix trace sampling rate calculation).

  5. Multiple items: Use separate list items in the same section:

    yaml
    fixes:
      - |
        Fix memory leak when collecting Docker container metrics.
      - |
        Fix panic in log agent when file is rotated during read.
Step 4: Verify

Run the release note linter to validate:

bash
dda inv linter.releasenote

This checks:

  • Valid YAML structure
  • Only known sections are used
  • No empty items
  • Valid RST formatting (no Markdown patterns)
  • No Markdown links [text](url), headers #, or single-backtick code

If linting fails, fix the issues and re-run.

Section Guidelines

SectionWhen to useExample
featuresWholly new capabilities"Add Windows support for the Process Agent"
enhancementsImprovements too small to be features"Add PDH data to Windows flare"
fixesBug fixes"Fix EC2 tags collection with multiple marketplaces"
deprecationsDeprecation notices"The log_enabled config option is deprecated, use logs_enabled"
upgradeBreaking changes needing user action"The --config flag format has changed. Users must update..."
securitySecurity fixes"Enforce bearer token authentication for API endpoints"
issuesKnown issues"Kubernetes 1.3 is not fully supported in this release"
otherMisc (rarely used)"Update internal CI tooling"

When to skip (use changelog/no-changelog label)

  • Documentation-only changes
  • Test-only changes
  • CI/CD configuration changes
  • Code comment changes
  • Developer tooling changes that don't affect the agent binary

Usage

  • /create-release-note — Interactive: prompts for all details
  • /create-release-note fix-ntp-timeout — Pre-fills the topic

© DataDog, 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

Just SKILL.md in .agents/skills/create-release-note of DataDog/datadog-agent.

Open the folder on GitHubat commit a706f1a

Compare with similar skills

Create Release Note 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Create Release Note this skillDataDog/datadog-agent3.8k—~1.4kAutomated safety check: NotesApache-2.0
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
StarRocks Release NotesStarRocks/starrocks12k—~1.9kAutomated safety check: NotesApache-2.0
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
Mole CLI Release Flowtw93/Mole70k—~2.6kAutomated safety check: PassGPL-3.0

Similar skills

  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • StarRocks Release Notes

    StarRocks/starrocks

    Drafts English release notes for a StarRocks patch release from the PRs merged into its release branch, then opens a documentation PR and hands translation to /translate.

    12k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check: notes
  • 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
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k 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.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Release

    PrefectHQ/fastmcp

    Cut a FastMCP release end to end. An agent skill from PrefectHQ/fastmcp.

    28k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed

More from DataDog/datadog-agent

All 35 skills in this repo
  • Triage CI Failure

    DataDog/datadog-agent

    Official

    Classify a failed CI as either caused by an active incident, flakiness, or a true code regression.

    3.8k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Elicit

    DataDog/datadog-agent

    Official

    Run a structured discovery session to build an Allium specification through conversation.

    3.8k GitHub starsUsed in 1 repo~3.7k tokens
    Auto-check passed
  • Follow PR

    DataDog/datadog-agent

    Official

    Monitor the current PR's GitLab pipeline to completion, then report success, auto-fix, or investigate a failure.

    3.8k GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Create Epic Recap

    DataDog/datadog-agent

    Official

    A skill your agent uses when an engineer or manager asks to recap, summarize, or post an update on a Jira Epic — a progress update for an in-progress Epic (how far along it is, what's shipped so…

    3.8k GitHub stars~5k tokensUpdated today
    Auto-check: notes
  • Explain Lading Config

    DataDog/datadog-agent

    Official

    Explains a lading.yaml config file from the regression test suite, using the lading Rust source as ground truth for field meanings and defaults.

    3.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Distill

    DataDog/datadog-agent

    Official

    Extract an Allium specification from an existing codebase. An agent skill from DataDog/datadog-agent.

    3.8k GitHub starsUsed in 1 repo~7k tokens
    Auto-check passed

Categories

Questions about Create Release Note

What does Create Release Note do?

Create a reno release note for a PR or change. An agent skill from DataDog/datadog-agent. Create Release Note is an agent skill from DataDog/datadog-agent, published by the product's own GitHub organization.

When should I use Create Release Note?

Create Release Note fits situations like: tasks that involve Changelog and release notes.

How do I install Create Release Note in Claude Code?

Run `npx skills add DataDog/datadog-agent --skill create-release-note -a claude-code`. Or copy the skill folder (.agents/skills/create-release-note in DataDog/datadog-agent) into .claude/skills/create-release-note in your project. Claude Code loads it when a task matches its description.

How do I install Create Release Note in Codex?

Run `npx skills add DataDog/datadog-agent --skill create-release-note -a codex`. Or copy the skill folder (.agents/skills/create-release-note in DataDog/datadog-agent) into .agents/skills/create-release-note in your project. Codex loads it when a task matches its description.

Can I use Create Release Note 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 DataDog/datadog-agent --skill create-release-note -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, .gemini/skills/create-release-note, .github/skills/create-release-note and .opencode/skills/create-release-note in your project.

What does Create Release Note need to run?

Going by SKILL.md and its folder, Create Release Note needs the command-line tools its instructions call (pip and openssl). Our summary lists: Python 3; Docker. Its frontmatter pre-approves these tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion.

Does Create Release Note access the network?

SKILL.md names 1 domain. As links in the text: datadoghq.dev. This is read from the text; nothing was executed.

Is Create Release Note safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Create Release Note use?

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

About 1.4k tokens (SKILL.md is roughly 5.6k 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?

Skills that share tags, products or a category with Create Release Note: Simple English (moeru-ai/airi, 50k stars), StarRocks Release Notes (StarRocks/starrocks, 12k stars), Cutting A Release (TriliumNext/Trilium, 38k stars) and React Router Release Notes Prep (remix-run/react-router, 57k 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?

DataDog (a GitHub organization, an official publisher) maintains it in DataDog/datadog-agent, which has 3,759 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 9, 2026.

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