Content
80%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill body is highly actionable and concise, with strong examples and error handling. Its main gaps are a missing validation checkpoint for batch operations and a monolithic structure that underuses progressive disclosure.
Suggestions
Add an explicit validation/verification step in the extraction workflow (e.g., inspect result count and spot-check fields before exporting or summarizing), creating a validate→fix→retry feedback loop for batch runs.
Move the long marketplace enumeration and per-workflow detail into separate reference files (e.g., MARKETPLACES.md, WORKFLOWS.md) and keep SKILL.md as an overview with clearly signaled one-level-deep links.
Confirm the referenced script path exists in a `references/scripts/` bundle (the body uses `reference/scripts/`) so the link is not broken.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it does not explain what e-commerce or scraping is, and each section delivers actionable content with minimal padding. | 3 / 3 |
Actionability | Provides fully executable `node --env-file=…` commands, concrete JSON input examples per workflow, documented output fields, and a structured error-handling table — copy-paste ready with clearly marked placeholders. | 3 / 3 |
Workflow Clarity | Sequencing is clear (progress checklist, Workflow Selection table, numbered extraction steps), but batch extraction of hundreds of items has no explicit validation/verification checkpoint before summarizing, which caps workflow clarity at 2 per the rubric. | 2 / 3 |
Progressive Disclosure | Well-organized into clear sections, but it is a monolithic ~270-line document with all three workflows, marketplace enumerations, and examples inline; the referenced `$SKILL_PATH/reference/scripts/run_actor.js` has no corresponding bundle file, and content that could be split (marketplace list, per-workflow detail) is not separated out. | 2 / 3 |
Total | 10 / 12 Passed |