Content
88%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 high-quality operational reference: executable commands and MCP signatures throughout, a clearly sequenced five-step workflow with genuine validation gates and error-recovery loops appropriate to a paid batch operation, and well-organized single-file structure. The two sub-5 dimensions are minor: a slightly redundant ETL/ELT analogy and inlined API detail that could be split into a reference file.
Suggestions
Cut the "In pipeline terms... ETL/ELT" paragraph — the asset-library-vs-staged distinction is already made twice above it, and the analogy adds no operational instruction.
Consider moving the shared CLI flag tables and MCP parameter reference (section 3) into a references/ file (e.g., references/cli-and-mcp.md) and keeping SKILL.md as the decision-and-sequence overview, which would also shorten the ~330-line body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly every token carries platform-specific knowledge Claude cannot already know (tool names, CLI flags, limits like "20,000 image references per ingest request," exact 402/409/429 error strings, ~7-day expiry). Minor over-explanation keeps it below a 5: the ETL/ELT paragraph ("In pipeline terms: a staged job is the T of an ETL flow...") restates the asset-library-vs-staged distinction already made twice above, and a few caveat sentences could be trimmed. It is not a 3 because no space is spent explaining concepts Claude already knows. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste-ready CLI commands with complete flag lists ("inference rf-cloud data-staging create-batch-of-images --batch-id my-batch --images-dir ./images"), concrete MCP call signatures with named parameters, explicit decision procedures (cpu vs gpu via a timed single-image test run plus Workflow spec inspection), and exact operational limits (batch id charset, format lists, 10,000-entry listing cap). This matches the 5 anchor ("copy-paste ready code or commands; specific examples cover the common cases"). | 5 / 5 |
Workflow Clarity | The five-step sequence (install → stage → start → monitor → download) has explicit validation checkpoints for this paid batch operation: "Do not start a job while `pending` is true or `failed` is true," poll-until-terminal guidance, a `retryAfterSeconds` sleep-and-resume loop, `failed` state with logs and a restart hint, and 409 recovery options (inspect, omit optional settings, or pass a new job_id). Feedback loops are present, so the batch-operation cap of 3 does not apply; this matches the 5 anchor ("clear sequence with explicit validation steps; feedback loops for error recovery"). | 5 / 5 |
Progressive Disclosure | No bundle files exist, so this is a single-file skill; sections are well-organized and numbered with clear internal navigation ("The full command set for both content types is in sections 1-5") and a clearly signaled, one-level-deep pointer to the separate `cloud-storage` skill for imports. At ~330 lines, however, the full CLI and MCP parameter reference is inlined where the 5 anchor expects content "appropriately split" — e.g., the shared-flag tables in section 3 could live in a reference file. This matches the 4 anchor ("good structure; most content is appropriately placed; minor organization gaps"), not a 3 because nothing is buried or unsignalable. | 4 / 5 |
Total | 18 / 20 Passed |