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.
Highly actionable, concrete content with excellent executable commands and a clear two-phase workflow. The main gap is the absence of validation/verification checkpoints in the batch Slack-posting flow, which caps workflow clarity.
Suggestions
Add an explicit verification checkpoint after gist creation (e.g. confirm the gist URL is returned) before posting the main Slack message, and confirm the main message posted successfully before threading rows 21–N.
Add a fallback/validation note for the channel lookup step — what to do if slack_search_channels returns no match or multiple matches.
State the expected script output format up front (TSV columns) so Claude can verify the gather-data step succeeded before moving to Slack posting.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence — the bullet list of script internals and Slack formatting rules are non-obvious specifics that earn their place. A few explanatory clauses (e.g. the parenthetical about Slack MCP having no file-upload tool) could be trimmed, keeping it just below a 5. | 4 / 5 |
Actionability | Fully executable guidance throughout — concrete commands ('bun run ci:slowest 47324 100', 'gh gist create ...', 'gh pr list --state merged --limit 10 ...'), exact file paths, and a copy-paste-ready bullet row format with padding rules. | 5 / 5 |
Workflow Clarity | The two-phase flow (gather data, then post to Slack) and the 4-step Slack procedure are clearly sequenced, but this is a batch operation (chunked posting of N rows) with no explicit validation/verification checkpoints — e.g. confirm the channel ID was found, verify the gist was created before posting, or confirm the main message posted before threading — so it is capped at 3 per the batch-operation rule. | 3 / 5 |
Progressive Disclosure | Well-organized into two clear sections with the bulk of detail appropriately inline for a ~45-line skill; the referenced script (scripts/ci-slowest-tests.ts) is a repo artifact rather than a bundled skill file, so navigation stays one level deep. Not a 5 because no bundle exists to verify referenced paths and the structure is flat rather than explicitly pointing to deeper materials. | 4 / 5 |
Total | 16 / 20 Passed |