Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A clean, execution-focused body: fully executable commands with documented flags and realistic examples, specified error and retry behavior, and appropriate single-file structure with no unnecessary bundle files. The only weaknesses are minor — a few lines of repo-meta commentary that could be trimmed and an implicit rather than explicit search-to-detail sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is tight and operational — flag tables, a format-selection table, and copy-paste examples with no explanation of concepts Claude already knows. Two blocks are trimmable meta-commentary: the 'country-agnostic worked example of the repo's job-portal-skill pattern' blockquote and some framing in the intro, which keeps it just short of the lean anchor. | 4 / 5 |
Actionability | Every command is copy-paste ready: full invocations for both 'search' and 'detail', every flag documented with concrete example values ('"Mumbai, Maharashtra, India"', '--jobage 30', 'urn:li:jobPosting:...'), and five usage examples covering the common cases including sub-day recency and remote-only searches. | 5 / 5 |
Workflow Clarity | For a simple two-command skill the flow is unambiguous — search returns job IDs that are passed as-is to detail, error output is specified as stderr JSON with exit code 1, and retry behavior on 429/5xx is documented. It falls short of the top anchor only because the search→parse→detail pipeline is never laid out as an explicit sequence with a checkpoint between steps. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent) and none are needed: everything required to run the skill — commands, flags, examples, output formats, error conventions — fits inline in ~85 well-organized lines. Sections (When to use, Commands, Usage examples, Output formats, Notes) are clear and nothing that belongs in a separate file is inlined. | 5 / 5 |
Total | 18 / 20 Passed |