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.
Install with Tessl CLI
npx tessl i github:secondsky/claude-skills --skill api-paginationOverall
score
92%
Does it follow best practices?
Validation for skill structure
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 a well-crafted skill description that excels across all dimensions. It provides specific pagination strategies (offset, cursor, keyset), includes natural trigger terms developers would use, and has an explicit 'Use when' clause covering multiple relevant scenarios. The description is concise yet comprehensive, clearly distinguishing this skill from general API or database skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'offset, cursor, and keyset strategies', 'building paginated endpoints', 'implementing 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') and when ('Use when building paginated endpoints, implementing infinite scroll, or optimizing database queries for collections') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'pagination', 'paginated endpoints', 'infinite scroll', 'large datasets', 'offset', 'cursor', 'keyset'. These cover common variations of how developers discuss pagination. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on API pagination strategies. The specific mention of offset/cursor/keyset patterns and infinite scroll creates distinct triggers unlikely to conflict with general API or database skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill that efficiently presents pagination strategies with executable code examples and a useful comparison table. The content is appropriately concise and actionable. Minor improvement could be made by adding error handling patterns for invalid pagination parameters.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Content is lean and efficient with no unnecessary explanations. The comparison table, code examples, and best practices all earn their place without explaining concepts Claude already knows. | 3 / 3 |
Actionability | Provides fully executable JavaScript code for both offset and cursor pagination patterns. Examples are copy-paste ready with proper error handling (limit capping, cursor decoding). | 3 / 3 |
Workflow Clarity | This is primarily a reference skill showing implementation patterns rather than a multi-step workflow. However, it lacks validation guidance for edge cases (invalid cursors, negative offsets) and no feedback loops for error handling in the API implementations. | 2 / 3 |
Progressive Disclosure | For a skill under 50 lines focused on a single topic, the content is well-organized with clear sections (strategies table, implementations, response format, best practices). No external references needed for this scope. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 13 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
body_steps | No step-by-step structure detected (no ordered list); consider adding a simple workflow | Warning |
Total | 13 / 16 Passed | |
- 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.