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 concrete Membrane CLI commands and a clear connection workflow including state-driven validation. Its main weaknesses are mild introductory padding and a dangling 'Step 2' reference that slightly muddies the sequence.
Suggestions
Trim the opening 'Chatwork is a team collaboration...' paragraph and the 'so you can focus on the integration logic' phrasing to reduce padding Claude does not need.
Resolve the 'skip to Step 2' reference by explicitly labeling the searching/running-actions sections as Step 2, or reword to 'skip to Searching for actions'.
Consider moving the 20-row popular-actions table into a references/ file referenced from the body to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with copy-paste commands, but the opening paragraph explaining what Chatwork is ('a team collaboration and communication tool, similar to Slack...') and phrasing like 'so you can focus on the integration logic rather than auth plumbing' are unnecessary padding Claude does not need. | 3 / 5 |
Actionability | It provides fully executable, copy-paste ready commands throughout (npm install, membrane login, connection ensure, action list/run, request) plus a concrete popular-actions table and proxy flag table covering the common cases. | 5 / 5 |
Workflow Clarity | The install → login → connect → poll-for-ready → search → run sequence is clear with state checkpoints and a feedback loop (poll again after user action), but the 'skip to Step 2' reference points to no labeled Step 2, a minor sequencing gap. | 4 / 5 |
Progressive Disclosure | Content is well organized into clearly headed sections with no nested references and easy navigation; the only gap is the large inline popular-actions table that could live in a separate reference file, but no bundle files exist to split into. | 4 / 5 |
Total | 16 / 20 Passed |