Rate Limiting Design

Rate limiting strategies (token bucket, sliding window, quota), DOS protection, and fair usage.

48 stars 10 forksOther Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add sethdford/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sethdford/claude-skills --skill rate-limiting-design
Manual install
git clone --depth 1 https://github.com/sethdford/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/engineer/api-development/skills/rate-limiting-design ~/.claude/skills/rate-limiting-design

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Rate Limiting Design

Protecting APIs from overload and abuse.

## Context

You are designing rate limiting. Choose strategy; balance protection and usability.

## Domain Context

- **Token Bucket**: Smooth spikes; refill at constant rate
- **Sliding Window**: Exact window; more accurate; harder to implement
- **Quota**: Per-day/month limits; common for paid APIs
- **Adaptive**: Adjust limits based on load
- **Fair Use**: Prevent one user from killing service

## Instructions

1. **Set Limits**: How many requests per second? Per user?
2. **Choose Algorithm**: Token bucket (simple), sliding window (accurate)
3. **Communicate Limits**: Headers tell client about remaining quota
4. **Handle Overages**: 429 response; tell client when to retry
5. **Exempt Authenticated**: Different limits for different user types
6. **Monitor**: Track usage; adjust limits if needed

## Anti-Patterns

- Too strict limits; angry users
- Not communicating limits; clients spam, hit limits, get angry
- No backoff guidance; clients retry immediately, making problem worse
- Hitting limits on important operations (payment); loses customers
- No monitoring; surprise outages from limit exhaustion

## Further Reading

- Rate Limiting Pattern (Martin Fowler)
- AWS API Gateway rate limiting
- Stripe rate limiting approach
Read the full skill on GitHub

Details

Skill name
rate-limiting-design
Path
engineer/api-development/skills/rate-limiting-design/SKILL.md
License
MIT
Repo updated
11 March 2026

FAQ

What does the Rate Limiting Design skill do?

Rate limiting strategies (token bucket, sliding window, quota), DOS protection, and fair usage.

How do I install the Rate Limiting Design skill?

Claude Code plugin: /plugin marketplace add sethdford/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Rate Limiting Design popular?

It lives in sethdford/claude-skills, which has 48 GitHub stars and 10 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.