open-supply-hub: Skill for Claude Code

.agent/skills/release-notes/SKILL.md

release-notes is a skill for Claude Code, Codex from opensupplyhub/open-supply-hub. It costs 44 tokens per session (962 once invoked), scanned A, original, MIT.

A release-notes writing workflow for adding entries to doc/release/RELEASE-NOTES.md. Release notes are a record of user-visible changes and other important updates in a software release.

In plain words
What is it for?
Use it to prepare a new release entry from git history, determine the version change, and document features, fixes, migrations, and required commands.
Why use it?
It provides a consistent format and helps ensure the entry reflects the actual commits, file changes, fixes, and deployment steps.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

This is opensupplyhub/open-supply-hub's own configuration. It tells Claude Code and Codex how to work on open-supply-hub itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything open-supply-hub configures →

Reuse

Borrowing it

Nothing to install: this file belongs to opensupplyhub/open-supply-hub. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/opensupplyhub/open-supply-hub/main/.agent/skills/release-notes/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/opensupplyhub/open-supply-hub

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for release-notes

README.md
[![agentmods](https://agentmods.dev/badge/skills/opensupplyhub/open-supply-hub/release-notes.svg)](https://agentmods.dev/skills/opensupplyhub/open-supply-hub/release-notes)
Your own site
<a href="https://agentmods.dev/skills/opensupplyhub/open-supply-hub/release-notes"><img src="https://agentmods.dev/badge/skills/opensupplyhub/open-supply-hub/release-notes.svg" alt="Measured on agentmods" height="20"></a>
Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 962 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00044 $0.00962
Opus 5 $0.00022 $0.00481
Sonnet 5 $0.00009 $0.00192
Haiku 4.5 $0.00004 $0.00096

Measured 8d ago against content hash 3518d0712389, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

release-notes scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agent/skills/release-notes/SKILL.md · 100 lines

What it actually says

Writing Release Notes

Gathering Context

Before writing the note, run these commands in parallel to understand the full scope of changes:

  • git log --oneline <base-branch>..HEAD
  • git diff <base-branch>..HEAD --stat
  • git diff <base-branch>..HEAD
  • git log <base-branch>..HEAD --format="%B---"

File Location

  • Release notes: doc/release/RELEASE-NOTES.md
  • Template: doc/release/RELEASE-NOTES-TEMPLATE.md

New entries go at the top of the file, directly after the header block (lines 1–4).

Steps

  1. Read the current release notes (doc/release/RELEASE-NOTES.md) to find the latest version number and the structure of existing entries before writing anything.
  2. Determine the new version using semver:
    • Major feature release → bump minor (e.g. 2.19.02.20.0)
    • Hotfix → bump patch (e.g. 2.18.02.18.1)
  3. Gather changes — ask the user for, or derive from git log / PR history:
    • New migrations and schema changes
    • Code/API changes
    • Architecture/environment changes
    • Bug fixes
    • New user-facing features
    • Required post-deployment commands
  4. Write the entry following the format below.
  5. Make them concise - each bullet should include only the most important information, avoiding unnecessary details.
  6. Update the RELEASE-NOTES.md file with the new entry.

Entry Format

## Release X.Y.Z

## Introduction

- Product name: Open Supply Hub
- Release date: _Provide release date_

### Database changes

#### Migrations

- <filename>.py - <What the migration does>.

#### Schema changes

- [OSDEV-XXXX](https://opensupplyhub.atlassian.net/browse/OSDEV-XXXX) - <Describe model/table changes>.

### Code/API changes

- [OSDEV-XXXX](https://opensupplyhub.atlassian.net/browse/OSDEV-XXXX) - <Describe code or API changes>.

### Architecture/Environment changes

- [OSDEV-XXXX](https://opensupplyhub.atlassian.net/browse/OSDEV-XXXX) - <Describe infra/devops changes>.

### Bugfix

- [OSDEV-XXXX](https://opensupplyhub.atlassian.net/browse/OSDEV-XXXX) - <Describe the fix>.

### What's new

- [OSDEV-XXXX](https://opensupplyhub.atlassian.net/browse/OSDEV-XXXX) - <Describe user-facing feature or change>.

### Release instructions

- Ensure that the following commands are included in the `post_deployment` command:
    - `migrate`
    - `reindex_database`

---

## Writing Rules

1. **Omit empty sections.** Only include sections that have content. Hotfix releases often only have `Bugfix` and `Release instructions`.
2. **Link Jira tickets** using `[OSDEV-XXXX](https://opensupplyhub.atlassian.net/browse/OSDEV-XXXX)` format.
3. **Prefix tags** when applicable:
    - `[Hotfix][OSDEV-XXXX]` — for hotfix-specific items.
    - `[Follow-up][OSDEV-XXXX]` — for follow-up work from a previous release.
4. **Migration entries** use the format: `* <filename>.py - <description>.`
5. **Be detailed.** Each bullet should explain _what_ changed and _why_, including endpoint paths, model names, field names, and behavioral effects.
6. **Release instructions** always include at minimum `migrate` and `reindex_database`. Add other commands (e.g. `reindex_locations_with_approved_claim`) only when the release requires them.
7. **Release date** — use the actual date if known, otherwise leave as `*Provide release date*`.
8. **Separate releases** with a `---` divider followed by two blank lines between entries.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 100 lines · 44 tokens per session scan A 3518d0712389

Subscribe to this mod's changes

release-notes is a skill published in the GitHub repository opensupplyhub/open-supply-hub (20 stars, last pushed yesterday), licensed MIT. It adds 44 tokens to every session and 962 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.