# Tag Version

> Bump the package version and create an annotated git tag. Accepts a semantic version number (1.2.0) or a bump type (patch, minor, major). Does not push — use the publish skill to push. Use as part of a release workflow.

- **Type:** Skill
- **Install:** `agentstack add skill-davila7-claude-with-skills-tag-version`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [davila7](https://agentstack.voostack.com/s/davila7)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [davila7](https://github.com/davila7)
- **Source:** https://github.com/davila7/claude-with-skills/tree/main/src/content/docs/03-advanced/lesson-05-skills-orchestrating-skills/examples/release-flow/.claude/skills/tag-version
- **Website:** https://claude-with-skills.vercel.app

## Install

```sh
agentstack add skill-davila7-claude-with-skills-tag-version
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Bump the version and create an annotated git tag for `$ARGUMENTS`.

If `$ARGUMENTS` is empty, stop and tell the user: "Provide a version or bump type — for example: `/tag-version patch` or `/tag-version 1.2.0`."

## Step 1: Determine the new version

Inspect the current version:
!`cat package.json 2>/dev/null | grep '"version"' | head -1 || echo "no package.json found"`

If `$ARGUMENTS` is a semantic version string matching the pattern `X.Y.Z` (e.g., `1.2.0`, `0.9.1`), use it directly as the new version.

If `$ARGUMENTS` is `patch`, `minor`, or `major`, run:
```
npm version $ARGUMENTS --no-git-tag-version
```
This updates package.json without creating a git tag. Read the new version from package.json after the command runs:
```
cat package.json | grep '"version"'
```

## Step 2: Stage the version bump

If `npm version` was used to update package.json, stage the change:
```
git add package.json package-lock.json
git commit -m "Bump version to v$VERSION"
```

If the version was provided as a literal semver string, update package.json manually: edit the `"version"` field to the new value, then stage and commit it.

## Step 3: Create the annotated tag

```
git tag -a v$VERSION -m "Release v$VERSION"
```

## Step 4: Confirm

Run `git describe --tags --abbrev=0` and show the output. Confirm: "Tag v$VERSION created. Run `/publish` to push it to origin and create the GitHub release."

Do not push. The publish skill handles pushing.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [davila7](https://github.com/davila7)
- **Source:** [davila7/claude-with-skills](https://github.com/davila7/claude-with-skills)
- **License:** MIT
- **Homepage:** https://claude-with-skills.vercel.app

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-davila7-claude-with-skills-tag-version
- Seller: https://agentstack.voostack.com/s/davila7
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.