Skip to content

docs(skills): add Slack rate limit guidance - #150

Merged
josegironn merged 1 commit into
mainfrom
docs/slack-skill-rate-limits
Aug 4, 2026
Merged

docs(skills): add Slack rate limit guidance#150
josegironn merged 1 commit into
mainfrom
docs/slack-skill-rate-limits

Conversation

@josegironn

@josegironn josegironn commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Document Slack's aggressive, tiered rate limits (including the 2026 change dropping conversations.history to Tier 1 / 15 messages per call for non-Marketplace apps)
  • Instruct against parallelizing Slack queries, in favor of serial calls with high per-call limits
  • Instruct to stop and reassess (not keep retrying/parallelizing) after repeated rate limit errors, answering with partial data if needed
  • Add a tip to read oversized file-dumped message responses with jq instead of loading the whole file

Why

An agent recently scraped 15 channels via parallel agent workflows at only 20 messages per call, and got stuck ~4 hours behind rate limits across all 15 agents, running up a large bill for no additional data.

Test plan

  • Reviewed rendered SKILL.md diff for correctness

Made with Orca 🐋

An agent recently ran 15 parallel channel-scraping workflows at a
20-message page size and got stuck for 4 hours behind Slack rate
limits. Document the actual limits, serial-only querying, large page
sizes, and reassessing instead of retrying into repeated 429s.

Co-authored-by: Orca <help@stably.ai>
@josegironn
josegironn merged commit 8c5c29b into main Aug 4, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant