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.
A high-quality instructional body: concrete, executable, and validated end to end, with error-recovery guidance tied to real runtime messages. Its two soft spots are a handful of trimmable restatements and an all-inline structure that could offload reference material to bundle files.
Suggestions
Move the roster API signature list, the mount-validation error catalog, and the disabled subagent YAML templates into references/ files (e.g., references/api.md, references/errors.md) and link them one level deep, keeping SKILL.md a leaner overview.
Trim rule restatements such as the 'Reading a shipped composition is the intended way to start...' sentence in the Off-limits section, which repeats the section's own prohibition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with harness-specific, non-inferable facts and assumes competence throughout, but a few passages restate rules or run discursive — e.g., 'Reading a shipped composition is the intended way to start; writing to one is not, and neither is editing the host composition to work around a preset limitation' repeats the section's own prohibition — leaving minor instances that could be trimmed. | 4 / 5 |
Actionability | Fully executable guidance: a complete copy-paste JS plugin for mount-validation, exact API calls ('cordis_inspect what:"api" name:"agentPresets"', 'standingKeyFor(id)', 'copy(from, id, name?)'), ready-to-copy YAML templates for the subagent rows, and the literal error-message strings to expect — covering the common cases. | 5 / 5 |
Workflow Clarity | The numbered authoring sequence (copy, expect sandbox, write metadata, edit rows, mount-validate) is explicitly capped by the 'standingKeyFor(id) is the check' validation step, with a four-failure-mode catalog and feedback loops ('read the rejection — it names the offending service') plus a post-validation handoff to a real session. | 5 / 5 |
Progressive Disclosure | Well-ordered, clearly headed sections make the ~150-line single file easy to navigate with no nested references, but it is a monolith — the roster API details, the error-message catalog, and the disabled subagent templates are candidates for one-level-deep reference files that would keep SKILL.md a leaner overview. | 4 / 5 |
Total | 18 / 20 Passed |