scalability-playbook

Identifies performance bottlenecks and produces ordered scaling strategies with triggers, phases, and cost estimates.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/zinohome/RTMessage --skill scalability-playbook-zinohome
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scalability-playbook
Source: https://github.com/zinohome/RTMessage/tree/main/.github/skills/scalability-playbook
Command: npx skills add https://github.com/zinohome/RTMessage --skill scalability-playbook-zinohome

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering teams often scale reactively or guess at infrastructure changes, wasting money on the wrong fixes. This Skill provides a systematic method to measure bottlenecks, prioritize scaling actions by ROI, and plan growth from 1x to 1000x traffic. ## Core Features & Use Cases - Bottleneck Analysis: Profiles current system metrics (traffic, query latency, CPU, cache hit rate) and maps each symptom to a measurable trigger threshold. - Ordered Scaling Strategies: Organizes fixes into four levels from quick wins (indexes, Redis caching) to architecture changes (sharding, event-driven design), each with expected impact, cost, and effort. - Phased Growth Plans: Provides 10x, 100x, and 1000x roadmaps with timelines, cost projections, load testing commands, and a cost-benefit ROI table. - Use Case: Your API's p95 latency just crossed 500ms and CPU is at 70%. Use this Skill to identify the database as the bottleneck, apply indexes and Redis caching first, then schedule read replicas before hitting critical thresholds. ## Quick Start Ask the AI to analyze your system's current performance metrics and generate a phased scalability plan with triggers and cost estimates.

Frequently Asked Questions about scalability-playbook

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

FAQPage Schema
How do I identify performance bottlenecks in my web application?▼

Start by profiling current metrics: request rate, p95 latency, CPU, memory, database query time, and cache hit rate. Map each symptom to a measurement, then assign trigger thresholds (warning and critical) so you know exactly when to act on each bottleneck.

What scaling strategies should I apply first for a slow database?▼

Start with low-cost quick wins: add database indexes on frequently queried columns and introduce a Redis caching layer for repeated reads. These typically deliver 60-80% improvement for under $50/month before considering read replicas or sharding.

When should I use database sharding versus read replicas?▼

Use read replicas first for read-heavy workloads since they are cheaper and take about a week to deploy. Reserve sharding for when a single database exceeds storage or write capacity limits, as it costs more and requires months of effort.

How do I plan capacity for 10x traffic growth?▼

Follow a phased plan: add indexes and caching in weeks 1-2, read replicas by week 4, horizontal app servers by week 6, and a CDN by week 8. Validate each step with load testing tools like hey at 10x concurrency before production rollout.

What metrics should trigger scaling actions?▼

Key triggers include CPU above 70%, memory above 75%, database connections above 40, query p95 above 500ms, queue depth above 1000, and error rate above 1%. Each threshold maps to a specific action such as adding servers, replicas, indexes, or workers.