Content
68%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.md body is actionable and reasonably concise, built around concrete Membrane CLI commands and clear tables. Its main gaps are the absence of validation feedback loops around destructive/batch workflow actions and some minor over-explanation that could be trimmed.
Suggestions
Add an explicit validate/verify checkpoint before destructive or batch actions (e.g., confirm a workflow ID via get-workflow before delete-workflow, and check the returned run state after run-workflow).
Tighten or remove narrative padding such as the "so you can focus on the integration logic rather than auth plumbing" aside.
Resolve the mismatch between the intro paragraph ("cloud infrastructure spend") and the actual Kadoa capabilities (web-scraping/extraction workflows) shown in the actions table to avoid confusing the model.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by executable commands and compact tables with only minor padding (e.g., "so you can focus on the integration logic rather than auth plumbing"), so it is broadly efficient despite a few trimmable phrases. | 4 / 5 |
Actionability | It provides concrete, copy-paste-ready commands for install, login, connection, action search/run, and proxy requests, plus flag tables — strong executable guidance with minor gaps such as no example of interpreting a run's output. | 4 / 5 |
Workflow Clarity | The connection flow has a clear state-driven sequence (ensure, poll until READY, handle CLIENT_ACTION_REQUIRED), but destructive/batch actions like delete-workflow and run-workflow lack any validation or verify-then-proceed feedback loop, capping this dimension at 3. | 3 / 5 |
Progressive Disclosure | The single-file body is well sectioned with clear headers and inline quick-reference tables; there are no bundle files to split into, so the inlined 12-row action table is acceptable organization with only minor gaps. | 4 / 5 |
Total | 15 / 20 Passed |