Content
82%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 a well-checkpointed connection workflow and clean section structure. Weaknesses are minor over-explanation up front and a bulky inline action table that could be externalized.
Suggestions
Trim the introductory paragraph explaining what Hootsuite is and the auth-plumbing aside; Claude already knows the platform and the CLI's value proposition.
Add a brief verification step for destructive actions (Delete Message, Reject Message), e.g. confirming the message ID or listing before deletion, to satisfy the batch/destruction validation expectation.
Consider moving the full Popular actions table into a references/ file and keeping only the 3-4 most common actions inline in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and command-driven, but opens by explaining what Hootsuite is ('Hootsuite is a social media management platform...') and adds mild padding ('so you can focus on the integration logic rather than auth plumbing') that Claude does not need. | 4 / 5 |
Actionability | It provides copy-paste-ready commands for the full lifecycle — install, login (incl. headless), connection ensure/get with --wait, action list/run with JSON input, and proxy requests — covering the common cases concretely. | 5 / 5 |
Workflow Clarity | The connection flow is clearly sequenced with explicit state checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a poll-after-action feedback loop; the minor gap is that destructive actions (Delete/Reject Message) are listed without any verification guidance. | 4 / 5 |
Progressive Disclosure | Content is organized into clear sections with no nested or broken references, and the Popular actions table is a reasonable inline quick-reference; the gap is that the 14-row action catalog could live in a separate reference file to keep SKILL.md as an overview. | 4 / 5 |
Total | 17 / 20 Passed |