Content
67%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-sequenced, checkpoint-driven connection workflow, but it opens with a factually incorrect description of Keka and carries some explanatory padding that undercuts token efficiency.
Suggestions
Delete or correct the opening line 'Keka is a macOS file archiver and compressor' — it contradicts the integration framing and wastes tokens on a concept Claude already knows.
Trim motivational filler like 'so you can focus on the integration logic rather than auth plumbing' to keep the prose lean.
Consider moving the proxy request flag table and best-practices list into a reference file to slim the main SKILL.md overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but opens with an incorrect and unneeded explanation ('Keka is a macOS file archiver and compressor...') and includes filler like 'so you can focus on the integration logic rather than auth plumbing' that Claude does not need. | 3 / 5 |
Actionability | It provides concrete, copy-pasteable commands throughout (install, login, connection ensure, action list/run, request) plus a flag table, with only minor gaps where placeholders like CONNECTION_ID and QUERY must be substituted. | 4 / 5 |
Workflow Clarity | The install → authenticate → connect → poll-for-ready → search → run sequence is clear and includes state-based checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) with a re-poll feedback loop, leaving only minor validation gaps. | 4 / 5 |
Progressive Disclosure | Content is well organized into clearly headed sections with no deep or buried references, but everything is inlined into a single ~140-line file with no offloading of the proxy flag table or best practices to separate files. | 4 / 5 |
Total | 15 / 20 Passed |