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 content is highly actionable with executable CLI commands and a clear connection workflow including validation feedback loops. Its main weakness is a fluffy intro paragraph that explains general product knowledge, and a few dangling step references.
Suggestions
Trim the introductory paragraph about what Khoros Marketing is and who uses it; Claude does not need that background.
Label the workflow steps explicitly (Step 1a/1b/Step 2) so the "skip to Step 2" reference resolves to a real heading.
Consider moving the proxy flags table and clientAction state detail into a references file to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening paragraph ("Khoros Marketing is a social media management platform. It helps marketing teams schedule posts...") explains general product knowledge Claude does not need, and phrases like "so you can focus on the integration logic rather than auth plumbing" pad the prose. | 3 / 5 |
Actionability | It provides copy-paste-ready commands for install, login, connection ensure/get with --wait, action list/run with --input, and a thorough proxy flags table covering the common cases. | 5 / 5 |
Workflow Clarity | The install→auth→connect→poll→search→run sequence is clear with state-based validation checkpoints and a feedback loop (poll again after CLIENT_ACTION_REQUIRED), but the dangling "skip to Step 2" reference has no matching labeled section. | 4 / 5 |
Progressive Disclosure | No bundle files exist, but the body is organized into well-labeled sections (Overview, Working with, Searching, Popular actions, Proxy, Best practices); the inline proxy table and clientAction state reference could optionally be split out, hence not a 5. | 4 / 5 |
Total | 16 / 20 Passed |