Agent skill

Hotfix Deploy

by hmislk in hmislk/hmis

Full hotfix workflow for deploying urgent fixes to a production branch (coop-prod, ruhunu-prod, southernlanka-prod, etc.).

GPL-3.0Auto-check: notesDevOps & Cloud

Install Hotfix Deploy

skills CLI
$ npx skills add hmislk/hmis --skill hotfix-deploy -a claude-code

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

GitHub CLI
$ gh skill install hmislk/hmis hotfix-deploy --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/hmislk/hmis.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/hotfix-deploy .claude/skills/hotfix-deploy && 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
hotfix-deploy
GitHub stars
236
Token cost
~953 tokens
SKILL.md length
276 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
GPL-3.0

At a glance

Full hotfix workflow for deploying urgent fixes to a production branch (coop-prod, ruhunu-prod, southernlanka-prod, etc.).

  • Works in 9 steps: Stash Any Uncommitted Work → Create Hotfix Branch from Production → Apply the Fix → …
  • You need to apply an urgent fix directly to a production environment without going through the normal development → QA → prod pipeline
  • SKILL.md covers Arguments, Critical Rule, Step 1 — Stash Any Uncommitted… and Step 2 — Create Hotfix Branch…, plus 9 more sections
  • Calls git and gh

What it does

Hotfix Deploy is an agent skill from hmislk/hmis. Full hotfix workflow for deploying urgent fixes to a production branch (coop-prod, ruhunu-prod, southernlanka-prod, etc.). Covers branch creation, fix, commit, push, and PR targeting the production branch. Use when you need to apply an urgent fix directly to a production environment without going through the normal development → QA → prod pipeline. The agent may invoke this on its own judgment to prepare a hotfix (branch, fix, commit, push, PR) — merging the PR, which is what actually triggers CI/CD deployment…

Its SKILL.md is about 950 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, covering Deployment and CI/CD. The repository describes itself as: This is an Open Source Java EE based Hospital Information Management System. The licence is GPL-3.0.

When your agent uses it

  • You need to apply an urgent fix directly to a production environment without going through the normal development → QA → prod pipeline
  • CI/CD deployment
  • Remains a manual human action

Example prompts

  • “/hotfix-deploy”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Grep, Edit, Write

Workflow steps

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

  1. Stash Any Uncommitted Work
  2. Create Hotfix Branch from Production
  3. Apply the Fix
  4. Pre-Commit Checklist
  5. Commit
  6. Push
  7. Create PR Targeting the Production Branch
  8. Restore Stashed Work
  9. Clean Up Old Branch (Post-Merge)

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep
    • Edit
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use git and gh, 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

Hotfix Deploy loads about 953 tokens when it runs. Until then it costs about 140 tokens; SKILL.md has 276 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep, Edit, Write

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 hmislk/hmis at commit d5d2020, republished under its GPL-3.0 licence (© hmislk). 276 words, ~953 tokens.

