Content
65%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.
A highly actionable, well-structured reference for driving Datadog via MCP tools, with concrete sequences and copy-paste syntax. Its weaknesses are duplicated/filler sections, a missing validation step before irreversible deletes, and a monolithic single-file layout that external references would relieve.
Suggestions
Add an explicit validation checkpoint before destructive operations, e.g. for dashboards: call DATADOG_GET_DASHBOARD first and confirm with the user before DATADOG_DELETE_DASHBOARD.
Remove the redundant 'Known Pitfalls' section (timestamps and query syntax are already covered per-workflow) and delete the filler '## When to Use' paragraph to tighten token usage.
Move the Quick Reference table and per-workflow parameter/pitfall details into a references/ file (e.g. references/tools.md), keeping SKILL.md as a lean overview with one-level-deep pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The per-workflow structure is mostly efficient, but the 'Known Pitfalls' section duplicates pitfalls already stated per-workflow (timestamps, query syntax), and '## When to Use' is pure filler ('This skill is applicable to execute the workflow or actions described in the overview'). This is more than the minor trimming of the score-4 anchor but well short of the severe padding of score 2. | 3 / 5 |
Actionability | Guidance is fully executable for this skill type: exact tool names, ordered sequences with [Required]/[Optional] markers, parameter lists, and copy-paste syntax examples ('avg(last_5m):avg:system.cpu.user{env:prod} > 90'), with live schema lookup correctly delegated to RUBE_SEARCH_TOOLS. Specific examples cover the common metric, log, and tag-filtering cases. | 5 / 5 |
Workflow Clarity | Workflows are clearly sequenced and setup includes connection verification, but the irreversible DATADOG_DELETE_DASHBOARD operation has only a warning ('DELETE is permanent; there is no undo') and no validation checkpoint before executing (e.g., get the dashboard and confirm with the user first). Per the guideline, missing validation for destructive operations caps workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | Sections are well-organized with clear headers, but this is a ~230-line monolithic SKILL.md with all detail inline — including a 20-row quick-reference table and per-domain parameter/pitfall documentation — and no bundle files. The under-50-line simple-skill exception does not apply, and the content could be split into reference files, matching the score-3 anchor of content that should be separate remaining inline. | 3 / 5 |
Total | 14 / 20 Passed |