hotfix

A workflow skill for urgent, highest-priority production fixes. It creates a hotfix branch, applies only the necessary change, runs a critical-path check, and prepares the change for release.

In plain words
What is it for?
Use it for P0 production incidents, minimal bug fixes, smoke testing, merging the fix into the main branch, tagging a release, and pushing the result.
Why use it?
It provides a short, controlled path for incidents such as a serious outage or risk of data loss, while requiring a write plan before files are changed.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/fall-out-bug/sdp/hotfix
Any agent
npx skills add fall-out-bug/sdp --skill hotfix
Clone the repo
git clone --depth 1 https://github.com/fall-out-bug/sdp

Made for: Claude Code, Codex.

Per session 23 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 672 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00023 $0.00672
Opus 5 $0.00012 $0.00336
Sonnet 5 $0.00005 $0.00134
Haiku 4.5 $0.00002 $0.00067

Measured 2d ago against content hash b4a2ce39e8c5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

hotfix scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

prompts/skills/hotfix/SKILL.md · 64 lines

How it starts

The opening of the file, as written. The whole thing — 64 lines — stays where its author put it; the contents beside it link to each section on GitHub.

@hotfix

Emergency production fixes. Minimal changes, fast testing, merge to master with tag.

When to Use

  • P0 CRITICAL only
  • Production down or severely degraded
  • Data loss/corruption risk

Workflow

  1. Branchgit checkout master && git pull && git checkout -b hotfix/{id}-{slug}
  2. Minimal fix — No refactoring, fix bug only
  3. Smoke test — Critical path verification
  4. Mergegit checkout master && git merge hotfix/{branch} --no-edit
  5. Taggit tag -a v{VERSION} -m "Hotfix: {description}"
  6. Pushgit push origin master --tags

Write Plan (F101)

Before modifying any file, emit a write plan:

  1. Enumerate — List every file the skill will CREATE / MODIFY / DELETE with a one-line reason (fix files and version file).
  2. Flags:
    • --dry-run — Emit write plan only. Do NOT create, modify, or delete any file.
    • --yes — Skip confirmation prompt. Execute immediately. Intended for CI/non-interactive.
  3. Confirm — Present the plan to the user and wait for explicit approval (unless --yes).
  4. Log — Append write plan event to .sdp/log/events.jsonl (sanitize file paths before logging: strip newlines, ensure valid JSON escaping):
    {"spec_version":"v1.0","event_id":"<uuid>","timestamp":"<ISO-8601>","source":{"system":"sdp-lab","component":"hotfix"},"event_type":"decision.made","payload":{"decision_type":"write_plan","plan":[{"path":"...","action":"CREATE|MODIFY|DELETE","reason":"..."}]},"context":{"feature_id":"<F-id if known>","workstream_id":"<ws-id if applicable>"}}
    
    Include context fields only when the ID is known at plan time. Omit unavailable fields rather than inventing placeholders.

    Note: Phase 1 uses prompt-level write boundaries (CLI out of scope). Aligns with sdp/schema/contracts/orchestration-event.schema.json via event_type: "decision.made". Phase 2 CLI will emit natively.

Output format:

WRITE PLAN for @hotfix <target>:
  CREATE: path/to/new/file — <reason>
  MODIFY: path/to/existing/file — <reason>
  DELETE: path/to/removed/file — <reason>

Proceed? [y/n]

Read the full file on GitHub · 64 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 64 lines · 23 tokens per session scan A b4a2ce39e8c5

Subscribe to this mod's changes

hotfix is a skill published in the GitHub repository fall-out-bug/sdp (19 stars, last pushed 2mo ago), licensed MIT. It adds 23 tokens to every session and 672 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

release-swift

Cut a release of OpenUsage (Swift menu-bar app): pick a version, generate a categorized changelog, tag from main, and publish the GitHub Release with notes. Use to ship an Early Access beta or a stable release.

robinebers/openusage · 0 tokens

skillshare-release

End-to-end release workflow for skillshare. Runs tests, generates changelog (via /changelog), optionally writes local RELEASENOTES, updates version numbers, commits, and drafts announcements. Use when the user says "release", "prepare release", "cut a release", "release v0.19", or any request to publish a new version.…

runkids/skillshare · 87 tokens

github-release-briefing-skill

Create a source-linked briefing for the latest published GitHub release of a public repository. Use for engineering teams tracking a dependency release; do not use it to publish releases or change repositories.

FrancyJGLisboa/agent-skill-creator · 45 tokens

release

Create a new release for grepai. Checks CI, determines version type, updates CHANGELOG and documentation, credits contributors, and creates GitHub release.

yoanbernabeu/grepai · 32 tokens

ship

Land completed Fallow work after review, run pre-push parity, monitor merged-commit CI, and leave repositories clean. Use when asked to ship, merge, or move approved work to main.

fallow-rs/fallow · 42 tokens

macos-packaging-notarization

Prepare macOS packaging and notarization workflows. Use when archiving apps, validating bundles, or explaining distribution-only failures.

robinebers/openusage · 32 tokens