Agent skill

Release Rollback

by Thank-you-Linus in Thank-you-Linus/Linus-Dashboard

Rollback a failed release by deleting tags and reverting version changes.

MITAuto-check passedDevOps & Cloud

Install Release Rollback

skills CLI
$ npx skills add Thank-you-Linus/Linus-Dashboard --skill release-rollback -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Thank-you-Linus/Linus-Dashboard release-rollback --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Thank-you-Linus/Linus-Dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/release-rollback .claude/skills/release-rollback && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
release-rollback
GitHub stars
211
Token cost
~789 tokens
SKILL.md length
344 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Rollback a failed release by deleting tags and reverting version changes.

  • Works in 5 steps: Verify Version to Rollback → Run Rollback Script → What the Script Will Do → …
  • A release fails
  • SKILL.md covers Current Situation Check, Rollback Process, Common Rollback Scenarios and Usage Example, plus 2 more sections
  • Calls npm and git

What it does

Release Rollback is an agent skill from Thank-you-Linus/Linus-Dashboard. Rollback a failed release by deleting tags and reverting version changes. Use when a release fails, needs to be cancelled, or when reverting a problematic release.

Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud. It works with npm and Git. The repository describes itself as: Elevate your smart home experience with a modern, responsive dashboard built on Home Assistant. Effortlessly manage your devices, areas and floors with an intuitive interface…. The licence is MIT.

When your agent uses it

  • A release fails
  • Needs to be cancelled
  • Reverting a problematic release

Example prompts

  • “/release-rollback”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Verify Version to Rollback
  2. Run Rollback Script
  3. What the Script Will Do
  4. After Rollback
  5. Create New Release

What it can do on your machine

Read from SKILL.md and the folder at commit 337c675. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Release Rollback loads about 789 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 344 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~789

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Thank-you-Linus/Linus-Dashboard at commit 337c675, republished under its MIT licence (© Thank-you-Linus). 344 words, ~789 tokens.

