Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced skill with concrete tool calls, JSON templates, and validation feedback loops. Its weaknesses are redundancy across the event-discovery sections and a monolithic single-file structure with no progressive disclosure of the lengthy reference material.
Suggestions
Consolidate the repeated 'search broadly first' guidance into a single canonical statement to remove redundancy across the Planning, Event Discovery, and Workflow sections.
Move the full chart-definition JSON templates and detailed per-chart-type reference into a separate reference file (e.g., references/chart-types.md) linked from a concise overview, to reduce inline bulk.
Consider surfacing natural-language trigger phrases ('make a chart', 'plot this metric') in the description rather than relying solely on the suggest_when field.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~310-line body restates event-discovery guidance multiple times ('Search BROADLY first', 'broad search first', 'Use broad search terms first', 'BROAD search first') and re-explains the selection rationale, so it is mostly efficient but could be tightened. | 2 / 3 |
Actionability | Provides concrete, copy-paste-ready tool calls (Amplitude:search, get_event_properties, query_dataset, save_chart_edits) and complete JSON definition templates with real parameters, matching the fully-executable anchor. | 3 / 3 |
Workflow Clarity | The 9-step workflow includes an explicit verify step and an error-recovery feedback loop (query_dataset fails → read error → fix → retry; zero results → diagnose → retry), matching the clear-sequence-with-validation anchor. | 3 / 3 |
Progressive Disclosure | No bundle files exist and all content—full JSON definition schemas and detailed per-chart-type reference—is inline in a single ~310-line file; sections are well-organized with headers and a summary table, but reference material that could be split out is kept inline. | 2 / 3 |
Total | 10 / 12 Passed |