jobe-skills/online-book-lookup
Use when the user asks to look up online book metadata by ISBN, title, author, publication details, editions, subjects, covers, or Open Library source URLs.
100
100%
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 articulates specific capabilities, includes abundant natural trigger terms, explicitly defines both when to use and when not to use the skill, and carves out a distinct niche. The inclusion of negative boundaries ('Do not use this skill for...') is a notable strength that further reduces conflict risk. The only minor note is the use of second-person 'Use this skill when the user asks' rather than third-person voice, but the description is otherwise exemplary.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: retrieve online book metadata, list editions, identify authors and publishers, find publication details, surface subjects, display cover image URLs, cite Open Library source URLs. Also specifies search parameters (ISBN, title, author, broad book query). | 3 / 3 |
Completeness | Clearly answers both 'what' (retrieve metadata, list editions, identify authors, etc.) and 'when' ('Use this skill when the user asks to...'). Also includes explicit negative boundaries ('Do not use this skill for...'), which further clarifies when to use it. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'book metadata', 'editions', 'authors', 'publishers', 'publication details', 'subjects', 'cover image', 'ISBN', 'title', 'author', 'Open Library'. These cover a wide range of natural user queries about book information. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive by specifying Open Library as the data source, focusing on read-only public book metadata, and explicitly excluding ebook downloads, shopping, reviews, recommendations, and editing. This creates a very clear niche unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%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 is concise, actionable, and clearly structured. It provides executable commands for all lookup modes, handles edge cases (no results, API errors) explicitly, and maintains clear safety boundaries. The progressive disclosure to references/scripts.md is well-signaled and appropriate.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section is lean and purposeful. No unnecessary explanations of what Open Library is or how APIs work. The boundaries section is necessary given the safety constraints and doesn't over-explain. | 3 / 3 |
Actionability | Provides fully executable bash commands for all three lookup modes with realistic arguments. Result handling gives concrete details about JSON output structure, exit codes, and field names. | 3 / 3 |
Workflow Clarity | The workflow clearly sequences decision-making (choose narrowest lookup), result presentation (ranked candidates vs exact record), and error handling (no-match vs API failure). For a read-only lookup skill, validation checkpoints aren't critical, and the error handling guidance serves as adequate verification. | 3 / 3 |
Progressive Disclosure | Clean overview with common commands inline and a well-signaled one-level-deep reference to references/scripts.md for detailed script arguments, output formats, and error payloads. Content is appropriately split between the skill file and the reference. | 3 / 3 |
Total | 12 / 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.
Reviewed
Table of Contents