# Release

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-initialneil-project-with-reflect-release`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [initialneil](https://agentstack.voostack.com/s/initialneil)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [initialneil](https://github.com/initialneil)
- **Source:** https://github.com/initialneil/project-with-reflect/tree/main/.claude/skills/release

## Install

```sh
agentstack add skill-initialneil-project-with-reflect-release
```

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

## About

# /release — ship a new project-with-reflect version

One command for the whole pipeline: **publish → refresh the local install**, so the
loop is `edit the skill → /release`.

## Usage
```
/release [patch|minor|major | X.Y.Z] ["one-line changelog note"]
```

Version-bump map (this project's convention):
- **major** — a user-facing big / breaking change → bumps the **first** number.
- **minor** — a **major fix** → bumps the **middle** number.
- **patch** — a **minor fix** → bumps the **last** number. **(default)**
- An explicit `X.Y.Z` is also accepted.

The **note** becomes the CHANGELOG entry. If omitted, summarize what changed in the
plugin since the last tag in one line — don't invent a generic message.

## Steps
1. **Locate the repo.** Work from the repo root (the dir with
   `.claude-plugin/plugin.json` and `scripts/publish.sh`). If the CWD isn't it, `cd`
   to `~/Playground/vibe_coding/project-with-reflect`.
2. **Preflight (report, don't nag).** `git status` to show what's being released;
   confirm you're on `main`. Echo one line: `releasing vCUR → vNEXT — `.
   The user typing `/release` IS the go-ahead — don't prompt again.
3. **Publish.** Run `scripts/publish.sh  ""`. It bumps the
   version in both manifests, prepends the CHANGELOG, commits, tags `v`,
   pushes, and (if `gh` is present) cuts a GitHub release.
4. **Refresh this machine's install.** If installed via the marketplace, run
   `claude plugin marketplace update project-with-reflect`. If installed via the
   user-scope symlink (`~/.claude/skills/project-with-reflect` → this repo), it's
   already live — nothing to do.
5. **Report.** Print the new version + tag, and remind that other users update with
   `/plugin update project-with-reflect`.

## Guardrails
- `/release` **pushes a public tag.** Run it only when the user invoked `/release` —
  never speculatively, never as a side effect of another task.
- If `scripts/publish.sh` fails (push rejected, tag exists, bad version), **STOP and
  report the exact failure.** Don't force-push or re-tag without asking.
- A release is for **plugin/skill changes only** — README / tooling / CI edits are a
  plain `git commit` + `git push`, not `/release`.
- Don't edit skill *content* here — `/release` ships what's already committed.

## Source & license

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

- **Author:** [initialneil](https://github.com/initialneil)
- **Source:** [initialneil/project-with-reflect](https://github.com/initialneil/project-with-reflect)
- **License:** MIT

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-initialneil-project-with-reflect-release
- Seller: https://agentstack.voostack.com/s/initialneil
- 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%.