Content
61%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 actionable and well-structured with strong connection-handling guidance, but it carries a marketing intro and filler, and lacks validation/confirmation steps for the destructive actions it advertises.
Suggestions
Remove the marketing-style opening paragraph and the vague "Use action names and parameters as needed" line to tighten token efficiency.
Add a confirmation/validation checkpoint before running destructive actions like delete-template (e.g., verify the target template id and confirm with the user before executing).
Consider moving the popular-actions table and proxy flag reference into a separate reference file to keep SKILL.md a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly executable commands with brief explanations, but the opening marketing paragraph ("document automation platform... businesses of all sizes") and filler like "When to use which actions: Use action names and parameters as needed." are unnecessary padding. | 3 / 5 |
Actionability | It provides copy-paste-ready commands for install, login, connection, action search/run, and proxying, with concrete flag tables; minor gaps remain around placeholders like "QUERY" in the intent example and CONNECTION_ID substitution. | 4 / 5 |
Workflow Clarity | The connection workflow has explicit state handling and polling feedback loops, but the destructive operations it exposes (delete-template) are run via a generic `action run` with no validation or confirmation checkpoint, capping it at 3 per the destructive-operation rule. | 3 / 5 |
Progressive Disclosure | No bundle files exist and the single SKILL.md is well organized into clear sections (install, auth, connecting, searching, popular actions, proxy, best practices); the popular-actions and proxy-flag tables could be split into reference files but the current structure navigates well. | 4 / 5 |
Total | 14 / 20 Passed |