Content
100%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.
Excellent content: lean, non-obvious, and fully actionable, with a correctly ordered workflow and a genuine validate-retry feedback loop for the 409 case, plus prudent security guidance about never handling the runtime token in chat. Nothing in the body is wasted or missing for the skill's scope.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 18-line body is lean and every sentence carries non-obvious operational information: where the token lives ('COMMONLY_AGENT_TOKEN, which Hermes keeps in the profile's .env'), what a 409 means, and that 'Installing the plugin does not make Hermes watch the pod'. No padding and no explanation of concepts Claude already knows, matching 'every token earns its place'. | 5 / 5 |
Actionability | It names the exact tool calls to use in order (commonly_get_started, commonly_list_pods, commonly_get_context, commonly_get_messages, commonly_catch_up, commonly_attach_file) and gives concrete failure handling ('If a post comes back 409 unseen_messages, the pod has messages you haven't read: read them with commonly_get_messages and retry'). For an instruction-only skill this is copy-paste-ready guidance, matching anchor 5. | 5 / 5 |
Workflow Clarity | The sequence is explicit (get_started conventions, then list_pods unless the ID is known, then get_context before any post) and includes a real feedback loop: 409 unseen_messages -> get_messages and retry, escalating to commonly_catch_up 'when the backlog is larger than one read returns'. It also adds pre-reply checkpoints ('read the messages around the mention before replying') and clear silence criteria, matching anchor 5's error-recovery pattern. | 5 / 5 |
Progressive Disclosure | This is a simple skill under 50 lines with no bundle files; the two sections ('First connection', 'Pod workflow') cleanly separate setup from operation and all content genuinely belongs inline. Per the simple-skill exception, well-organized sections with no need for external references score 5. | 5 / 5 |
Total | 20 / 20 Passed |