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 Membrane CLI commands and a well-sequenced, checkpointed connection workflow. Its main weakness is conciseness: an unnecessary introductory paragraph and a few filler lines pad the otherwise efficient guidance.
Suggestions
Delete the opening paragraph defining what Formspree is and the filler line 'When to use which actions: Use action names and parameters as needed.'
Fix the broken 'skip to Step 2' reference and relabel '1b' so the connection workflow's step numbering is consistent.
Consider moving the proxy flags table and the full clientAction state machine into a reference file to slim the main SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient command examples, but the opening 'Formspree is a service that allows developers to easily add forms...' and filler like 'When to use which actions: Use action names and parameters as needed.' explain concepts/background Claude does not need, fitting 'Mostly efficient but includes some unnecessary explanation or could be tightened'. | 3 / 5 |
Actionability | Provides copy-paste-ready commands across install, login, connection ensure/get, action list/run, and proxy with a flags table, fully executable and covering the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | The connection setup is clearly sequenced with state-based checkpoints (polling until READY, handling CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR), but the 'skip to Step 2' reference is broken (no Step 2) and the '1b' labeling is inconsistent, fitting 'Clear sequence with most checkpoints present; minor validation gaps' rather than a clean 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist, so all content is inline in a single file organized under clear section headers (Overview, Authentication, Connecting, Searching, Proxy, Best practices) with no nested references, fitting 'Good structure; most content is appropriately placed; minor organization gaps'. | 4 / 5 |
Total | 16 / 20 Passed |