Gitlab release
Skill grandcamel/GitLab-Assistant-Skills/skills/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.From its SKILL.md
npx -y skills add grandcamel/GitLab-Assistant-Skills --skill gitlab-releaseAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
5.5 KB, as published. Nobody here has run it
Release Skill
Release operations for GitLab using the glab CLI.
Quick Reference
| Operation | Command | Risk |
|---|---|---|
| List releases | glab release list | - |
| View release | glab release view <tag> | - |
| Create release | glab release create <tag> | ⚠️ |
| Upload assets | glab release upload <tag> <files> | ⚠️ |
| Download assets | glab release download <tag> | - |
| Delete release | glab 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:
| Flag | Description |
|---|---|
-P, --per-page=<n> | Results per page |
--all | Get 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:
| Flag | Description |
|---|---|
-w, --web | Open 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:
| Flag | Description |
|---|---|
-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:
| Flag | Description |
|---|---|
-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:
| Flag | Description |
|---|---|
-y, --yes | Skip confirmation |
--with-tag | Also 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
| Issue | Cause | Solution |
|---|---|---|
| Authentication failed | Invalid/expired token | Run glab auth login |
| Tag already exists | Duplicate release | Use different tag or delete existing |
| Release not found | Invalid tag | Verify tag with glab release list |
| Upload failed | File not found | Check file path exists |