skills.rest
rustyrazorblade
rustyrazorbladeCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

token-skew

Analyze Cassandra token distribution and data ownership skew across nodes and racks.

41|8|Updated Feb 17, 2026
Search Tags:#cassandra#data-ownership#token-distribution#nodetool#token-skew#cluster-diagnostics#rf-aware
One-click install
npx skills add https://github.com/rustyrazorblade/skills --skill token-skew
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: token-skew
Source: https://github.com/rustyrazorblade/skills/tree/main/plugins/cassandra-expert/skills/token-skew
Command: npx skills add https://github.com/rustyrazorblade/skills --skill token-skew

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze token distribution and data ownership skew across Cassandra nodes and racks, and separate token placement quality from data distribution effects of keyspace replication to guide tuning.

Core Features & Use Cases

  • Phase 1: evaluate token distribution quality across racks to detect token-placement issues.
  • Phase 2: assess data distribution skew per keyspace RF to understand replication-driven imbalances and inform remediation.
  • Use case: diagnose a cluster where ring topology or allocator hints cause hotspots, then plan token rebalancing or replication adjustments.

Quick Start

Run a two-phase analysis on your Cassandra cluster: first evaluate token distribution quality, then assess per-keyspace data distribution skew against rack counts, using nodetool outputs.

Frequently Asked Questions about token-skew

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose token distribution skew across Cassandra nodes and racks?▼

Diagnose Cassandra token distribution skew by running a two-phase analysis that evaluates token placement quality across racks and then assesses data ownership imbalances per keyspace replication factor. The analysis validates findings against nodetool outputs to ensure accurate remediation guidance.

Can I use nodetool outputs to validate Cassandra token skew analysis?▼

Yes, the token skew analysis validates its findings against nodetool outputs and cluster load metrics. This cross-validation guards against misinterpretation of ring topology or allocator hints and ensures that remediation guidance accurately reflects the cluster's actual state.

What is the difference between token placement quality and data distribution skew in Cassandra?▼

Token placement quality refers to how evenly tokens are distributed across nodes and racks, while data distribution skew measures actual data ownership imbalances caused by keyspace replication factors. The analysis separates these two phases to isolate ring topology issues from replication-driven hotspots.

When should I plan token rebalancing for a Cassandra cluster?▼

Plan token rebalancing when Phase 1 analysis detects token-placement issues across racks that cause hotspots, or when Phase 2 reveals replication-driven data distribution skew. Use the validated findings to decide between token rebalancing and keyspace replication factor adjustments.

Related Skills

Explore More Data & Analytics Skills→
rustyrazorbladerustyrazorblade
41

diagnose

Identify Cassandra version and establish a baseline health snapshot for diagnostics.

Community
Advanced
ivanshamaevivanshamaev
14

starrocks-bucketing

Design StarRocks table bucketing with HASH or RANDOM distribution and bucket counts.

Community
Advanced
cockroachdbcockroachdb
32.4k

mma-investigator

Analyze Multi-Metric Allocator behavior in CockroachDB clusters using Datadog metrics and logs.

Official
Advanced
rustyrazorbladerustyrazorblade
41

optimize

Provide version-aware Cassandra configuration and tuning guidance for performance bottlenecks.

Community
Advanced