Content
70%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 well-structured, highly actionable overview with exemplary workflow sequencing and validation/recovery checkpoints for batch and authoring flows. The main weaknesses are broken/missing bundle references that its progressive-disclosure design depends on, duplicated live-video guidance, and no inline example for the skill's core workflow-execution capability.
Suggestions
Ship the referenced bundle files (workflows.md, workflow-templates.md, local-tooling.md, batch-staging.md, batch-jobs.md) alongside SKILL.md, or inline their essential content — as delivered, every local reference link in the body is unresolvable.
Deduplicate the live-video three-option guidance (the tip blockquote and the deployment-options subsection repeat the same A/B/C content); keep one and point the other to the workflows reference.
Add one concrete inline example of running a workflow (a `workflows_run` call with a real slug and a `parameters` object) since workflow execution is the skill's headline capability and its details currently live only in missing files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight (tables for deployment options and CLI commands, terse bullets), but it could be noticeably tightened: the three live-video deployment options are presented twice (lines 26 and 43-49), the "similar to the extensibility benefits of a microservice over a point-to-point call" analogy explains a concept Claude already knows, and the Batch Processing "What it is / Problem it solves / Pick it when" narrative reads as documentation prose. This matches anchor 3 (mostly efficient with some unnecessary explanation) better than anchor 4. | 3 / 5 |
Actionability | Concrete, executable guidance dominates: exact MCP tool names with semantics (`workflows_run` by `workflow_id` slug, `workflow_specs_validate` before saving), a copy-paste-ready end-to-end batch CLI block (`inference rf-cloud data-staging create-batch-of-images --images-dir ./my-images --batch-id my-batch` ... `export-batch`), install commands (`pip install inference-cli && inference server start`), and the subdomain pattern `<name>.roboflow.cloud`. It falls short of anchor 5 because the central promised capability — "Workflow execution patterns" — has no inline example (no sample `workflows_run` invocation with a slug and `parameters`, no example spec), deferring entirely to files that are not present in the bundle. | 4 / 5 |
Workflow Clarity | Multi-step flows are clearly sequenced with explicit validation checkpoints and recovery paths: the batch flow (save Workflow → stage inputs → submit with CPU/GPU choice → monitor via poll/webhook → export) with `workflow_specs_validate` before any inline run or save, authorization gates for side-effecting/paid runs, and failure recovery commands (`fetch-logs`, `restart-job` with new compute settings, `abort-job`, `list-ingest-details` for debugging ingests). The authoring Mode A sequence (start from a similar saved workflow → ground block types → validate → save → run published version) and the "present three options, don't pick one silently" decision checkpoint for video reinforce this. The batch-operation validation cap does not apply since validation steps are present. | 5 / 5 |
Progressive Disclosure | References are well-signaled and one level deep ([workflows](./workflows.md), [local-tooling](local-tooling.md), [batch-staging](batch-staging.md), [batch-jobs](batch-jobs.md), each with a stated purpose), but none of these referenced files exist in the bundle — there are no references/, scripts/, or assets/ directories, so every local pointer is broken and the disclosure structure cannot actually be followed. Additionally, the detailed batch CLI tables are inlined despite the section itself declaring a dedicated roboflow-batch-processing skill exists ("this section is only the deployment comparison"), i.e., content that should be separate is inline. This fits anchor 3 better than anchor 4. | 3 / 5 |
Total | 15 / 20 Passed |