Content
76%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 delivers highly actionable, copy-paste-ready Membrane commands and a well-sequenced connection workflow with explicit state and feedback handling. Its weaknesses are mild introductory over-explanation of what an ATS is, inlined reference-grade tables, and—most importantly—no verification step after destructive actions, which caps workflow clarity.
Suggestions
After running destructive/batch actions (archive opportunity, delete interview, create opportunity), add a verification step such as re-fetching with get-opportunity or list-interviews-for-opportunity to confirm the change took effect.
Trim the opening paragraph explaining what an ATS/recruiting system is; Claude already knows this, so lead with the integration mechanics instead.
Consider moving the full popular-actions table and proxy-flag reference into a references/ file, keeping SKILL.md as an overview with a one-level-deep pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean command-driven content with a compact actions table and terse best practices, matching the efficient anchor; not 5 because the opening paragraph explains what an ATS/recruiting is and a few asides (e.g. "so you can focus on the integration logic") are mild padding Claude does not need, and not 3 because the bulk earns its place. | 4 / 5 |
Actionability | It provides copy-paste-ready commands throughout (install, login, connection ensure, --wait polling, action list/run with concrete --input JSON, proxy flags) plus a popular-actions table with real keys, matching the fully-executable anchor covering common cases. | 5 / 5 |
Workflow Clarity | The connection flow is well-sequenced with explicit state handling and a poll/feedback loop, but running destructive/batch actions (archive opportunity, delete interview, create opportunity) has no verification step afterward; per the rubric, missing validation for destructive or batch operations caps workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | Content is well-organized into clear sections with headers and tables and no nested references, but the 20-row popular-actions table and proxy-flag reference are inlined reference-grade material with no external file split, sitting between the good-structure (4) and clear-overview-with-references (5) anchors. | 4 / 5 |
Total | 16 / 20 Passed |