Agent skill

Swpm Release

by deinsoftware in deinsoftware/swpm

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

MITAuto-check passedDevelopment

Install Swpm Release

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

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

GitHub CLI
$ gh skill install deinsoftware/swpm swpm-release --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-release .claude/skills/swpm-release && 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-release
GitHub stars
125
Token cost
~1.1k tokens
SKILL.md length
375 words
Files
2 (incl. scripts)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 7 steps: Reads current version from package.json → Analyzes commits in branch vs… → Updates version in package.json → …
  • Tasks that involve Changelog and release notes
  • SKILL.md covers When to Use, What This Skill Does, Usage and Prerequisites, plus 4 more sections
  • Runs Shell scripts from its folder; calls git and bash

What it does

Swpm Release is an agent skill from deinsoftware/swpm. Automated release bash script for SWPM. Updates version in package.json, moves [Unreleased] entries to new version section in CHANGELOG.md, and follows SemVer and Keep a Changelog standards. Analyzes commits to suggest version bump or accepts manual version argument.

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

It sits in Development, covering Changelog and release notes and Shell scripting. It works with npm, Bash and Node.js. The repository describes itself as: Switch Package Manager - Say goodbye to Package Manager confusion. The licence is MIT.

When your agent uses it

  • Tasks that involve Changelog and release notes
  • Tasks that involve Shell scripting

Example prompts

  • “/swpm-release”

Requirements

  • A Bash shell

Workflow steps

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

  1. Reads current version from package.json
  2. Analyzes commits in branch vs main/master to suggest version bump (major/minor/patch)
  3. Updates version in package.json
  4. Reads [Unreleased] section from CHANGELOG.md
  5. Creates new version section with current date in proper format
  6. Moves entries from [Unreleased] to new version section
  7. Preserves comparison links at the bottom of CHANGELOG.md

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

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

    Shell commands in SKILL.md call:

    • git
    • bash

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

    • semver.org
    • keepachangelog.com

    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 Release loads about 1.1k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 375 words of instructions outside code blocks.

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

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 deinsoftware/swpm at commit ee443bd, republished under its MIT licence (© deinsoftware). 375 words, ~1,050 tokens.

Download SKILL.mdSave it as .claude/skills/swpm-release/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
swpm-release
description
Automated release bash script for SWPM. Updates version in package.json, moves `[Unreleased]` entries to new version section in CHANGELOG.md, and follows SemVer and Keep a Changelog standards. Analyzes commits to suggest version bump or accepts manual version argument.
id
swpm-release
version
1.0.0
tags
swpm, release, version, changelog, automation
arguments
version
disable-model-invocation
true
user-invocable
false

SWPM Release Automation

Use this skill when preparing a new release. The skill provides an executable bash script that automates version bumping and CHANGELOG updates.

When to Use

  • Developer wants to prepare a new release
  • Need to update version in package.json
  • Need to move [Unreleased] entries to a new version section
  • Questions about release process automation
  • Do not use for manual versioning decisions (use swpm-semver instead)

What This Skill Does

The executable script scripts/release.sh automates:

  1. Reads current version from package.json
  2. Analyzes commits in branch vs main/master to suggest version bump (major/minor/patch)
  3. Updates version in package.json
  4. Reads [Unreleased] section from CHANGELOG.md
  5. Creates new version section with current date in proper format
  6. Moves entries from [Unreleased] to new version section
  7. Preserves comparison links at the bottom of CHANGELOG.md

Usage

How to Invoke

Make it executable and run:

bash
chmod +x .agents/skills/swpm-release/scripts/release.sh
./agents/skills/swpm-release/scripts/release.sh

Or run directly with bash:

bash
bash .agents/skills/swpm-release/scripts/release.sh
What the Script Does

The script will:

  • Analyze commits in current branch vs main/master
  • Suggest version bump based on commit types (feat → minor, fix → patch, breaking → major)
  • Show current version and calculated new version
  • Ask for confirmation
  • Update package.json
  • Move [Unreleased] entries to new version section in CHANGELOG.md
  • Update comparison links at bottom of CHANGELOG.md
  • Display the tag and CHANGELOG content for the new version (ready to copy/paste)
Example Session
Current version: 2.6.0

Analyzing 1 commits in branch...
  - feat(agents): add comprehensive agent skills for SWPM

Suggested version bump: minor
New version would be: 2.7.0

Proceed with this version? (y/N): y

Updating package.json to 2.7.0...
Moving [Unreleased] entries to [2.7.0] - 2026-05-01...
Updating comparison links...

=== COPY BELOW FOR COMMIT ===
Tag: v2.7.0

