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.
An exemplary dispatcher skill: an executable CLI command with exhaustive, explicit failure handling and unambiguous delegation steps. The only notable issues are organizational — trailing paragraphs about the delegated workflow's context-reporting mechanics sit in the entry skill where they add tokens without aiding dispatch.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is imperative and terse with no explanations of known concepts, but the trailing context-manifest and application-reporting paragraphs describe the delegated workflow's behavior rather than the entry's dispatch task and could be trimmed. This is a minor instance of over-inclusion rather than the 'some unnecessary explanation' level of anchor 3. | 4 / 5 |
Actionability | Guidance is fully executable: the copy-paste command `comet workflow resolve . --activate --json`, exact error signatures ("command not found", "ENOENT", nonzero exit, invalid JSON or fields), the exact schema string, exact skill names to load, and exact flags (`--expand-context "<id>"`, `--application "<application-id>" --outcome used-successfully|ignored|overridden|corrected|contributed-to-failure`) covering the common cases. | 5 / 5 |
Workflow Clarity | A clear numbered 3-step sequence (run CLI, parse JSON, load the named Skill) with explicit validation at every failure mode: CLI missing -> stop and report incomplete installation; nonzero exit, unparseable config, or invalid JSON/fields -> preserve the original error and stop; schema whitelist (`comet.workflow-resolution.v1`) and skill-value whitelist. Stop-and-report is the correct terminal checkpoint for a router. | 5 / 5 |
Progressive Disclosure | The skill is self-contained under 50 lines and delegates one level deep to clearly signaled skills (`/comet-native`, `/comet-classic`) loaded via the Skill tool. Minor gaps: the post-selection context-loading instructions arguably belong in the delegated skills rather than this entry, and the 13 bundled scripts in scripts/ are not navigable from the body (by design, since the body forbids invoking the internal bundle directly). | 4 / 5 |
Total | 18 / 20 Passed |