Agent skill

Swpm Keepachangelog

by deinsoftware in deinsoftware/swpm

Keep a Changelog 1.1.0 standards for SWPM. An agent skill from deinsoftware/swpm.

MITAuto-check passedDevelopment

Install Swpm Keepachangelog

skills CLI
$ npx skills add deinsoftware/swpm --skill swpm-keepachangelog -a claude-code

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

GitHub CLI
$ gh skill install deinsoftware/swpm swpm-keepachangelog --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/deinsoftware/swpm.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/swpm-keepachangelog .claude/skills/swpm-keepachangelog && 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
swpm-keepachangelog
GitHub stars
125
Token cost
~1.4k tokens
SKILL.md length
452 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Keep a Changelog 1.1.0 standards for SWPM. An agent skill from deinsoftware/swpm.

  • Works in 4 steps: Date format: Uses 2023/12/26 (slashes) →… → Non-standard section: Uses ### Updated →… → Missing sections: No ### Security in… → …
  • Modifies CHANGELOG.md
  • SKILL.md covers When to Use, Keep a Changelog 1.1.0 Rules, SWPM Changelog Conventions and Example Entries, plus 5 more sections
  • Reaches keepachangelog.com and semver.org

What it does

Swpm Keepachangelog is an agent skill from deinsoftware/swpm. Keep a Changelog 1.1.0 standards for SWPM. Defines format, sections, and conventions for CHANGELOG.md entries. Activates when user modifies CHANGELOG.md.

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. It works with Node.js and npm. The repository describes itself as: Switch Package Manager - Say goodbye to Package Manager confusion. The licence is MIT.

When your agent uses it

  • Modifies CHANGELOG.md
  • Tasks that involve Changelog and release notes

Example prompts

  • “/swpm-keepachangelog”

Workflow steps

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

  1. Date format: Uses 2023/12/26 (slashes) → Should be 2023-12-26 (hyphens)
  2. Non-standard section: Uses ### Updated → Should use ### Changed
  3. Missing sections: No ### Security in recent versions
  4. Header: References Keep a Changelog 1.0.0 → Should reference 1.1.0

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • keepachangelog.com
    • semver.org

    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

Swpm Keepachangelog loads about 1.4k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 452 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
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 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 deinsoftware/swpm at commit ee443bd, republished under its MIT licence (© deinsoftware). 452 words, ~1,394 tokens.

