# Jira Release Setup

> Create the complete Jira card structure for a product release milestone. Encodes the release card templates (epics + child tasks) so the agent never has to reconstruct them. Use this skill when the user asks to set up Jira cards for a new release, create release tracking epics, or set up sprint cards for a release milestone.

- **Type:** Skill
- **Install:** `agentstack add skill-aipcc-cicd-claudio-skills-jira-release-setup`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [aipcc-cicd](https://agentstack.voostack.com/s/aipcc-cicd)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [aipcc-cicd](https://github.com/aipcc-cicd)
- **Source:** https://github.com/aipcc-cicd/claudio-skills/tree/main/claudio-plugin/skills/jira-release-setup

## Install

```sh
agentstack add skill-aipcc-cicd-claudio-skills-jira-release-setup
```

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

## About

# Jira Release Setup

Creates the complete Jira card structure for a product release milestone. Encodes the canonical release templates so no business logic needs to be reconstructed each session.

## Prerequisites

**Required environment variables:**
- `JIRA_SITE` — Atlassian site (e.g. `yourorg.atlassian.net`)
- `JIRA_TOKEN` — Atlassian API token
- `JIRA_EMAIL` — Your Atlassian account email

**Required tools:** `acli`, `jq`

## Card Templates

### Two-phase release (default)

```text
Epic:   Downstream Release
  ├── Task: Build   RC drops
  ├── Task: Release   to production
  └── Task: Send a   release announcement email

Epic:   Post-Release Activities
  ├── Task: Push   to cloud marketplaces
  └── Task: Bump  version to 
```

### Single-epic release (`--single-epic`)

```text
Epic:   Downstream Release
  ├── Task: Release   to production
  ├── Task: Send a   release announcement email
  └── Task: Bump  version to 
```

## Version Calculation

Next-version is computed automatically by `_next_version.sh`:

| Input version | Next version |
|---|---|
| `3.4 GA` | `3.4.1` |
| `3.3.2` | `3.3.3` |
| `3.4 EA1` | `3.4 EA2` |

## Scripts

### `create_release.sh` — Create full release card structure

```bash
./scripts/create_release.sh --project KEY   [options]
```

**Options:**
- `--project KEY` — Jira project key (required)
- `--component NAME` — component to set on all created issues (optional)
- `--single-epic` — create one downstream epic only (default: two-phase)
- `--sprint-id ID` — assign all created cards to this sprint (optional)

**Examples:**
```bash
# Single-epic release
./scripts/create_release.sh --project MYPROJ MyProduct "3.3.2" --single-epic

# Two-phase release assigned to sprint
./scripts/create_release.sh --project MYPROJ MyProduct "3.4 GA" --sprint-id 44147

# Get sprint ID first, then create
SPRINT=$(../../jira-sprint-manager/scripts/get_sprint_id.sh --board-id 42 --active)
./scripts/create_release.sh --project MYPROJ MyProduct "3.3.2" --single-epic --sprint-id "$SPRINT"
```

---

### `_next_version.sh` — Calculate next version (internal helper)

```bash
./scripts/_next_version.sh "3.3.2"   # → 3.3.3
./scripts/_next_version.sh "3.4 GA"  # → 3.4.1
./scripts/_next_version.sh "3.4 EA1" # → 3.4 EA2
```

## Source & license

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

- **Author:** [aipcc-cicd](https://github.com/aipcc-cicd)
- **Source:** [aipcc-cicd/claudio-skills](https://github.com/aipcc-cicd/claudio-skills)
- **License:** Apache-2.0

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-aipcc-cicd-claudio-skills-jira-release-setup
- Seller: https://agentstack.voostack.com/s/aipcc-cicd
- 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%.