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, led by concrete executable CLI commands and a clear connection state-machine. Its main weaknesses are marketing-flavored padding and a workflow whose step numbering is inconsistent and references a missing 'Step 2'.
Suggestions
Fix the broken workflow numbering: either add an explicit 'Step 1' / 'Step 2' labeling or replace the 'skip to Step 2' reference and the lone '1b' heading with consistent sequential headings.
Trim marketing prose such as 'so you can focus on the integration logic rather than auth plumbing' and 'This is the fastest way to get a connection' to improve token efficiency.
Populate the 'Popular actions' section with a few concrete named Social Intents actions instead of only redirecting to `action list`.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with concrete commands, but includes unnecessary marketing prose such as "so you can focus on the integration logic rather than auth plumbing" and "This is the fastest way to get a connection," matching the 'mostly efficient but could be tightened' anchor. It is above a 2 because the bulk is command-driven, but below a 4 due to these padded explanatory sentences. | 3 / 5 |
Actionability | The guide provides concrete, executable commands (login, connection ensure, action list/run, request) plus a complete proxy flags table, fitting the 'mostly executable guidance with minor gaps' anchor. It is not a 5 because the "Popular actions" section only redirects to `action list` without showing any actual named actions. | 4 / 5 |
Workflow Clarity | The connection workflow has a clear state-machine (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) with polling, but it references a non-existent "Step 2" and labels a subsection "1b" with no corresponding "1a" or "Step 1", leaving the sequence with broken checkpoints. This fits the anchor for steps present but with missing/implicit checkpoints, and is not a 4 because the cross-references do not resolve. | 3 / 5 |
Progressive Disclosure | As a single-file skill with no bundle files, the content is organized into clearly labeled sections (Overview, Authentication, Connecting, Searching, Proxy, Best practices) with no nested references, matching the 'good structure; most content appropriately placed' anchor. It is not a 5 because some material (e.g., the proxy flags table, agent-type list) could be split out, but the organization is solid. | 4 / 5 |
Total | 14 / 20 Passed |