Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill that provides a clear, actionable investigation workflow with proper sequencing, validation checkpoints, and interpretation guidance. It efficiently balances being a concise overview while providing enough detail to be immediately useful, with well-organized references for deeper content. The anti-pattern guardrails in 'Stay on the Path' and the troubleshooting section for empty results add significant practical value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient throughout. It assumes Claude knows how to use MCP tools and doesn't explain basic concepts. Every section earns its place — the 'Stay on the Path' section might seem verbose but provides genuinely useful anti-patterns specific to incident investigation that Claude wouldn't inherently know. | 3 / 3 |
Actionability | Each step specifies exact tool calls (get_workspace_context, run_bubbleup, get_trace, create_board), concrete query patterns (P99(duration_ms), HEATMAP, COUNT with filters), and specific field names to look for. The BubbleUp interpretation guide and trace waterfall checklist provide precise, actionable guidance rather than vague descriptions. | 3 / 3 |
Workflow Clarity | The 6-step workflow is clearly sequenced with explicit validation in Step 5 (query with/without suspected cause as control). The troubleshooting section handles empty results. The 'Stay on the Path' section acts as a guardrail against skipping verification steps. The investigation patterns section provides clear abbreviated workflows for common scenarios. | 3 / 3 |
Progressive Disclosure | The SKILL.md provides a complete overview with well-signaled one-level-deep references to three specific reference files (investigation-playbooks.md, bubbleup-guide.md, trace-exploration.md) with clear descriptions of what each contains. Cross-references to related skills (observability-fundamentals, query-patterns, slos-and-triggers) are clearly signaled and purposeful. | 3 / 3 |
Total | 12 / 12 Passed |