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.
92
89%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
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.
This is an excellent skill description that clearly defines its scope around API pagination with specific strategies named, and provides explicit trigger guidance via a 'Use when' clause. It uses proper third-person voice, includes natural developer terminology, and occupies a distinct niche that minimizes conflict with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and strategies: 'offset, cursor, and keyset strategies', 'paginated endpoints', 'infinite scroll', 'optimizing database queries for collections'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly 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 an explicit 'Use when' clause. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'pagination', 'offset', 'cursor', 'keyset', 'paginated endpoints', 'infinite scroll', 'database queries', 'large datasets', 'collections'. Good coverage of terms developers naturally use when dealing with pagination. | 3 / 3 |
Distinctiveness Conflict Risk | Highly specific niche around API pagination strategies. The combination of pagination-specific terms (offset, cursor, keyset) and use cases (infinite scroll, paginated endpoints) makes it clearly distinguishable from general API or database skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable skill with clean code examples and efficient use of tokens. Its main weaknesses are the missing keyset pagination implementation (promised in the comparison table but never delivered) and the lack of validation/edge-case handling guidance. The content would benefit from either completing the keyset example or removing it from the table, and adding brief notes on error handling for invalid cursors or boundary conditions.
Suggestions
Add a keyset pagination implementation example to match the comparison table, or remove keyset from the table if it's not being covered
Add edge case handling guidance: invalid/expired cursors, empty result sets, and out-of-range page numbers
Include a brief validation checkpoint, e.g., how to test pagination correctness (verify no skipped/duplicate items across pages)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. The comparison table is a great use of space, code examples are direct without unnecessary explanation, and best practices are bullet points rather than paragraphs. No concepts are over-explained. | 3 / 3 |
Actionability | Provides fully executable Express.js code for both offset and cursor pagination strategies, with concrete response format examples. The code is copy-paste ready with proper error handling (limit capping, default values). | 3 / 3 |
Workflow Clarity | The skill presents individual strategies clearly but lacks guidance on when/how to choose between them beyond the brief table. There's no validation or testing guidance—e.g., how to verify pagination works correctly, handle edge cases (empty results, invalid cursors), or migrate between strategies. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and a comparison table, but the keyset pagination strategy mentioned in the table has no implementation example. The skill could benefit from splitting detailed implementations into referenced files or at minimum providing the missing keyset example inline. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- secondsky/claude-skills
- Commit
88da5ff
- 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.