rate-limiting

Rate Limitingとクォータ管理のベストプラクティスを提供するスキル。サーバー側のAPI保護とクライアント側の429対応の両方をカバーし、Token Bucket、Sliding Window等のアルゴリズム選定から実装までを支援。Anchors:• 『Designing Data-Intensive Applications』(Kleppmann)/ 適用: 分散システムのRate Limiting / 目的: スケーラブルな設計• 『API Design Patterns』(Geewax)/ 適用: API保護 / 目的: RESTful APIのベストプラクティス• RFC 6585 / 適用: 429 Too Many Requests / 目的: 標準準拠のレスポンス設計Trigger:Use when designing API rate limiting, implementing DoS protection, handling external API rate limits, or managing quota systems.rate limiting, rate limiter, throttling, 429, token bucket, sliding window, quota, api protection

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026

When & Why to Use This Skill

This Claude skill provides comprehensive guidance and implementation support for API rate limiting and quota management. It covers both server-side protection (DoS prevention) and client-side 429 error handling, utilizing industry-standard algorithms like Token Bucket and Sliding Window to ensure scalable, resilient, and standard-compliant API architectures.

Use Cases

  • Designing robust server-side API protection layers to prevent resource exhaustion and mitigate DoS attacks.
  • Implementing client-side logic to gracefully handle '429 Too Many Requests' errors using exponential backoff and retry strategies.
  • Evaluating and selecting the most suitable rate-limiting algorithms (e.g., Token Bucket, Leaky Bucket, Sliding Window) based on specific system requirements and burst tolerance.
  • Standardizing API response headers (X-RateLimit-*, Retry-After) to improve developer experience and ensure consistent client-server communication.
  • Architecting distributed rate-limiting systems using shared storage like Redis to maintain consistency across multiple service instances.
namerate-limiting
description|
• 『Designing Data-Intensive Applications』(Kleppmann)/ 適用分散システムのRate Limiting / 目的: スケーラブルな設計
• 『API Design Patterns』(Geewax)/ 適用API保護 / 目的: RESTful APIのベストプラクティス
• RFC 6585 / 適用429 Too Many Requests / 目的: 標準準拠のレスポンス設計

Rate Limiting

概要

Rate Limitingとクォータ管理のベストプラクティスを提供するスキル。サーバー側のAPI保護(DoS対策)とクライアント側の外部API対応の両面から、適切なアルゴリズム選定と実装パターンを支援します。

ワークフロー

Phase 1: 要件分析

目的: Rate Limitingの要件と適用範囲を明確化する

アクション:

  1. 保護対象(API、エンドポイント、ユーザー種別)を特定
  2. サーバー側保護かクライアント側対応かを判断
  3. 制限粒度(IP、ユーザー、API Key)を決定

Task: agents/analyze-requirements.md を参照

Phase 2: アルゴリズム選定

目的: 要件に適したRate Limitingアルゴリズムを選定する

アクション:

  1. Token Bucket、Leaky Bucket、Sliding Window等を比較
  2. バースト許容度、分散環境対応を考慮
  3. ストレージ要件(Redis、メモリ)を検討

Task: agents/select-algorithm.md を参照

Phase 3: 実装

目的: 選定したアルゴリズムを実装する

アクション:

  1. Rate Limiterミドルウェアを実装
  2. 適切なHTTPヘッダー(X-RateLimit-*、Retry-After)を設定
  3. クライアント側の429対応とExponential Backoffを実装

Task: agents/implement-limiter.md を参照

Phase 4: 検証とモニタリング

目的: Rate Limitingの効果を検証しモニタリングを設定する

アクション:

  1. 負荷テストでRate Limitingの動作を確認
  2. レート制限のメトリクスを収集
  3. アラート閾値を設定

Task: agents/validate-limiter.md を参照

Task仕様ナビ

Task 起動タイミング 入力 出力
analyze-requirements Phase 1開始時 システム要件 要件定義書
select-algorithm Phase 2開始時 要件定義書 アルゴリズム選定書
implement-limiter Phase 3開始時 アルゴリズム選定書 Rate Limiter実装
validate-limiter Phase 4開始時 Rate Limiter実装 検証レポート

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

ベストプラクティス

すべきこと

推奨事項 理由
X-RateLimit-* ヘッダーを返す クライアントが残り回数を把握可能
Retry-Afterヘッダーを429に含める クライアントが適切に待機可能
Token BucketでバーストをGraceful許容 一時的なスパイクに柔軟対応
Redisで分散環境のカウンターを共有 複数インスタンス間で一貫性確保
Exponential Backoffで429をリトライ サーバー負荷を軽減しつつ成功率向上

避けるべきこと

禁止事項 問題点
429エラーを即座にリトライ サーバー負荷増大、Ban対象に
Rate Limitヘッダーを無視 無駄なリクエストで制限到達
固定間隔でのリトライ サンダリングハード問題発生
メモリ内カウンターのみ サーバー再起動でリセット
エンドユーザーにレート制限を隠す UX悪化、問い合わせ増加

リソース参照

references/(詳細知識)

リソース パス 読込条件
アルゴリズム比較 references/algorithms.md アルゴリズム選定時
サーバー実装 references/server-implementation.md サーバー側実装時
クライアント対応 references/client-handling.md クライアント側実装時
クォータ管理 references/quota-management.md クォータシステム設計時

scripts/(決定論的処理)

スクリプト 機能
scripts/simulate-rate-limit.mjs Rate Limitingシミュレーション
scripts/log_usage.mjs スキル使用履歴の記録

assets/(テンプレート)

アセット 用途
assets/rate-limiter-template.ts Rate Limiterミドルウェア雛形

変更履歴

Version Date Changes
3.1.0 2026-01-02 agents/追加(4エージェント体制確立)
3.0.0 2026-01-02 18-skills.md仕様完全準拠、Task仕様ナビ追加
1.1.0 2025-12-24 仕様整合