api-pagination

Implements efficient API pagination using offset, cursor, and keyset strategies for large datasets. Use when building paginated endpoints, implementing infinite scroll, or optimizing database queries for collections.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

72%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.

The content is concise, well-structured, and provides executable code for the main strategies, though keyset lacks an example and batch operations have no validation/verification checkpoints. Progressive disclosure is appropriate for a short, self-contained skill.

Suggestions

Add an executable keyset pagination example so all three strategies named in the description are covered with code.

Add validation/verification checkpoints for batch collection operations (e.g., handling empty result sets, decoding invalid cursors safely, and confirming page bounds) to lift workflow clarity above 3.

Trim the restated best-practice bullets or fold them into the code examples to reduce redundancy with knowledge Claude already has.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean with a comparison table and code examples that earn their place, but the comparison table and 'Best Practices' list lightly restate concepts Claude already knows; it stays above the midpoint rather than fully lean.	4 / 5
Actionability	Provides copy-paste-ready Express/Mongoose code for offset and cursor strategies plus a concrete response-format JSON, but keyset pagination (named in the description) is mentioned only in the table with no executable example, leaving a coverage gap.	4 / 5
Workflow Clarity	The strategies are presented as separate runnable snippets rather than a sequenced workflow, and although these are batch/collection operations, there are no validation or verification checkpoints (e.g., handling empty results, invalid cursors, or testing), capping workflow clarity at 3.	3 / 5
Progressive Disclosure	This is a simple skill under 50 lines with no bundle files referenced; sections (Strategies, Offset, Cursor, Response Format, Best Practices) are well-organized and self-contained, meeting the simple-skill exception for a 5.	5 / 5
	Total	16 / 20 Passed

Description

92%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.

The description is strong, third-person, and explicitly covers both what the skill does and when to use it with concrete trigger phrases. Minor gap is the absence of synonym/extension coverage in trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete strategies ('offset, cursor, and keyset strategies') and the concrete action 'Implements efficient API pagination', with comprehensive coverage of the skill's capability surface.	5 / 5
Completeness	Explicitly answers both 'what' ('Implements efficient API pagination using offset, cursor, and keyset strategies for large datasets') and 'when' ('Use when building paginated endpoints, implementing infinite scroll, or optimizing database queries for collections') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Natural trigger phrases like 'paginated endpoints', 'infinite scroll', and 'database queries' are present, but it lacks common synonyms and file/extension cues that would push it to a 5.	4 / 5
Distinctiveness Conflict Risk	The pagination niche with offset/cursor/keyset triggers is clearly distinct from other skills and unlikely to fire for the wrong skill; conflict risk is minimal.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: secondsky/claude-skills
Path: plugins/api-pagination/skills/api-pagination/SKILL.md
Commit: 84802a4

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.