Download SKILL.mdSave it as .claude/skills/release-rollback/SKILL.md (or your agent's skills folder).
name
release-rollback
description
Rollback a failed release by deleting tags and reverting version changes. Use when a release fails, needs to be cancelled, or when reverting a problematic release.

Rollback Failed Release

Rollback a failed release by deleting the release and reverting version changes.

⚠️ This will delete the release and revert version changes.


Current Situation Check

Check recent tags:

bash
git tag -l --sort=-version:refname | head -5

Review which version needs to be rolled back.


Rollback Process

Step 1: Verify Version to Rollback

Confirm with the user:

  • What is the version to rollback?
  • Is this the correct version to rollback?
Step 2: Run Rollback Script

Execute the rollback command:

bash
npm run release:rollback <version>

Example:

bash
npm run release:rollback 1.5.0-beta.3
Step 3: What the Script Will Do

The rollback script performs:

  • Delete local git tag for specified version
  • Delete remote git tag for specified version
  • Delete GitHub release for specified version
  • Revert version changes in all files
  • Clean up RELEASE_NOTES files
  • Provide next steps
Step 4: After Rollback

Post-rollback verification:

  1. Check GitHub to confirm release is deleted
  2. Verify tags are removed: git tag -l
  3. Fix the issues that caused the failure
  4. Run: npm run release:check to validate fixes
Step 5: Create New Release

Once issues are fixed, create new release:

  • For beta: Use release-beta skill
  • For stable: Use release-stable skill

Common Rollback Scenarios

Build Failed
  • Fix build errors
  • Run: npm run build to test
  • Run: npm run test:smoke
  • Re-run validation
Linting/Type Errors
  • Run: npm run lint to auto-fix
  • Run: npm run type-check to verify
  • Fix reported issues
  • Re-run validation
Version Mismatch
Validation Failed
  • Run: npm run release:check
  • Address all errors and warnings
  • Fix issues systematically
  • Re-run validation

Usage Example

bash
# Rollback beta release
/release-rollback 2.0.0-beta.3

# Rollback stable release
/release-rollback 1.5.0

This requires the version number to rollback.


Important Notes

  • Destructive operation: Cannot be undone easily
  • Confirm version: Double-check before proceeding
  • Fix root cause: Address the issue that caused failure
  • Re-validate: Run all checks before creating new release
  • Communication: If release was public, inform users

Rollback Checklist

Before proceeding with rollback:

  • Identified the version to rollback
  • Confirmed the version is correct
  • Understood why the release failed
  • Ready to fix the underlying issue

After rollback:

  • Verified tag deletion locally and remotely
  • Confirmed GitHub release deletion
  • Fixed the root cause issue
  • Ran validation checks
  • Ready for new release attempt

© Thank-you-Linus, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/release-rollback of Thank-you-Linus/Linus-Dashboard.

Open the folder on GitHubat commit 337c675

Compare with similar skills

Release Rollback next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Release Rollback compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Release Rollback this skillThank-you-Linus/Linus-Dashboard211—~789Automated safety check: PassMIT
Releasechampionswimmer/pi-context-prune245—~907Automated safety check: PassNone
Publish Releasemolefrog/moi183—~2.5kAutomated safety check: PassCustom licence
Homerail Install Opsxiaotianfotos/homerail994—~2kAutomated safety check: PassMIT
Tokf Runmpecan/tokf199—~571Automated safety check: PassMIT
Portaljs Deploydatopian/portaljs2.4k1 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Release

    championswimmer/pi-context-prune

    Creates a repository release for this Pi package. An agent skill from championswimmer/pi-context-prune.

    245 GitHub stars~907 tokensUpdated 10 days ago
    DevOps & CloudAuto-check passed
  • Publish Release

    molefrog/moi

    Release moi-computer to npm — verify locally, hand off to the gated GitHub Actions workflow, then verify the published package.

    183 GitHub stars~2.5k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Homerail Install Ops

    xiaotianfotos/homerail

    Install, configure, start, verify, update, and troubleshoot a local-source HomeRail deployment for AI-agent use.

    994 GitHub stars~2k tokensUpdated 15 days ago
    DevOps & CloudAuto-check passed
  • Tokf Run

    mpecan/tokf

    Compress verbose CLI output with tokf before returning results.

    199 GitHub stars~571 tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Portaljs Deploy

    datopian/portaljs

    Deploy a PortalJS portal to PortalJS Arc — Datopian-managed static hosting on Cloudflare.

    2.4k GitHub starsUsed in 1 repo~1.4k tokens
    DevOps & CloudAuto-check passed
  • Release

    Sma1lboy/rove

    Autonomously cut a Rove (@sma1lboy/rove) release end-to-end — detect the semver bump from pending changesets (flagging an upstream minor you didn't intend), run the release gates, dispatch the…

    168 GitHub stars~3.1k tokensUpdated today
    DevOps & CloudAuto-check: warnings

More from Thank-you-Linus/Linus-Dashboard

  • Debug

    Thank-you-Linus/Linus-Dashboard

    Debug errors, bugs, and unexpected behavior systematically in Home Assistant integration.

    211 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Implement

    Thank-you-Linus/Linus-Dashboard

    Implement approved plans with precision and quality for Linus Dashboard Home Assistant integration.

    211 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • Release Beta

    Thank-you-Linus/Linus-Dashboard

    Create a beta pre-release for community testing with intelligent version detection.

    211 GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Release Check

    Thank-you-Linus/Linus-Dashboard

    Check if project is ready for release with comprehensive pre-release validation.

    211 GitHub stars~637 tokensUpdated 2 days ago
    Auto-check passed
  • Release Stable

    Thank-you-Linus/Linus-Dashboard

    Create a stable production release with intelligent detection (finalize beta or direct release).

    211 GitHub stars~2.4k tokensUpdated 2 days ago
    Auto-check passed
  • Review

    Thank-you-Linus/Linus-Dashboard

    Review code quality, security, and maintainability before committing.

    211 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed

Works with

Categories

Questions about Release Rollback

What does Release Rollback do?

Rollback a failed release by deleting tags and reverting version changes. Release Rollback is an agent skill from Thank-you-Linus/Linus-Dashboard. Rollback a failed release by deleting tags and reverting version changes.

When should I use Release Rollback?

Release Rollback fits situations like: A release fails; needs to be cancelled; reverting a problematic release.

How do I install Release Rollback in Claude Code?

Run `npx skills add Thank-you-Linus/Linus-Dashboard --skill release-rollback -a claude-code`. Or copy the skill folder (.claude/skills/release-rollback in Thank-you-Linus/Linus-Dashboard) into .claude/skills/release-rollback in your project. Claude Code loads it when a task matches its description.

How do I install Release Rollback in Codex?

Run `npx skills add Thank-you-Linus/Linus-Dashboard --skill release-rollback -a codex`. Or copy the skill folder (.claude/skills/release-rollback in Thank-you-Linus/Linus-Dashboard) into .agents/skills/release-rollback in your project. Codex loads it when a task matches its description.

Can I use Release Rollback in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Thank-you-Linus/Linus-Dashboard --skill release-rollback -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/release-rollback, .gemini/skills/release-rollback, .github/skills/release-rollback and .opencode/skills/release-rollback in your project.

What does Release Rollback need to run?

Going by SKILL.md and its folder, Release Rollback needs the command-line tools its instructions call (npm and git).

Does Release Rollback access the network?

SKILL.md contains no URLs. Its commands use npm and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Release Rollback safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Release Rollback use?

Release Rollback is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Release Rollback use?

About 789 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Release Rollback?

Skills that share tags, products or a category with Release Rollback: Release (championswimmer/pi-context-prune, 245 stars), Publish Release (molefrog/moi, 183 stars), Homerail Install Ops (xiaotianfotos/homerail, 994 stars) and Tokf Run (mpecan/tokf, 199 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Release Rollback?

Thank-you-Linus (a GitHub organization) maintains it in Thank-you-Linus/Linus-Dashboard, which has 211 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

Source: Thank-you-Linus/Linus-Dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.