add-to-changelog

A command for adding a dated change to a project's CHANGELOG.md file, which records updates between software releases.

In plain words
What is it for?
Use it to record added, changed, deprecated, removed, fixed, or security-related work for a specified version. It can also commit the update when requested.
Why use it?
It removes the need to find the right version and change category manually. It can create the file or version section when they do not exist and follows Keep a Changelog formatting.

Command for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/berrydev-ai/blockdoc-python/add-to-changelog
Clone the repo
git clone --depth 1 https://github.com/berrydev-ai/blockdoc-python

Made for: Claude Code.

Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 387 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00000 $0.00387
Opus 5 $0.00000 $0.00193
Sonnet 5 $0.00000 $0.00077
Haiku 4.5 $0.00000 $0.00039

Measured 2d ago against content hash d918c6233919, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

add-to-changelog 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 2d 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.

.claude/commands/add-to-changelog.md · 51 lines

What it actually says

Update Changelog

This command adds a new entry to the project's CHANGELOG.md file.

Usage

/add-to-changelog <version> <change_type> <message>

Where:

  • <version> is the version number (e.g., "1.1.0")
  • <change_type> is one of: "added", "changed", "deprecated", "removed", "fixed", "security"
  • <message> is the description of the change

Examples

/add-to-changelog 1.1.0 added "New markdown to BlockDoc conversion feature"
/add-to-changelog 1.0.2 fixed "Bug in HTML renderer causing incorrect output"

Description

This command will:

  1. Check if a CHANGELOG.md file exists and create one if needed
  2. Look for an existing section for the specified version
    • If found, add the new entry under the appropriate change type section
    • If not found, create a new version section with today's date
  3. Format the entry according to Keep a Changelog conventions
  4. Commit the changes if requested

The CHANGELOG follows the Keep a Changelog format and Semantic Versioning.

Implementation

The command should:

  1. Parse the arguments to extract version, change type, and message
  2. Read the existing CHANGELOG.md file if it exists
  3. If the file doesn't exist, create a new one with standard header
  4. Check if the version section already exists
  5. Add the new entry in the appropriate section
  6. Write the updated content back to the file
  7. Suggest committing the changes

Remember to update the package version in __init__.py and setup.py if this is a new version.

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. 2d ago First seen · 51 lines · 0 tokens per session scan A d918c6233919

Subscribe to this mod's changes

add-to-changelog is a command published in the GitHub repository berrydev-ai/blockdoc-python (3 stars, last pushed 1y ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 387 tokens. 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-31.