skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
grandcamel/gitlab-assistant-skills93 installs

gitlab-release

GitLab release operations. ALWAYS use this skill when user wants to: (1) list releases, (2) view release details, (3) create new releases, (4) upload assets, (5) delete releases.

How do I install this agent skill?

npx skills add https://github.com/grandcamel/gitlab-assistant-skills --skill gitlab-release
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubfail

    The skill facilitates GitLab release management but introduces a high risk of data exfiltration. An attacker could potentially leverage the 'upload' command to exfiltrate sensitive local files like credentials or environment variables to a GitLab repository.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · No issues

  • Runlayerwarn

    1/1 file flagged

  • ZeroLeakspass

    Score: 93/100 · 2 sections analyzed

What does this agent skill do?

Release Skill

Release operations for GitLab using the glab CLI.

Quick Reference

OperationCommandRisk
List releasesglab release list-
View releaseglab release view <tag>-
Create releaseglab release create <tag>⚠️
Upload assetsglab release upload <tag> <files>⚠️
Download assetsglab release download <tag>-
Delete releaseglab release delete <tag>⚠️⚠️

Risk Legend: - Safe | ⚠️ Caution | ⚠️⚠️ Warning | ⚠️⚠️⚠️ Danger

When to Use This Skill

ALWAYS use when:

  • User wants to work with releases
  • User mentions "release", "version", "changelog", "tag" (for releases)
  • User wants to publish or distribute software versions

NEVER use when:

  • User wants to manage git tags directly (use git commands)
  • User wants CI/CD operations (use gitlab-ci instead)

Available Commands

List Releases

glab release list [options]

Options:

FlagDescription
-P, --per-page=<n>Results per page
--allGet all releases

Examples:

# List all releases
glab release list

# List with more results
glab release list --per-page=50

View Release Details

glab release view <tag> [options]

Options:

FlagDescription
-w, --webOpen release in browser

Examples:

# View release details
glab release view v1.0.0

# Open release in browser
glab release view v1.0.0 --web

Create Release

glab release create <tag> [options]

Options:

FlagDescription
-n, --notes=<notes>Release notes
-F, --notes-file=<file>Read release notes from file
-N, --name=<name>Release name (defaults to tag)
-r, --ref=<ref>Git ref to create tag from (if tag doesn't exist)
-a, --assets-links=<json>JSON array of asset links
--milestone=<titles>Milestone titles to associate

Examples:

# Create simple release
glab release create v1.0.0

# Create with release notes
glab release create v1.0.0 -n "## What's New
- Feature A
- Bug fix B"

# Create with notes from file
glab release create v1.0.0 -F CHANGELOG.md

# Create with name and milestone
glab release create v1.0.0 -N "Version 1.0.0" --milestone="Sprint 5"

# Create from specific commit
glab release create v1.0.0 -r abc123def

Upload Assets

glab release upload <tag> <file>... [options]

Upload files as release assets.

Examples:

# Upload single file
glab release upload v1.0.0 ./dist/app.zip

# Upload multiple files
glab release upload v1.0.0 ./dist/*.tar.gz

# Upload with custom name
glab release upload v1.0.0 ./build/app.exe#windows-binary

Download Assets

glab release download <tag> [options]

Options:

FlagDescription
-D, --dir=<dir>Download directory
-n, --asset-name=<name>Download specific asset by name

Examples:

# Download all assets
glab release download v1.0.0

# Download to specific directory
glab release download v1.0.0 -D ./downloads/

# Download specific asset
glab release download v1.0.0 -n "app.zip"

Delete Release

glab release delete <tag> [options]

Options:

FlagDescription
-y, --yesSkip confirmation
--with-tagAlso delete the associated tag

Warning: This permanently deletes the release.

Examples:

# Delete release (prompts for confirmation)
glab release delete v1.0.0

# Delete release and tag
glab release delete v1.0.0 --with-tag

# Delete without confirmation
glab release delete v1.0.0 --yes

Common Workflows

Workflow 1: Standard Release

# 1. Ensure all changes are merged
glab mr list --state=opened

# 2. Verify CI passes
glab ci status --branch=main

# 3. Create release with changelog
glab release create v1.2.0 -F CHANGELOG.md -N "Version 1.2.0"

# 4. Upload binaries
glab release upload v1.2.0 ./dist/*

Workflow 2: Pre-release

# Create pre-release version
glab release create v2.0.0-beta.1 \
  -n "Beta release for testing. Not for production use."

Workflow 3: Hotfix Release

# 1. Create release from hotfix branch
glab release create v1.0.1 -r hotfix/critical-fix \
  -n "Hotfix release:
- Fixed critical security issue"

# 2. Upload patched binaries
glab release upload v1.0.1 ./dist/*

Release Notes Best Practices

Structure your release notes:

## What's New
- Feature descriptions

## Bug Fixes
- Fix descriptions

## Breaking Changes
- Migration notes

## Contributors
- @username

Troubleshooting

IssueCauseSolution
Authentication failedInvalid/expired tokenRun glab auth login
Tag already existsDuplicate releaseUse different tag or delete existing
Release not foundInvalid tagVerify tag with glab release list
Upload failedFile not foundCheck file path exists

Related Documentation

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/grandcamel/gitlab-assistant-skills/gitlab-release">View gitlab-release on skillZs</a>