Download SKILL.mdSave it as .claude/skills/hotfix-deploy/SKILL.md (or your agent's skills folder).
name
hotfix-deploy
description
Full hotfix workflow for deploying urgent fixes to a production branch (coop-prod, ruhunu-prod, southernlanka-prod, etc.). Covers branch creation, fix, commit, push, and PR targeting the production branch. Use when you need to apply an urgent fix directly to a production environment without going through the normal development → QA → prod pipeline. The agent may invoke this on its own judgment to prepare a hotfix (branch, fix, commit, push, PR) — merging the PR, which is what actually triggers CI/CD deployment, remains a manual human action.
allowed-tools
Bash, Read, Grep, Edit, Write
argument-hint
<prod-branch> <description>

Hotfix Deployment Workflow

Deploy an urgent fix directly to a production branch.

Arguments

  • $0 — Target production branch (e.g., coop-prod, ruhunu-prod, southernlanka-prod)
  • $1 — Short description of the fix (e.g., sequence-preallocation, critical-billing-fix)

Critical Rule

The branch name MUST end with -hotfix. CI merge validation will block PRs from branches that do not end with -hotfix.

Step 1 — Stash Any Uncommitted Work

bash
git stash

Step 2 — Create Hotfix Branch from Production

bash
git fetch origin
git checkout -b $1-hotfix origin/$0

Branch name format: <description>-hotfix

Examples:

  • sequence-preallocation-hotfix
  • critical-billing-fix-hotfix
  • persistence-tuning-hotfix

Step 3 — Apply the Fix

Make only the minimal changes required. Do NOT port unrelated features or refactors.

Before editing persistence.xml, compare against the target production branch to understand the current state:

bash
git show origin/$0:src/main/resources/META-INF/persistence.xml

Step 4 — Pre-Commit Checklist

  • persistence.xml uses ${JDBC_DATASOURCE} / ${JDBC_AUDIT_DATASOURCE} — not hardcoded JNDI names (e.g., jdbc/coop)
  • No credentials or sensitive files staged
  • Changes are minimal — only what is needed for the hotfix

Note: The persistence.xml on production branches typically uses ${JDBC_DATASOURCE} environment variable placeholders, while the local development persistence.xml has hardcoded JNDI names (e.g., jdbc/coop). Never copy the hardcoded JNDI name into the production branch.

Step 5 — Commit

bash
git add <changed-files>
git commit -m "fix: <description of fix>

<Explanation of why this was needed and what it fixes.>
References issues #NNNN.

Co-Authored-By: Codex <noreply@openai.com>"

Step 6 — Push

bash
git push origin $1-hotfix

Step 7 — Create PR Targeting the Production Branch

bash
gh pr create \
  --title "fix: <description>" \
  --base $0 \
  --head $1-hotfix \
  --body "..."

The PR must target $0 (the production branch), not development or master.

The body is public: state the defect, the fix and the deploy note, and keep the affected hospital's record counts, production bill numbers, schema names and data-fix steps out of it. See What May Go Into a GitHub Issue, PR, or Comment.

Step 8 — Restore Stashed Work

bash
git checkout <your-previous-branch>
git stash pop

Step 9 — Clean Up Old Branch (Post-Merge)

After the PR is merged:

bash
git branch -d $1-hotfix

Common Production Branches

Hospital/EnvironmentBranch
COOP hospitalscoop-prod
Ruhunu hospitalruhunu-prod
Southern Lankasouthernlanka-prod

Reference

© hmislk, GPL-3.0. 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 .codex/skills/hotfix-deploy of hmislk/hmis.

Open the folder on GitHubat commit d5d2020

Compare with similar skills

Hotfix Deploy 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.

Hotfix Deploy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hotfix Deploy this skillhmislk/hmis236—~953Automated safety check: NotesGPL-3.0
Senior DevOps Toolkitmaslennikov-ig/claude-code-orchestrator-kit2606 repos~1.1kAutomated safety check: NotesCustom licence
AI News RadarLearnPrompt/ai-news-radar1.8k—~2.5kAutomated safety check: NotesMIT
Use Vercel Actionamondnet/vercel-action764—~2.7kAutomated safety check: PassMIT
CI CD And Automationdzhalaevd/Donatello1357 repos~2.7kAutomated safety check: NotesApache-2.0
NGINX Ingress CI Pipelinesnginx/kubernetes-ingress5.1k—~5kAutomated safety check: PassApache-2.0

Similar skills

  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    260 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes
  • AI News Radar

    LearnPrompt/ai-news-radar

    A skill your agent uses when working on AI News Radar, 24 小时 AI 更新雷达, AI 更新雷达, 伯乐Skill, or Scout Skill: finding high-signal AI/tech sources, adding RSS/OPML/GitHub feeds, checking source health…

    1.8k GitHub stars~2.5k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Use Vercel Action

    amondnet/vercel-action

    Wire amondnet/vercel-action into a GitHub Actions workflow to deploy Vercel projects from CI.

    764 GitHub stars~2.7k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • CI CD And Automation

    dzhalaevd/Donatello

    Automates CI/CD pipeline setup. An agent skill from dzhalaevd/Donatello.

    135 GitHub starsUsed in 7 repos~2.7k tokens
    DevOps & CloudAuto-check: notes
  • NGINX Ingress CI Pipelines

    nginx/kubernetes-ingress

    Explains how the NGINX Ingress Controller's GitHub Actions workflows, reusable workflows, build matrices and release pipeline fit together across two repositories.

    5.1k GitHub stars~5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Prepare Cloudflare Production Deployment

    LubomirGeorgiev/cloudflare-workers-nextjs-saas-template

    Source-of-truth runbook for preparing this Vinext Cloudflare Workers SaaS template for production deployment.

    786 GitHub stars~5.9k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes

More from hmislk/hmis

All 33 skills in this repo
  • API Usage

    hmislk/hmis

    Reference for calling existing HMIS REST APIs. An agent skill from hmislk/hmis.

    236 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Application configuration options reference for the HMIS project.

    236 GitHub stars~474 tokensUpdated today
    Auto-check passed
  • Caveman

    hmislk/hmis

    Ultra-compressed communication mode. An agent skill from hmislk/hmis.

    236 GitHub starsUsed in 21 repos~946 tokens
    Auto-check passed
  • Database Guide

    hmislk/hmis

    MySQL database development guide for the HMIS project. An agent skill from hmislk/hmis.

    236 GitHub stars~664 tokensUpdated today
    Auto-check passed
  • Demo Video

    hmislk/hmis

    A skill your agent uses when asked to make a demo, training, how-to or tutorial video with sound or voice-over showing an HMIS function or configuration (e.g.

    236 GitHub stars~3.9k tokensUpdated today
    Auto-check passed
  • Deploy QA

    hmislk/hmis

    Sync development into QA/testing environment branches (QA1-QA4, local RH staging) via PR + merge on GitHub.

    236 GitHub stars~2.1k tokensUpdated today
    Auto-check: notes

Categories

Questions about Hotfix Deploy

What does Hotfix Deploy do?

Full hotfix workflow for deploying urgent fixes to a production branch (coop-prod, ruhunu-prod, southernlanka-prod, etc.). Hotfix Deploy is an agent skill from hmislk/hmis.).

When should I use Hotfix Deploy?

Hotfix Deploy fits situations like: you need to apply an urgent fix directly to a production environment without going through the normal development → QA → prod pipeline; CI/CD deployment; remains a manual human action.

How do I install Hotfix Deploy in Claude Code?

Run `npx skills add hmislk/hmis --skill hotfix-deploy -a claude-code`. Or copy the skill folder (.codex/skills/hotfix-deploy in hmislk/hmis) into .claude/skills/hotfix-deploy in your project. Claude Code loads it when a task matches its description.

How do I install Hotfix Deploy in Codex?

Run `npx skills add hmislk/hmis --skill hotfix-deploy -a codex`. Or copy the skill folder (.codex/skills/hotfix-deploy in hmislk/hmis) into .agents/skills/hotfix-deploy in your project. Codex loads it when a task matches its description.

Can I use Hotfix Deploy 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 hmislk/hmis --skill hotfix-deploy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hotfix-deploy, .gemini/skills/hotfix-deploy, .github/skills/hotfix-deploy and .opencode/skills/hotfix-deploy in your project.

What does Hotfix Deploy need to run?

Going by SKILL.md and its folder, Hotfix Deploy needs the command-line tools its instructions call (git and gh). Its frontmatter pre-approves these tools: Bash, Read, Grep, Edit, Write.

Does Hotfix Deploy access the network?

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

Is Hotfix Deploy safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Hotfix Deploy use?

Hotfix Deploy is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hotfix Deploy use?

About 953 tokens (SKILL.md is roughly 3.8k 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 Hotfix Deploy?

Skills that share tags, products or a category with Hotfix Deploy: Senior DevOps Toolkit (maslennikov-ig/claude-code-orchestrator-kit, 260 stars), AI News Radar (LearnPrompt/ai-news-radar, 1.8k stars), Use Vercel Action (amondnet/vercel-action, 764 stars) and CI CD And Automation (dzhalaevd/Donatello, 135 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hotfix Deploy?

hmislk (a GitHub organization) maintains it in hmislk/hmis, which has 236 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 8, 2026.

Source: hmislk/hmis on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.