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.
The body is an unusually disciplined operational skill: executable commands with validation guards, explicit error-recovery routing, budget/stopping rules, and checkpoint guidance, with no wasted tokens. Its weaknesses are minor: a TAB_LABEL/TAB_NAME variable inconsistency in the review-reading commands and heavy inlining of methodology that could move to reference files.
Suggestions
Fix the variable inconsistency: the values.get and comments.list examples use "$TAB_NAME" but only TAB_LABEL is defined in the export setup — define TAB_NAME (or use TAB_LABEL) so the commands run as written.
Show how RUN_ID is obtained (e.g., from the run command output or `deepline runs list`) so the runs-get and export steps are fully executable end to end.
Consider moving the evaluation-methodology detail (golden dataset column schema, grader selection, scorecard contents) into a one-level-deep reference file to keep SKILL.md as a leaner overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, imperative prose with no explanation of concepts Claude already knows; every line carries Deepline-specific policy (e.g., "The CLI returns a `run_overview`: datasets are at `.datasets` and raw diagnostics (including billing) at `.diagnostics`… do not apply those paths to CLI JSON"). Not 4 because there is no over-explanation to trim — the vocabulary definitions and routing tables all earn their tokens. | 5 / 5 |
Actionability | Mostly copy-paste ready commands: a full executable `jq -e` dataset-extraction pipeline, a complete `jq -n` export-input construction with env guards, and concrete tool invocations. Not 5 because of minor gaps — the values/comments commands reference "$TAB_NAME" which is never defined (only TAB_LABEL is set), and how RUN_ID is obtained is not shown; not 3 because the guidance is fully executable beyond these small defects. | 4 / 5 |
Workflow Clarity | Clear loop ("revision → run → assess → decide → next revision") with explicit validation steps (pilot on one or two rows before scaling, `jq -e` erroring on malformed datasets, "stop and retrieve valid run evidence"), feedback loops for error recovery (per-error-code routing with retry-same-operation-key policy), and checklists (budget items, checkpoint fields, plateau rule). Not 4 because checkpoints, recovery, and stopping rules are all explicit rather than implicit. | 5 / 5 |
Progressive Disclosure | Good structure: well-organized sections, a routing table, and a real one-level-deep script reference (scripts/review-sheet-presentation.mjs, verified present and clearly signaled via "$SKILL_DIR/scripts/review-sheet-presentation.mjs"). Not 5 because ~250 lines of dense policy — evaluation methodology, golden-dataset column schema, feedback taxonomy, error routing — are all inlined in SKILL.md when some could split into one-level-deep reference files; not 3 because what is present is well-signaled and navigable. | 4 / 5 |
Total | 18 / 20 Passed |