Agent skill

Tag New Release

by jamesmontemagno in jamesmontemagno/tiny-clips

Create a new annotated git tag with release notes extracted from changelog files.

MITAuto-check passedDevelopment

Install Tag New Release

skills CLI
$ npx skills add jamesmontemagno/tiny-clips --skill tag-new-release -a claude-code

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

GitHub CLI
$ gh skill install jamesmontemagno/tiny-clips tag-new-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/jamesmontemagno/tiny-clips.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/tag-new-release .claude/skills/tag-new-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
tag-new-release
GitHub stars
121
Token cost
~920 tokens
SKILL.md length
430 words
Files
3
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Create a new annotated git tag with release notes extracted from changelog files.

  • Works in 9 steps: Check existing tags - Inspect recent git… → Determine release version → Read platform changelog → …
  • Tasks that involve Changelog and release notes
  • SKILL.md covers When to use, How to use, Step-by-step procedure and Release notes format, plus 2 more sections
  • Runs PowerShell and Shell scripts from its folder; calls bash and git

What it does

Tag New Release is an agent skill from jamesmontemagno/tiny-clips. Create a new annotated git tag with release notes extracted from changelog files. Supports both macOS and Windows TinyClips release flows.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `tag-new-release.sh`).

It sits in Development, covering Changelog and release notes. It works with macOS, Git, C# and Windows. The repository describes itself as: A lightweight macOS & Windows menu bar app for capturing screenshots (PNG), video (MP4), and animated GIFs of a selected screen region. The licence is MIT.

When your agent uses it

  • Tasks that involve Changelog and release notes

Example prompts

  • “/tag-new-release”

Requirements

  • A Bash shell
  • PowerShell

Workflow steps

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

  1. Check existing tags - Inspect recent git tags for the selected platform.
  2. Determine release version
  3. Read platform changelog
  4. Update changelog - Insert the release heading with today's date below Unreleased.
  5. Verify the working directory - Ensure there are no uncommitted changes before creating commit/tag.
  6. Create commit - Commit the changelog release marker.
  7. Create an annotated git tag with
  8. Confirm the tag - Show the created tag details to verify the tag name and message.
  9. Suggest pushing the tag - Tell the user they can push with

What it can do on your machine

