Content
75%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 body is highly actionable with executable Membrane commands and a clear connection-state workflow, but it carries some over-explanation in the intro and overview sections and inlines a large action table rather than splitting it into a reference file.
Suggestions
Remove the prose intro ("Everhour is a time tracking...") and the confusing nested "Everhour Overview" list; Claude already understands the domain and the action table conveys coverage.
Add an explicit validation/recovery note for create/update actions (e.g. re-fetch the resource after mutation to confirm the change applied), since the workflow section only validates connection state.
Move the full "Popular actions" table into a references/actions.md file and keep only a few representative examples inline, signaling the link clearly for progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly command-and-table driven, but the opening paragraph explains what Everhour is and the redundant "Everhour Overview" nested bullet list plus stray lines like "Use action names and parameters as needed." could be trimmed. | 3 / 5 |
Actionability | Copy-paste-ready CLI commands (install, login, connection ensure/get with --wait, action list/run, request) with flag tables and a populated action catalog fully cover the common integration cases. | 5 / 5 |
Workflow Clarity | The install→auth→connect→poll-until-READY→search→run sequence is explicit with state-based checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED) and a poll loop, though batch create/update actions lack an explicit validate-or-recover step. | 4 / 5 |
Progressive Disclosure | No bundle files exist; content is organized under clear section headers with no nested references, but the 21-row action table is inlined and a longer skill like this could offload detail to a separate reference file. | 4 / 5 |
Total | 16 / 20 Passed |