Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is highly actionable with copy-paste-ready curl examples and good section organization for a simple skill. The main weaknesses are a redundant description line and an async polling workflow that lacks an explicit sequenced checklist with validation checkpoints.
Suggestions
Remove the standalone "Find detailed information about a person..." line on line 33, which duplicates the frontmatter description and wastes tokens.
Turn the async search flow into a short numbered sequence with an explicit completion check (e.g. 1. POST to get request_id; 2. Poll GET /person/search?request_id until status=complete; 3. Only then read the results).
Consider collapsing the <details> curl-equivalent block since it duplicates the primary proxy example without adding new capability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with executable curl, but the standalone "Find detailed information about a person including work history, education, social profiles, and contact information" line duplicates the frontmatter description, and the curl-equivalent details pad the token budget. | 2 / 3 |
Actionability | Copy-paste-ready curl commands with concrete example queries, real parameters, response fields, and HTTP error codes give fully executable, specific guidance. | 3 / 3 |
Workflow Clarity | The async POST-to-poll-GET flow is described ("Poll with GET ... until status is complete") but is not laid out as a sequenced checklist with explicit completion/validation checkpoints. | 2 / 3 |
Progressive Disclosure | This is a simple, single-purpose skill with no bundle files; the body is organized into clear, well-signaled sections (Cost Warning, Setup, Usage, Parameters, Response, Error Handling, Tips) so progressive disclosure is satisfied. | 3 / 3 |
Total | 10 / 12 Passed |