Content
92%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 skill: an explicitly gated 9-phase workflow with layered validation and error-recovery loops, fully concrete CLI/JSON guidance, and clean progressive disclosure to eight existing one-level-deep reference files. The only weakness is minor redundancy that could be trimmed for token efficiency.
Suggestions
Consolidate the reference listings: the 'Reference files' table near the top and the 'References' section at the end cover the same eight files — keep one (the task-mapped table) and fold the extra items (inline `cx dataprime` help, docs URL, related skills) into it.
State the 'never emit the legacy `dataTable` widget' rule once in Phase 3 — it currently appears both in the widget-type table row and again in the paragraph immediately below it.
Merge the two output templates in 'Output format for the user' into one template with a conditional note for the link line, since they differ only in how the dashboard line and link are rendered.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operational specifics and assumes competence, but has minor trimmable redundancy: the reference files are listed twice (the "Reference files" table and the closing "References" section), the "never legacy `dataTable`" rule is stated twice in Phase 3, and the two output templates overlap heavily. This matches the 4 anchor (efficient with minor over-explanation) rather than 5, where every token would earn its place. | 4 / 5 |
Actionability | Guidance is copy-paste ready throughout: exact CLI invocations (`cx metrics search --name '*<keyword>*'`, `cx dashboards check --from-file ...`), a complete top-level JSON shape, a widget-type selection table keyed by query shape, and concrete failure-handling instructions. It clearly matches the fully-executable top anchor. | 5 / 5 |
Workflow Clarity | A 9-phase sequence with a progress checklist, explicit ordering gates ("don't run Phase 8 before Phases 5–7 all pass"), three validation layers (live query verification in Phase 5, self-check checklist in Phase 6, server-side `check` in Phase 7), and feedback loops (loop back to Phase 4/5 on check or deploy failure). This is the anchor-5 pattern of explicit validation steps, error-recovery loops, and checklists. | 5 / 5 |
Progressive Disclosure | The body is a workflow overview with all domain detail split into eight real, one-level-deep reference files, navigated via a task-mapped table ("DataPrime query syntax → references/dataprime-reference.md") plus per-phase pointers with section anchors ("references/deploy.md section 5"). All referenced paths exist in the bundle, matching the well-signaled, easy-navigation top anchor. | 5 / 5 |
Total | 19 / 20 Passed |