Read from SKILL.md and the folder at commit 2001cf8. 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 script files (PowerShell and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Tag New Release loads about 920 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 430 words of instructions outside code blocks.

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

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 jamesmontemagno/tiny-clips at commit 2001cf8, republished under its MIT licence (© jamesmontemagno). 430 words, ~920 tokens.

Download SKILL.mdSave it as .claude/skills/tag-new-release/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
tag-new-release
description
Create a new annotated git tag with release notes extracted from changelog files. Supports both macOS and Windows TinyClips release flows.
argument-hint
--platform <mac|windows> [--version <tag>] (e.g., --platform mac --version v1.5.0-mac)
user-invocable
true

Tag New Release

Create a new annotated git tag for a release based on the project's platform changelog.

When to use

  • When preparing a new TinyClips release tag for macOS or Windows.
  • When the user asks to tag a release.
  • When the user provides a version to tag, such as v1.5.0-mac or v1.0.9-windows.
  • When the user wants release notes extracted from the relevant changelog and included in the tag message.

How to use

Request the release tag in chat (platform is required):

text
/tag-new-release --platform mac --version v1.5.0-mac

Or run the script directly from the repository root:

bash
bash .github/skills/tag-new-release/tag-new-release.sh --platform mac --version v1.5.0-mac

On Windows, use PowerShell:

powershell
powershell -ExecutionPolicy Bypass -File .github/skills/tag-new-release/tag-new-release.ps1 -Platform windows -Version v1.0.9-windows

If --version is provided, that exact tag value is used for the release. If --version is omitted:

  • macOS defaults to v<Info.plist CFBundleShortVersionString>.0-mac (for example, v1.5.0-mac)
  • Windows defaults to incrementing patch from the latest v*-windows tag.

Step-by-step procedure

When asked to tag a new release:

  1. Check existing tags - Inspect recent git tags for the selected platform.

  2. Determine release version:

    • macOS: If the user provides a tag version, use it as the source of truth; otherwise validate it against mac/TinyClips/Info.plist CFBundleShortVersionString
    • Windows: Use provided tag or infer by incrementing the latest -windows patch tag
  3. Read platform changelog:

    • macOS: root CHANGELOG.md
    • Windows: windows/CHANGELOG.md
  4. Update changelog - Insert the release heading with today's date below Unreleased.

  5. Verify the working directory - Ensure there are no uncommitted changes before creating commit/tag.

  6. Create commit - Commit the changelog release marker.

  7. Create an annotated git tag with:

    • A tag name matching the platform version (for example v1.5.0-mac, v1.0.9-windows)
    • A tag message containing the version and formatted release notes from the platform changelog
  8. Confirm the tag - Show the created tag details to verify the tag name and message.

  9. Suggest pushing the tag - Tell the user they can push with:

    bash
    git push origin <tag-name>

    Do not push the tag unless the user explicitly asks.

Show full SKILL.md (128 more words)Show less

Release notes format

The tag message should include cleanly formatted release notes from the selected changelog entry for the release. Include all relevant sections, such as:

  • Added
  • Improved
  • Fixed
  • Changed
  • Deprecated
  • Removed
  • Security

Safety checks

  • Do not create a release tag from a dirty working directory.
  • Do not overwrite an existing tag.
  • Do not push tags without explicit user approval.
  • If the requested version conflicts with existing tags, stop and ask the user how to proceed.
  • When the version is provided explicitly by the user, honor that value even if it differs from the app's current Info.plist version.

Files included

  • tag-new-release.sh - Script that automates changelog release marking, commit creation, and annotated tagging for macOS or Windows.
  • tag-new-release.ps1 - PowerShell equivalent for running the same release-tag workflow natively on Windows.

© jamesmontemagno, 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 2 other files in .github/skills/tag-new-release of jamesmontemagno/tiny-clips.

  • SKILL.md
  • tag-new-release.ps1
  • tag-new-release.sh

Open the folder on GitHubat commit 2001cf8

Compare with similar skills

Tag New 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.

Tag New Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tag New Release this skilljamesmontemagno/tiny-clips121—~920Automated safety check: PassMIT
Pulse Releasequnqin24/Pulse521—~1.3kAutomated safety check: PassApache-2.0
Commitmanhpham90vn/Deskhub133—~978Automated safety check: PassMIT
Changelog Maintenancepluk-inc/himekuri163—~2.4kAutomated safety check: PassMIT
Sake CI Releasekattouf/Sake116—~731Automated safety check: PassMIT
Releaseyicheng47/runner275—~2.4kAutomated safety check: PassMIT

Similar skills

  • Pulse Release

    qunqin24/Pulse

    Release a new Pulse version end to end — checks, bilingual CHANGELOG entry, VERSION, tag, the release workflow, syncing main, and the issue replies that go with it.

    521 GitHub stars~1.3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Commit

    manhpham90vn/Deskhub

    Write a Deskhub commit message. An agent skill from manhpham90vn/Deskhub.

    133 GitHub stars~978 tokensUpdated today
    DevelopmentAuto-check passed
  • Changelog Maintenance

    pluk-inc/himekuri

    Maintain a clear and informative changelog for software releases.

    163 GitHub stars~2.4k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Sake CI Release

    kattouf/Sake

    A skill your agent uses when working on CI workflows, GitHub Actions, release process, changelog generation (git-cliff), or dependabot configuration.

    116 GitHub stars~731 tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • Release

    yicheng47/runner

    Cut a Runner production release — bump the workspace version, tag vX.Y.Z, let release.yml build the draft for both platforms, write bilingual release notes (English, with 中文 collapsed in a details…

    275 GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Changelog Generator

    Eslzzyl/Pixiv-SwiftUI

    Generate user-facing changelogs from git history between two versions.

    111 GitHub stars~940 tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from jamesmontemagno/tiny-clips

  • Bump Swift Version

    jamesmontemagno/tiny-clips

    Bump the version for the TinyClips Swift app across Info.plist, Info-MAS.plist, and project.pbxproj.

    121 GitHub stars~695 tokensUpdated today
    Auto-check passed
  • Hype Video

    jamesmontemagno/tiny-clips

    Produce the Tiny Clips hype video for a new release — ask about the campaign angle, energy, motion, music, and visual theme, then update the "What's new" tiles, render the 45-second 1080p MP4, and…

    121 GitHub stars~2.5k tokensUpdated today
    Auto-check passed

Categories

Questions about Tag New Release

What does Tag New Release do?

Create a new annotated git tag with release notes extracted from changelog files. Tag New Release is an agent skill from jamesmontemagno/tiny-clips. Create a new annotated git tag with release notes extracted from changelog files.

When should I use Tag New Release?

Tag New Release fits situations like: tasks that involve Changelog and release notes.

How do I install Tag New Release in Claude Code?

Run `npx skills add jamesmontemagno/tiny-clips --skill tag-new-release -a claude-code`. Or copy the skill folder (.github/skills/tag-new-release in jamesmontemagno/tiny-clips) into .claude/skills/tag-new-release in your project. Claude Code loads it when a task matches its description.

How do I install Tag New Release in Codex?

Run `npx skills add jamesmontemagno/tiny-clips --skill tag-new-release -a codex`. Or copy the skill folder (.github/skills/tag-new-release in jamesmontemagno/tiny-clips) into .agents/skills/tag-new-release in your project. Codex loads it when a task matches its description.

Can I use Tag New 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 jamesmontemagno/tiny-clips --skill tag-new-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/tag-new-release, .gemini/skills/tag-new-release, .github/skills/tag-new-release and .opencode/skills/tag-new-release in your project.

What does Tag New Release need to run?

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

Does Tag New Release access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Tag New 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. Review the folder before installing.

What licence does Tag New Release use?

Tag New 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 Tag New Release use?

About 920 tokens (SKILL.md is roughly 3.7k 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 Tag New Release?

Skills that share tags, products or a category with Tag New Release: Pulse Release (qunqin24/Pulse, 521 stars), Commit (manhpham90vn/Deskhub, 133 stars), Changelog Maintenance (pluk-inc/himekuri, 163 stars) and Sake CI Release (kattouf/Sake, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tag New Release?

jamesmontemagno (a GitHub user) maintains it in jamesmontemagno/tiny-clips, which has 121 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 10, 2026.

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