Download SKILL.mdSave it as .claude/skills/swpm-keepachangelog/SKILL.md (or your agent's skills folder).
name
swpm-keepachangelog
description
Keep a Changelog 1.1.0 standards for SWPM. Defines format, sections, and conventions for CHANGELOG.md entries. Activates when user modifies CHANGELOG.md.
id
swpm-keepachangelog
version
1.0.0
tags
swpm, changelog, keepachangelog, documentation

SWPM Keep a Changelog Standards

Use this skill when modifying CHANGELOG.md or when questions arise about changelog format, sections, or entry conventions.

When to Use

  • User is editing CHANGELOG.md - activates to ensure entries follow Keep a Changelog 1.1.0
  • Developer asks "How should I format this changelog entry?"
  • Questions about what section to use (Added, Changed, Fixed, etc.)
  • Updating version entries with proper date format
  • Do not use for version number decisions (use swpm-semver for SemVer)

Keep a Changelog 1.1.0 Rules

Required Format
markdown
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

- New feature description

### Changed

- Change description

## [2.6.0] - 2023-12-26

### Changed

- Revert the `--location=global` flag translation on npm

### Fixed

- Fix description here
Version Line Format

✅ Correct:

## [2.6.0] - 2023-12-26
## [2.7.0-alpha] - 2023-12-26

❌ Incorrect:

## 2.6.0 - 2023/12/26    // Slashes, no brackets
## v2.6.0 - 2023-12-26    // Don't use 'v' prefix in heading
Date Format
  • ISO 8601: YYYY-MM-DD (hyphens, not slashes)
  • ✅ 2023-12-26
  • ❌ 2023/12/26
  • ❌ 26-12-2023
Required Sections

Each version should have relevant sections:

  • Added - for new features
  • Changed - for changes in existing functionality
  • Deprecated - for soon-to-be removed features
  • Removed - for now removed features
  • Fixed - for any bug fixes
  • Security - in case of vulnerabilities
Optional Sections
  • Unreleased - section at top for upcoming changes
  • Updated - ❌ NOT standard, don't use (use Changed instead)

SWPM Changelog Conventions

Current Issues to Fix

The current CHANGELOG.md has these problems:

  1. Date format: Uses 2023/12/26 (slashes) → Should be 2023-12-26 (hyphens)
  2. Non-standard section: Uses ### Updated → Should use ### Changed
  3. Missing sections: No ### Security in recent versions
  4. Header: References Keep a Changelog 1.0.0 → Should reference 1.1.0
Version Ordering
  • Most recent version at the top
  • ## [Unreleased] section at the very top
  • Older versions below in reverse chronological order
Entry Format
markdown
### Fixed

- volta version detection when not installed
- if volta was not installed don't take in care the volta pin version on `package.json`
  • Use - (dash) for bullet points
  • Use backticks for code references: `package.json`, `--global`
  • Sentence case: capitalize first letter, no period at end
  • Be descriptive but concise

Example Entries

✅ Correct - Added
markdown
### Added

- `bun` command and flags included in new version
- Repository helpers unit test
✅ Correct - Changed
markdown
### Changed

- TypeScript strict configuration
- Bump package versions
✅ Correct - Fixed
markdown
### Fixed

- `global` flag position on `yarn` and `yarn@berry`
- Get repository URL when using SSH URI
❌ Incorrect
markdown
### Updated // Not a standard section

- Bump package versions

### Fixed

- Fixed global flag (double "fixed")
- global flag (no code backticks)
- Bump package versions. (period at end)

At the bottom of the file, include comparison links:

markdown
[unreleased]: https://github.com/deinsoftware/swpm/compare/v2.6.0...HEAD
[2.6.0]: https://github.com/deinsoftware/swpm/compare/v2.5.2...v2.6.0
[2.5.2]: https://github.com/deinsoftware/swpm/compare/v2.5.1...v2.5.2
Show full SKILL.md (181 more words)Show less

Release Checklist

Before releasing a new version:

  1. Move entries from ## [Unreleased] to new version section
  2. Add version line: ## [X.Y.Z] - YYYY-MM-DD
  3. Add appropriate sections (### Added, ### Changed, etc.)
  4. Add comparison link at bottom of file
  5. Commit with message like Release vX.Y.Z

Example Questions

Q: "How should I document a new command in the changelog?" A: Use ### Added section:

markdown
### Added

- `clean` command to remove unused dependencies

Q: "What section should I use for bug fixes?" A: Use ### Fixed section:

markdown
### Fixed

- Fix `global` flag position on yarn

Q: "Can I use ### Updated section?" A: No, use ### Changed instead. Updated is not a standard Keep a Changelog section.

Q: "What date format should I use?" A: ISO 8601 format with hyphens: 2023-12-26 (not slashes 2023/12/26)

Q: "Where should the new version go in the file?" A: At the top, after ## [Unreleased], most recent first.

Observations

Before helping with changelog edits:

  • Check current CHANGELOG.md format
  • Verify date format uses hyphens not slashes
  • Ensure sections are standard (Added, Changed, Deprecated, Removed, Fixed, Security)
  • Check if ## [Unreleased] section exists at top
  • Verify version comparison links at bottom of file
  • Reference: https://keepachangelog.com/en/1.1.0/

Reference

Full Keep a Changelog specification: https://keepachangelog.com/en/1.1.0/

© deinsoftware, MIT. 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/swpm-keepachangelog of deinsoftware/swpm.

Open the folder on GitHubat commit ee443bd

Compare with similar skills

Swpm Keepachangelog 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.

Swpm Keepachangelog compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Swpm Keepachangelog this skilldeinsoftware/swpm125—~1.4kAutomated safety check: PassMIT
Nylas Nodejs Releasenylas/nylas-nodejs181—~1.6kAutomated safety check: WarnMIT
Release Coherencemacalbert/envilder138—~1.3kAutomated safety check: PassMIT
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
Generate Release Notesteambit/bit18k—~2.2kAutomated safety check: PassCustom licence
Release Skillsnexmoe/eve4213 repos~3.3kAutomated safety check: PassNone

Similar skills

  • Nylas Nodejs Release

    nylas/nylas-nodejs

    Prepares nylas-nodejs SDK releases on a versioned release branch with CHANGELOG updates, version bump, git tag, and PR body.

    181 GitHub stars~1.6k tokensUpdated 5 days ago
    DevelopmentAuto-check: warnings
  • Release Coherence

    macalbert/envilder

    Unified release coherence workflow for any component (CLI, GHA, or SDK).

    138 GitHub stars~1.3k tokensUpdated 3 days ago
    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
  • Generate comprehensive release notes for Bit from git commits and pull requests.

    18k GitHub stars~2.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Release Skills

    nexmoe/eve

    Universal release workflow. An agent skill from nexmoe/eve.

    421 GitHub starsUsed in 3 repos~3.3k tokens
    DevelopmentAuto-check passed
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from deinsoftware/swpm

  • Swpm Code Review

    deinsoftware/swpm

    Automated code review bash script for SWPM. An agent skill from deinsoftware/swpm.

    125 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Swpm Release

    deinsoftware/swpm

    Automated release bash script for SWPM. An agent skill from deinsoftware/swpm.

    125 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Swpm Semver

    deinsoftware/swpm

    Semantic Versioning 2.0.0 guidelines for SWPM. An agent skill from deinsoftware/swpm.

    125 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check passed
  • Swpm Conventional Commits

    deinsoftware/swpm

    Conventional Commits 1.0.0 specification for SWPM. An agent skill from deinsoftware/swpm.

    125 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Swpm Dev Guide

    deinsoftware/swpm

    Development guide for setting up, debugging, and testing SWPM locally.

    125 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check passed
  • Swpm Manage Commands Args

    deinsoftware/swpm

    Manage cmds and args props in SWPM package manager configs (src/packages/managers/.ts), including adding, modifying or removing command and argument mappings across npm, yarn, pnpm, bun, deno.

    125 GitHub stars~1.5k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Swpm Keepachangelog

What does Swpm Keepachangelog do?

Keep a Changelog 1.1.0 standards for SWPM. An agent skill from deinsoftware/swpm. Swpm Keepachangelog is an agent skill from deinsoftware/swpm.0 standards for SWPM.

When should I use Swpm Keepachangelog?

Swpm Keepachangelog fits situations like: modifies CHANGELOG.md; tasks that involve Changelog and release notes.

How do I install Swpm Keepachangelog in Claude Code?

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

How do I install Swpm Keepachangelog in Codex?

Run `npx skills add deinsoftware/swpm --skill swpm-keepachangelog -a codex`. Or copy the skill folder (.agents/skills/swpm-keepachangelog in deinsoftware/swpm) into .agents/skills/swpm-keepachangelog in your project. Codex loads it when a task matches its description.

Can I use Swpm Keepachangelog 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 deinsoftware/swpm --skill swpm-keepachangelog -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/swpm-keepachangelog, .gemini/skills/swpm-keepachangelog, .github/skills/swpm-keepachangelog and .opencode/skills/swpm-keepachangelog in your project.

What does Swpm Keepachangelog need to run?

SKILL.md names no scripts, command-line tools or credentials: Swpm Keepachangelog is instructions for the agent only.

Does Swpm Keepachangelog access the network?

SKILL.md names 2 domains. In commands or code: keepachangelog.com and semver.org; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Swpm Keepachangelog 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 Swpm Keepachangelog use?

Swpm Keepachangelog is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Swpm Keepachangelog 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 Swpm Keepachangelog?

Skills that share tags, products or a category with Swpm Keepachangelog: Nylas Nodejs Release (nylas/nylas-nodejs, 181 stars), Release Coherence (macalbert/envilder, 138 stars), Cutting A Release (TriliumNext/Trilium, 38k stars) and Generate Release Notes (teambit/bit, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Swpm Keepachangelog?

deinsoftware (a GitHub organization) maintains it in deinsoftware/swpm, which has 125 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on June 6, 2026.

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