release-workflow — community release-workflow, peek-stash-browser, community, ide skills, Claude Code, Cursor, Windsurf

v1.0.0
GitHub

About this Skill

Ideal for DevOps Agents requiring automated Docker image publishing and version management Media browser app for Stash with multiple users, playlists, and UI customization

carrotwaxr carrotwaxr
[25]
[4]
Updated: 2/27/2026

Agent Capability Analysis

The release-workflow skill by carrotwaxr is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance.

Ideal Agent Persona

Ideal for DevOps Agents requiring automated Docker image publishing and version management

Core Value

Empowers agents to automate release workflows using GitHub Actions, triggering builds and publishes Docker images to Docker Hub upon git tag pushes, while maintaining a consistent version scheme across client and server package.json files

↓ Capabilities Granted for release-workflow

Automating Docker image publishing
Validating pre-release versions
Managing beta releases with custom tagging

! Prerequisites & Limits

  • Requires GitHub repository access
  • Dependent on GitHub Actions and Docker Hub integration
  • Version scheme must be strictly followed across package.json files
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

release-workflow

Install release-workflow, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

Release Workflow

Overview

Releases are triggered by pushing git tags. GitHub Actions builds and publishes Docker images automatically.

Pre-release validation → Version bump → Commit → Tag → Push → GitHub Actions → Docker Hub

Version Scheme

  • Stable: X.Y.Z (e.g., 3.3.1)
  • Beta: X.Y.Z-beta.N (e.g., 3.3.2-beta.1)
  • Tag format: vX.Y.Z or vX.Y.Z-beta.N

Both client/package.json and server/package.json must always have identical versions.

Step 1: Pre-Release Validation

Run /pre-release to execute all checks:

  1. Server unit tests: cd server && npm test
  2. Server linting: cd server && npm run lint
  3. Client unit tests: cd client && npm test
  4. Client linting: cd client && npm run lint
  5. Integration tests: cd server && npm run test:integration
  6. Client build: cd client && npm run build
  7. Docker production build: docker build -f Dockerfile.production -t peek:test .

All 7 checks must pass before proceeding.

Step 2: Version Bump & Tag

Beta Release

Run /release-beta:

  • Increment beta number: 3.3.2-beta.1 → 3.3.2-beta.2
  • Or start new beta: 3.3.1 → 3.3.2-beta.1

Stable Release

Run /release-stable:

  • Remove beta suffix: 3.3.2-beta.8 → 3.3.2
  • Or increment: 3.3.2 → 3.3.3 or 3.4.0

What the Release Skills Do

  1. Verify on main branch and up to date
  2. Update version in client/package.json and server/package.json
  3. Commit: chore: bump version to X.Y.Z
  4. Push commit to main
  5. Create tag: git tag vX.Y.Z
  6. Push tag: git push origin vX.Y.Z

Step 3: Automated CI/CD

GitHub Actions (.github/workflows/docker-build.yml) triggers on v* tags:

  1. Build: Multi-stage Dockerfile.production (frontend → backend → runtime)
  2. Platforms: linux/amd64 + linux/arm64
  3. Push to Docker Hub: carrotwaxr/peek-stash-browser
  4. Tag strategy:
    • Semver: 3.3.2
    • Major.minor: 3.3
    • latest (stable releases only)
    • stable (stable releases only)
    • beta (beta releases only)
  5. GitHub Release: Auto-created with generated release notes, marked as prerelease if beta

Docker Hub Tags After Release

Release TypeTags Applied
v3.3.2 (stable)3.3.2, 3.3, latest, stable
v3.3.2-beta.13.3.2-beta.1, beta

Updating on unRAID

After GitHub Actions completes:

bash
1# SSH to your deployment server
2ssh root@<server-ip>
3
4# Pull new image
5docker pull carrotwaxr/peek-stash-browser:latest  # or :beta
6
7# Restart container via unRAID WebGUI or CLI
8docker stop peek-stash-browser && docker start peek-stash-browser

Semantic Versioning Guide

  • Patch (3.3.X): Bug fixes, minor tweaks, no new features
  • Minor (3.X.0): New features, backward-compatible changes
  • Major (X.0.0): Breaking changes (rare — major UI overhauls, API changes)

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is release-workflow?

Ideal for DevOps Agents requiring automated Docker image publishing and version management Media browser app for Stash with multiple users, playlists, and UI customization

How do I install release-workflow?

Run the command: npx killer-skills add carrotwaxr/peek-stash-browser. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for release-workflow?

Key use cases include: Automating Docker image publishing, Validating pre-release versions, Managing beta releases with custom tagging.

Which IDEs are compatible with release-workflow?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for release-workflow?

Requires GitHub repository access. Dependent on GitHub Actions and Docker Hub integration. Version scheme must be strictly followed across package.json files.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add carrotwaxr/peek-stash-browser. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use release-workflow immediately in the current project.

Related Skills

Looking for an alternative to release-workflow or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

★ 138.4k
⑂ 0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI