Content
63%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.
The body is highly actionable with executable CLI commands and a clear connection-state feedback loop, but it carries redundant action listings and inlines bulk API reference that should be split into a separate file.
Suggestions
Move the 20-row "Popular actions" table (and the "DataForSEO Overview" bullet list) into a referenced ACTIONS.md, keeping only a few representative examples inline in SKILL.md.
De-duplicate the action catalog: the "DataForSEO Overview" nested bullets and the "Popular actions" table list overlapping actions — keep one and link to the other.
Add one concrete end-to-end example that runs a real DataForSEO action with actual parameters (e.g., fetching backlinks for a domain) so the actionability gap closes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The CLI command sections are tight, but the "what is DataForSEO" intro and a duplicate action listing (the "DataForSEO Overview" bullets plus the 20-row "Popular actions" table) are unnecessary token weight that could be trimmed. | 3 / 5 |
Actionability | Copy-paste ready commands cover the common cases (login, connection ensure, action list/run, request proxy) with a full flag table, but no example invokes a real DataForSEO action with concrete parameters beyond the generic '{"key": "value"}'. | 4 / 5 |
Workflow Clarity | A clear install → authenticate → connect → poll-until-READY → search → run sequence exists with a real feedback loop on connection state (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR), but the referenced "Step 2" is unlabeled and action-run error handling is absent. | 4 / 5 |
Progressive Disclosure | Section headers are well organized, but no bundle files exist and the ~20-row action reference table plus overview bullets are inlined content that belongs in a separate reference file rather than SKILL.md. | 3 / 5 |
Total | 14 / 20 Passed |