Content
57%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 skill is highly actionable with concrete CLI commands and a clear connection workflow, but it is weighed down by a bloated inline entity catalog, missing validation around destructive operations, and no progressive disclosure into reference files.
Suggestions
Move the ~160-item entity catalog into a separate references file (e.g. ENTITIES.md) and link to it from a short overview, keeping SKILL.md lean.
Add an explicit validation/verification checkpoint before running destructive or batch actions (e.g. 'list-cases' to confirm scope before 'update-case' or bulk export), with a fix-and-retry loop.
Trim or summarize the entity list to the categories users actually act on, removing the combinatorial 'Search/Export/Import/Schedule' repetitions that pad the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The CLI command sections are lean and efficient, but the ~160-line bare enumeration of entity names (lines 23-183) is substantial padding that does not earn its token cost against Claude's existing competence. | 3 / 5 |
Actionability | It provides concrete, copy-paste bash commands for install, login, connection, action search/run, and proxying, plus a flags table and popular-actions table, with only minor placeholder gaps (CONNECTION_ID, intent string). | 4 / 5 |
Workflow Clarity | The connect workflow has clear state-based checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR), but running actions covers destructive and batch operations (update-case, create-case, bulk migration/export) with no validation or verification steps, capping the score at 3. | 3 / 5 |
Progressive Disclosure | The body is sectioned reasonably, but no bundle files exist and the large entity-name catalog is inlined directly in SKILL.md rather than split into a one-level-deep reference file, leaving structure that could be better organized. | 3 / 5 |
Total | 13 / 20 Passed |