CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

processing-api-batches

Optimize bulk API requests with batching, throttling, and parallel execution. Use when processing bulk API operations efficiently. Trigger with phrases like "process bulk requests", "batch API calls", or "handle batch operations".

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

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

A well-structured, highly actionable instruction-only skill with concrete API formats, libraries, limits, and a clear 9-step workflow backed by real, well-placed reference files. The main improvement opportunities are adding executable code samples and an explicit validate/fix/retry feedback loop in the workflow.

DimensionReasoningScore

Conciseness

The body is dense with skill-specific guidance ("bulk insert, bulk update, transactions", "p-limit or asyncio.Semaphore", exact limits like "maximum 1000 items") and does not re-teach concepts Claude already knows; minor trimming is possible in the Overview, which restates the description, and the Resources section, which includes a URL-less "Facebook Graph API batch requests pattern" entry.

4 / 5

Actionability

Concrete, executable guidance throughout: an exact request format ("POST /batch with {operations: [{method: 'POST', path: '/users', body: {...}, id: 'op1'}]}"), a status endpoint shape ("GET /batch/:batchId/status returning {total, completed, failed, progress: 0.75, status}"), specific libraries (p-limit, asyncio.Semaphore, Bull/BullMQ, Celery, SQS), and hard limits (1000 items, 413, concurrency default 10); it stops short of level 5 because there are no copy-paste-ready code blocks and background-worker implementation details are left open.

4 / 5

Workflow Clarity

Nine numbered steps form a coherent sequence from endpoint examination through design, sync/async routing, concurrency, failure handling, validation, and tests; upfront item validation ("validate all items before processing any, and return all validation errors upfront") and a test-writing step provide checkpoints, so the batch-operation cap at 3 does not apply, but there is no explicit validate-then-fix-then-retry feedback loop in the main workflow, keeping it below level 5.

4 / 5

Progressive Disclosure

The body is a clear overview (~85 lines) with well-signaled, one-level-deep references that all exist and are substantive: "See references/implementation.md for the full implementation guide", "Refer to references/errors.md for comprehensive error patterns", and "See references/examples.md for additional examples", each placed at the point of need — matching the level-5 anchor of appropriately split content with easy navigation.

5 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

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

A strong description: third-person, concise, with explicit what/when and natural trigger phrases covering the batch/bulk API processing niche. Its only weaknesses are incomplete action coverage and a couple of missing common trigger variations.

DimensionReasoningScore

Specificity

"Optimize bulk API requests with batching, throttling, and parallel execution" lists several specific actions with minor gaps in coverage (partial failure handling and progress tracking are unmentioned), matching the level-4 anchor better than level 3's '1-2 concrete actions' and falling short of level 5's comprehensive coverage.

4 / 5

Completeness

It explicitly answers what ("Optimize bulk API requests with batching, throttling, and parallel execution") and when ("Use when processing bulk API operations efficiently") with concrete trigger phrases, mirroring the level-5 anchor example structure; not level 4 because the 'when' is more explicit than that anchor allows.

5 / 5

Trigger Term Quality

"process bulk requests", "batch API calls", and "handle batch operations" are natural user phrases with good coverage, but common variations like "bulk endpoint" or "rate limiting" are missing, so it sits between anchors 4 and 5 rather than clearly at 5.

4 / 5

Distinctiveness Conflict Risk

The batch/bulk API processing niche with dedicated trigger phrases is mostly distinct, but "Optimize bulk API requests" could overlap with general API performance or rate-limiting skills, matching level 4's 'minor overlap risk with closely related skills' rather than level 5's minimal conflict risk.

4 / 5

Total

17

/

20

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.

Validation — 14 / 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/tons-of-skills-marketplace

Path

plugins/api-development/api-batch-processor/skills/processing-api-batches/SKILL.md

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.