Content
75%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 highly actionable with clearly sequenced workflows and verification checkpoints, and it is well-structured for navigation. Its main weakness is conciseness: pitfalls and tool listings are duplicated across sections, inflating the token budget without adding new information.
Suggestions
Remove the duplicate global "Known Pitfalls" section or the per-workflow "Pitfalls" blocks, cross-referencing one from the other instead of restating, to cut repeated content.
Either trim the Quick Reference table to only tools not already detailed in workflow sequences, or move it to a separate reference file and link to it, reducing inline duplication.
Add an explicit confirm/verify step before CLICKUP_DELETE_TASK (e.g., GET_TASK to confirm the target) and a spelled-out "on 429, wait Retry-After then retry" loop to close the validation gap for destructive and batch operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense and never explains concepts Claude already knows, but pitfalls are stated twice (once per workflow under "Pitfalls" and again globally under "Known Pitfalls") and the Quick Reference table repeats tool slugs already enumerated in each workflow, so it could be tightened. | 3 / 5 |
Actionability | Provides exact tool slugs, typed key parameters with concrete values (priority 1-4, millisecond timestamps, status case-sensitivity), and copy-paste-ready call sequences covering the common cases, which is fully actionable guidance for an instruction-only MCP-tool skill. | 5 / 5 |
Workflow Clarity | Each workflow has a numbered tool sequence with [Prerequisite]/[Required]/[Optional] tags and verification checkpoints (confirm ACTIVE connection, GET_LIST to validate statuses, GET_TASK to verify existence before commenting); the minor gap is no explicit confirm-before-delete step for the destructive CLICKUP_DELETE_TASK and no spelled-out 429 retry loop, so it sits just below the top anchor. | 4 / 5 |
Progressive Disclosure | Content is organized into clear, navigable sections (Core Workflows, Common Patterns, Known Pitfalls, Quick Reference) with no nested references, and the single external link is a docs pointer rather than a bundle file; the minor gap is that the ~230-line body is monolithic with the Quick Reference and consolidated pitfalls arguably separable, so it does not quite reach the one-level-deep reference ideal. | 4 / 5 |
Total | 16 / 20 Passed |