Content
88%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 highly actionable with a clear, validated workflow and concrete tool calls throughout; its only weakness is mild repetition between the workflow steps and the Important notes section, plus a single-file structure that could shed some reference material.
Suggestions
Remove the redundancy between 'Important notes' and the workflow steps — e.g. 'Resync is destructive' already appears in Step 5 and 'Running isn't always healthy' in Step 2 — keeping one authoritative location.
Consider moving the Step 3 error-substring mapping table and the Step 4 A–I recovery catalog into a references/ file, leaving SKILL.md as a tighter overview that points to the detailed tables.
Tighten the webhook Step I narration by leading with the tool call sequence and pruning the explanatory prose around each branch.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence without explaining basics, but the 'Important notes' section restates points already made in Step 5 (resync is destructive) and Step 2 (Running isn't always healthy), which could be trimmed. | 4 / 5 |
Actionability | Provides exact tool names with parameters (e.g. external-data-sources-partial-update({id}, {job_inputs: {stripe_secret_key: ...}})), an error-substring to root-cause to fix mapping table, and a numbered webhook call sequence — fully executable and copy-paste ready. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence (locate → classify → interpret error → pick recovery → confirm before destructive) with an explicit approval gate before destructive actions and feedback loops (cross-check last_synced_at; retrieve detail when latest_error is null), so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the single SKILL.md is well-organized with clear headers and inline tables that are needed at decision time, though the sizable error and recovery-action tables could optionally be split into a reference file to shorten the overview. | 4 / 5 |
Total | 18 / 20 Passed |