Content
57%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 actionable with real CLI commands and a genuinely good connection-state feedback loop, but it opens with concept padding, inlines a large API reference table without any external file split, and omits verification steps for the record-creating actions. Tightening the intro and adding post-run validation would lift the weaker dimensions.
Suggestions
Remove the opening "ServiceNow is a cloud-based platform..." concept paragraph and the "Use action names and parameters as needed." filler; Claude already knows what ServiceNow is.
Add a verification step after running write actions (e.g. re-fetch the record with get-incident and confirm the returned fields, or check the output for error state) to satisfy the destructive/batch validation expectation.
Move the 20-row Popular actions table into a separate references file (e.g. references/actions.md) and link to it from the body, improving progressive disclosure for the longer-than-50-line skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening paragraph ("ServiceNow is a cloud-based platform that provides workflow automation...") explains a concept Claude already knows, and filler like "Use action names and parameters as needed." adds padding, so it sits at "mostly efficient but includes some unnecessary explanation" rather than the lean score-4 anchor. | 3 / 5 |
Actionability | It provides concrete, copy-pasteable commands (install, login, connection ensure, action list/run, request) with documented flags and a real actions table, with only minor gaps like placeholder CONNECTION_IDs and a generic input example, matching the score-4 anchor and just short of fully copy-paste-ready 5. | 4 / 5 |
Workflow Clarity | The connection flow has a strong feedback loop (poll --wait, READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR handling), but the action-execution half that creates and updates live ServiceNow records lacks any validation or verification step, and the destructive/batch cap holds workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | No bundle files exist, so the single ~180-line SKILL.md holds everything inline including a 20-row API reference table that could live in a separate file; section headers give some structure, but bulk reference content that should be separate is inlined, fitting score 3 rather than the well-split score 4. | 3 / 5 |
Total | 13 / 20 Passed |