consumer-group-rebalance-safety SKILL.md skillA

consumer-group-rebalance-safety from himanshuj16/algo-trading-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add himanshuj16/algo-trading-skills/consumer-group-rebalance-safety@v2.0.0

Pins v2.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
himanshuj16/algo-trading-skills
Path
skills/consumer-group-rebalance-safety/SKILL.md
Versions recorded
5
Latest version
v2.0.0, committed Sep 3, 2026
First version recorded
Jul 26, 2026
Size
9,480 bytes
Repository stars
50
License
Apache-2.0

Use when trading workers consume order or tick events from a Kafka consumer group and a rebalance can move a partition mid-flight. Fences revoked partitions, drains in-flight work, and commits the next offset rather than the last processed one.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

## When to Use

Use this skill when worker nodes in an event-driven trading architecture consume from
a Kafka (or Redpanda) **consumer group** and the events drive side effects that must
not happen twice — order submissions, position updates, fills applied to a book.

A rebalance moves partition ownership between members. Between the moment a worker
stops owning a partition and the moment it notices, two failure modes are live:

- **Zombie execution** — the worker keeps submitting orders for a partition another
  member already owns.
- **Duplicate execution** — the new owner replays events the old owner processed but
  never committed.

Both are ordinary consequences of at-least-once delivery, and both are decided by what
happens inside `on_partitions_revoked` / `on_partitions_assigned` / `on_partitions_lost`.
`scripts/rebalance_guard.py` is the state machine that makes that ordering explicit.

## When NOT to Use

- **As a Kafka client.** The guard performs no network I/O. It calls back into
  *your* `commit_fn` and `flush_fn`; you still wire it to `consumer.commit(asynchronous=False)`
  and your executor. Constructed without a `commit_fn`, it fences and drains but
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add himanshuj16/algo-trading-skills/consumer-group-rebalance-safety@sha256:9b25d3b3891ff6bb

The line at the top of this page pins the label v2.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_5za7i3wflgeld4ks.svg)](https://markdownregistry.com/a/art_5za7i3wflgeld4ks)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 26, 2026 and Sep 3, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
v2.0.0 latest2026-09-03 8527a51 9,480 BA view · diff
v2.0.02026-08-22 3ed130d 9,572 BA view · diff
v1.0.02026-08-07 89d1436 3,392 BA view · diff
v1.0.02026-07-30 dfc60c7 3,390 BA view · diff
v1.0.02026-07-26 0100af1 3,404 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9480 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

himanshuj16/algo-trading-skills · 50 stars · license Apache-2.0 · pushed 2026-09-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5za7i3wflgeld4ks
GET https://markdownregistry.com/api/v1/resolve?ref=himanshuj16/algo-trading-skills/consumer-group-rebalance-safety
GET https://markdownregistry.com/api/v1/blob/9b25d3b3891ff6bb3586e74c8169f15a811ed07a4612116cc5918ff6c364a635

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from himanshuj16/algo-trading-skills

algo-trading-skills Cursor rule
himanshuj16/algo-trading-skills · .cursor/rules/algo-trading-skills.mdc · Automatically discover and load algorithmic trading skills from the library in skills/
git:20260903.8527a51 · audit A · 50 stars
AGENTS.md AGENTS.md file
himanshuj16/algo-trading-skills · AGENTS.md
git:20260903.327fc0d · audit A · 50 stars
CLAUDE.md CLAUDE.md file
himanshuj16/algo-trading-skills · CLAUDE.md
git:20260907.26c257b · audit A · 50 stars
llms-full.txt llms.txt file
himanshuj16/algo-trading-skills · llms-full.txt
git:20260903.327fc0d · audit A · 50 stars
llms.txt llms.txt file
himanshuj16/algo-trading-skills · llms.txt
git:20260903.8527a51 · audit A · 50 stars
adaptive-batch-size-tuning-under-load SKILL.md skill
himanshuj16/algo-trading-skills · skills/adaptive-batch-size-tuning-under-load/SKILL.md · Use when writing high-volume ticks or order logs into TimescaleDB, ClickHouse or Kafka and one static batch size either…
v2.0.0 · audit A · 50 stars
adaptive-execution-under-volatility-spikes SKILL.md skill
himanshuj16/algo-trading-skills · skills/adaptive-execution-under-volatility-spikes/SKILL.md · Use before each child-order decision in a TWAP, VWAP or POV schedule when a volatility spike should bound…
v1.2.0 · audit A · 50 stars
adaptive-sampling-under-extreme-tick-rates SKILL.md skill
himanshuj16/algo-trading-skills · skills/adaptive-sampling-under-extreme-tick-rates/SKILL.md · Use when a trade-tick stream exceeds a consumer's measured processing ceiling and you must emit 1:N samples that still…
v1.2.0 · audit A · 50 stars
adjusted-vs-unadjusted-price-series-pitfalls SKILL.md skill
himanshuj16/algo-trading-skills · skills/adjusted-vs-unadjusted-price-series-pitfalls/SKILL.md · Use before loading historical OHLCV into a backtest, to declare and verify the adjustment mode; separates raw…
v1.3.0 · audit A · 50 stars
adversarial-robustness-of-trading-signals SKILL.md skill
himanshuj16/algo-trading-skills · skills/adversarial-robustness-of-trading-signals/SKILL.md · Use before promoting an ML trading signal, to measure how often epsilon-bounded feature perturbations flip its output…
v1.3.0 · audit A · 50 stars
adverse-selection-measurement-for-passive-orders SKILL.md skill
himanshuj16/algo-trading-skills · skills/adverse-selection-measurement-for-passive-orders/SKILL.md · Use when passive fills keep happening just before the market moves against you, measuring forward markouts in basis…
v1.3.0 · audit A · 50 stars
air-gapped-signing-workflow-for-cold-storage SKILL.md skill
himanshuj16/algo-trading-skills · skills/air-gapped-signing-workflow-for-cold-storage/SKILL.md · Use when moving crypto out of cold storage and the signing key must never touch an internet-connected machine; models…
v2.0.0 · audit A · 50 stars

Every file in himanshuj16/algo-trading-skills

Browse by kind, by grade A, or by owner.