CtrlK
BlogDocsLog inGet started
Tessl Logo

clay-rate-limits

Handle Clay rate limits, webhook throttling, and credit pacing strategies. Use when hitting 429 errors, managing webhook submission rates, or optimizing throughput within Clay's plan limits. Trigger with phrases like "clay rate limit", "clay throttling", "clay 429", "clay slow", "clay records per hour".

69

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable with executable code and useful reference tables, but it is monolithic — three full implementations live inline in SKILL.md with no bundle files to offload detail. Workflow clarity is solid but lacks explicit validation checkpoints for the batch webhook operations it describes.

Suggestions

Split the three TypeScript implementations into referenced scripts files (e.g. scripts/rate-limiter.ts) and keep SKILL.md as an overview with one-level-deep links, improving progressive_disclosure and conciseness.

Add an explicit validation/checkpoint step for batch webhook submissions — e.g., verify submission counts against the 50K limit before each batch and confirm 429 retry exhaustion is handled — to lift workflow_clarity.

Trim explanatory prose that restates known concepts (the Overview sentence, code comments explaining what a rate limit is) to tighten conciseness.

DimensionReasoningScore

Conciseness

The body is mostly efficient with targeted tables and code, but inline prose like 'Understanding these limits prevents data loss, credit waste, and integration failures' and explanatory comments restate context Claude already knows, and three full code blocks push the token budget.

2 / 3

Actionability

It provides fully executable TypeScript (PQueue-based rate limiter, backoff function, webhook manager) with concrete plan limits, thresholds, and a clear error-handling table — copy-paste ready.

3 / 3

Workflow Clarity

Steps are sequenced (understand tiers, implement limiting, handle 429, manage lifecycle, enrichment limits) but batch webhook submission lacks an explicit validate-then-act checkpoint; the backoff retry has no max-retry exhaustion handling surfaced as a workflow checkpoint.

2 / 3

Progressive Disclosure

Content is well-sectioned but entirely monolithic within SKILL.md — the rate-limiter, backoff, and webhook-manager implementations are inlined rather than split into the referenced bundle files (none exist), and the only cross-skill pointer ('clay-security-basics') is not a bundle reference.

2 / 3

Total

9

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: it states concrete capabilities, provides a clear 'Use when' clause, and lists natural trigger phrases scoped to Clay. It is concise, third-person, and clearly distinguishable from other skills.

DimensionReasoningScore

Specificity

The description names multiple concrete actions — 'Handle Clay rate limits, webhook throttling, and credit pacing strategies' — directly addressing concrete behaviors rather than vague language.

3 / 3

Completeness

It explicitly answers both 'what' (handle rate limits, webhook throttling, credit pacing) and 'when' (Use when hitting 429 errors, managing webhook submission rates, optimizing throughput), with explicit trigger guidance.

3 / 3

Trigger Term Quality

Trigger phrases like 'clay rate limit', 'clay throttling', 'clay 429', 'clay slow', and 'clay records per hour' are natural terms a user would actually say, with good coverage of common variations.

3 / 3

Distinctiveness Conflict Risk

The Clay-specific trigger terms carve out a clear niche unlikely to conflict with other skills, and the domain is narrowly scoped to Clay rate limiting.

3 / 3

Total

12

/

12

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
jeremylongshore/claude-code-plugins-plus-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.