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 executable commands and a clear connection workflow, supported by good section structure. Its main weaknesses are minor verbosity in the intro and best-practices prose and the absence of validation guidance around destructive event operations.
Suggestions
Trim the opening "Fomo is a marketing tool..." paragraph to one line or remove it; Claude can infer the product context from the docs link.
Add a brief validation/retry note for destructive actions (e.g. verify an event exists with get-event before update-event, and confirm before delete-event) to lift workflow_clarity past the destructive-ops cap.
Resolve the dangling "Step 2" reference by labeling the connection steps consistently or removing the cross-reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is efficient commands and tables, but the opening paragraph explains what Fomo is and the best-practices section editorializes ("burn less tokens", "This is the fastest way"), adding tokens Claude doesn't need. | 3 / 5 |
Actionability | Commands are copy-paste ready throughout (install, login, connection ensure/get, action list/run, request) with a popular-actions table and proxy flag reference covering the common cases. | 5 / 5 |
Workflow Clarity | The connection workflow is well-sequenced with state checks and a poll-after-user-action feedback loop, but the "Step 2" reference is dangling and destructive event ops (delete-event, update-event) lack explicit validation guidance. | 4 / 5 |
Progressive Disclosure | No bundle files exist; the single ~150-line SKILL.md is organized into clear sections with content appropriately inline for a CLI integration skill, though some reference material (full action catalog, proxy options) could optionally be split out. | 4 / 5 |
Total | 16 / 20 Passed |