SKILL.md
CommandKit Ratelimit Plugin
Activation guidance
Use when protecting commands from abuse while keeping user UX predictable.
Required filesystem expectations
- plugin registration in
commandkit.config.ts - runtime config bootstrap in
ratelimit.tsorratelimit.js - optional per-command metadata in command files
Execution workflow
- Define runtime defaults with
configureRatelimit. - Register plugin in config.
- Apply command-level overrides or directive-based limits.
- Configure memory/redis/fallback storage based on deployment.
- Validate limited responses and retry timing.
Guardrails
- Balance burst and sustained limits.
- Avoid policy that blocks legitimate normal usage.
Reference index
| Name | Description |
|---|---|
references/00-filesystem-structure.md |
Required ratelimit bootstrap/config file placement. |
references/01-runtime-config.md |
Runtime defaults and initialization pattern. |
references/02-plugin-setup.md |
Plugin wiring and startup ordering expectations. |
references/03-command-metadata-ratelimit.md |
Command-level metadata policy examples. |
references/04-use-ratelimit-directive.md |
Function directive usage and error handling. |
references/05-storage-options.md |
Memory/Redis storage strategy and deployment fit. |
Tool index
| Name | Description |
|---|---|
tools/generate-ratelimit-config.mjs |
Prints a baseline configureRatelimit() runtime config template. |