Content
81%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.
This is a high-quality, highly actionable migration skill with excellent workflow validation and concrete command/payload examples. Its main weakness is redundancy across the protocol, mapping, and rules sections that inflates token cost.
Suggestions
Consolidate the repeated workspace-agents/execution-gate and clarify-usage guidance so each rule appears once; the 'User interaction protocol', 'Decision-to-command mapping', and 'Important rules' sections currently restate much of the same material.
Fix the duplicate numbering in the simplified decision flow (two consecutive items labeled '5') so the step sequence parses correctly.
Consider moving the lengthy post-run reporting rules and the clarify payload catalog into a separate reference file (e.g., REPORTING.md) referenced one level deep, keeping SKILL.md as a leaner overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is operationally dense and does not explain concepts Claude already knows, but the same guidance is restated across 'User interaction protocol', 'Decision-to-command mapping', and 'Important rules' (e.g., the workspace-agents execution gate and clarify usage rules each appear several times), and the decision-flow list even has two items numbered '5' — material tightening is possible. | 3 / 5 |
Actionability | It provides copy-paste-ready CLI commands, exact `clarify` JSON payload shapes, and a precise decision-to-flag mapping table covering the common cases, which is fully executable guidance. | 5 / 5 |
Workflow Clarity | The Default workflow is a clear sequence with explicit validation checkpoints (dry run, conflict-resolution gate, an 'Execution gate' section, restate-command-plan-before-executing), plus feedback loops (clarify error -> retry once, dry-run -> resolve decisions -> execute), which is exactly what the level-5 anchor calls for on a destructive/batch operation. | 5 / 5 |
Progressive Disclosure | Structure is good with clear section headers and a real, clearly signaled one-level reference to scripts/openclaw_to_hermes.py (with path-resolution guidance); however, large inline catalogs (post-run reporting rules, clarify payload shapes) that could live in separate reference files keep it just below the ideal split. | 4 / 5 |
Total | 17 / 20 Passed |