Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a lean, well-sequenced investigation workflow with explicit validation checkpoints and concrete tool calls. Its main gap is actionability: the central analysis steps are routed through unlinked, unexplained bolded procedure names rather than self-contained instructions or file references.
Suggestions
Resolve the bolded procedure references ("Reading chart data", "Analyzing chart", "Finding the right event properties", "Getting experiments", "Getting deployments", "Searching for content") into actual file links or inline instructions so the core operations are self-contained.
Add one short worked example showing the output of a spike investigation end-to-end (pattern → segmentation → context → synthesis) so the workflow is copy-paste concrete.
Clarify what "Finding the right event properties" returns and how its output feeds into the Step 3 segmentation, since that handoff is currently implicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence, never explaining what Amplitude or a chart is, and every line is actionable guidance or a concrete bound ("up to 9 high-signal properties", "up to 3 charts at a time") with no padded exposition. | 3 / 3 |
Actionability | Concrete tool calls like `Amplitude:getting_data_from_url` and `Amplitude:get_feedback_insights` are present, but the core analytical operations are delegated to bolded procedure names ("Reading chart data", "Analyzing chart", "Finding the right event properties") that are neither linked nor explained, leaving key details missing. | 2 / 3 |
Workflow Clarity | Steps 0–5 are clearly sequenced with explicit validation checkpoints and stop conditions ("If chart data cannot be retrieved or is empty, do not proceed"; "ask explicitly ... and stop"), and the read-only nature means the destructive-operation cap does not apply. | 3 / 3 |
Progressive Disclosure | The content is well-organized into clearly delineated sections (When to Use, Steps 0–5, Best Practices) with no monolithic wall of text and no deeply nested references, satisfying the well-organized-sections bar for a self-contained skill. | 3 / 3 |
Total | 11 / 12 Passed |