--- CHANGELOG CONTENT FOR v2.7.0 ---
- Added new feature X
- Fixed bug Y
--- END ---

Next steps:
  1. Review CHANGELOG.md
  2. Copy the tag and content above
  3. Commit: git add . && git commit -m "Release v2.7.0"
  4. Create tag manually: git tag v2.7.0
  5. Push tag: git push origin v2.7.0
Show full SKILL.md (158 more words)Show less

Prerequisites

  • Bash shell
  • Git repository with main or master branch
  • package.json with current version
  • CHANGELOG.md with [Unreleased] section at the top

Script Location

.agents/skills/swpm-release/
├── SKILL.md
└── scripts/
    └── release.sh

Example Questions

Q: "How do I prepare a new release?" A: Run bash .agents/skills/swpm-release/scripts/release.sh and follow the prompts.

Q: "What does the release script do?" A: It analyzes commits to suggest a version bump, updates package.json, and moves [Unreleased] entries to a new version section in CHANGELOG.md.

Q: "Can I run the script multiple times?" A: Yes, but it will overwrite the [Unreleased] section each time. Make sure to commit changes between releases.

Observations

Before running the release script:

  • Ensure [Unreleased] section in CHANGELOG.md has entries
  • Verify the version bump type (check swpm-semver skill for guidance)
  • Review the changes after running the script
  • Commit with message like Release vX.Y.Z
  • Create git tag manually: git tag vX.Y.Z (you control the publish hook)
  • Push: git push origin vX.Y.Z

Reference

© 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

SKILL.md and 1 other file (scripts) in .agents/skills/swpm-release of deinsoftware/swpm.

  • SKILL.md
  • scripts/release.sh

Open the folder on GitHubat commit ee443bd

Compare with similar skills

Swpm Release 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 Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Swpm Release this skilldeinsoftware/swpm125—~1.1kAutomated safety check: PassMIT
Nylas Nodejs Releasenylas/nylas-nodejs181—~1.6kAutomated safety check: WarnMIT
Minimum Viableferrumclaudepilgrim/claude-code-android266—~538Automated safety check: NotesMIT
Release Coherencemacalbert/envilder138—~1.3kAutomated safety check: PassMIT
ZxLeoYeAI/openclaw-master-skills2.2k—~2.2kAutomated safety check: NotesMIT
New Mac Setupswyxio/skills172—~4.3kAutomated safety check: PassMIT

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
  • Minimum Viable

    ferrumclaudepilgrim/claude-code-android

    Before building anything, justify the tool choice and complexity level.

    266 GitHub stars~538 tokensUpdated 2 mo ago
    DevelopmentAuto-check: notes
  • Release Coherence

    macalbert/envilder

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

    138 GitHub stars~1.3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Zx

    LeoYeAI/openclaw-master-skills

    Comprehensive guide for writing shell scripts with Google zx — a tool for writing better scripts using JavaScript/TypeScript.

    2.2k GitHub stars~2.2k tokensUpdated 2 mo ago
    DevelopmentAuto-check: notes
  • New Mac Setup

    swyxio/skills

    Fully automated new Mac setup for fullstack web developers and AI engineers.

    172 GitHub stars~4.3k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    69k GitHub stars~2k tokensUpdated yesterday
    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 Keepachangelog

    deinsoftware/swpm

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

    125 GitHub stars~1.4k 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 Release

What does Swpm Release do?

Automated release bash script for SWPM. An agent skill from deinsoftware/swpm. Swpm Release is an agent skill from deinsoftware/swpm. Automated release bash script for SWPM.

When should I use Swpm Release?

Swpm Release fits situations like: tasks that involve Changelog and release notes; tasks that involve Shell scripting.

How do I install Swpm Release in Claude Code?

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

How do I install Swpm Release in Codex?

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

Can I use Swpm Release 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-release -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-release, .gemini/skills/swpm-release, .github/skills/swpm-release and .opencode/skills/swpm-release in your project.

What does Swpm Release need to run?

Going by SKILL.md and its folder, Swpm Release needs a shell for the scripts in its folder and the command-line tools its instructions call (git and bash). Our summary lists: A Bash shell.

Does Swpm Release access the network?

SKILL.md names 2 domains. As links in the text: semver.org and keepachangelog.com. This is read from the text; nothing was executed.

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

Swpm Release 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 Release use?

About 1.1k tokens (SKILL.md is roughly 4.2k 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 Release?

Skills that share tags, products or a category with Swpm Release: Nylas Nodejs Release (nylas/nylas-nodejs, 181 stars), Minimum Viable (ferrumclaudepilgrim/claude-code-android, 266 stars), Release Coherence (macalbert/envilder, 138 stars) and Zx (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Swpm Release?

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.