Content
65%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.
The content is highly actionable with concrete CLI commands and a clear connection lifecycle, but it loses points for inline bulk content that could be split into reference files and for missing validation guidance before destructive operations.
Suggestions
Add an explicit validation/confirmation checkpoint before running destructive or batch actions (e.g. Delete People, Archive People, remove-contacts-from-account) so the workflow includes a verify-then-proceed loop.
Move the popular-actions table and proxy flag reference into separate reference files (e.g. ACTIONS.md, PROXY.md) and link to them from SKILL.md to improve progressive disclosure.
Trim the opening Ortto overview paragraph and incidental prose (e.g. "This is the fastest way to get a connection") to reduce token overhead on content Claude can infer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly commands and tables, but the opening Ortto overview paragraph and prose such as "This is the fastest way to get a connection" restate context Claude could largely infer, so it could be tightened. | 3 / 5 |
Actionability | Provides copy-paste-ready executable commands throughout (install, login, connection ensure, action run with --input, request proxy) plus a concrete flags table covering the common cases. | 5 / 5 |
Workflow Clarity | The install→auth→connect→poll→handle-state→search→run sequence is clear with a polling feedback loop, but destructive/batch operations (Delete People, Archive People, remove-contacts-from-account) lack explicit validation checkpoints, capping the score per the rubric. | 3 / 5 |
Progressive Disclosure | Sections are well-organized, but all 177 lines live in a single file with no bundle references; the large popular-actions table and proxy flag reference are inlined rather than split into separate files. | 3 / 5 |
Total | 14 / 20 Passed |