Structured workflows for investigating production issues in Honeycomb — the sequence of tool calls (context priming, broad query, BubbleUp, trace analysis, verification) and how to chain results between steps to reach root causes. Trigger phrases: "investigate production issue", "debug latency spike", "find root cause", "use BubbleUp", "analyze traces", "debug an outage", "why is my API slow", "errors are increasing", "health check", "SLO burning", or any request to investigate or debug production problems.
80
100%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly identifies its domain (Honeycomb production issue investigation), lists specific workflow steps and tool calls, and provides extensive natural-language trigger phrases. The description is well-structured with both capability details and explicit trigger guidance, making it easy for Claude to select appropriately from a large skill set.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: context priming, broad query, BubbleUp, trace analysis, verification, and describes chaining results between steps to reach root causes. These are concrete, named workflow steps. | 3 / 3 |
Completeness | Clearly answers both 'what' (structured workflows for investigating production issues with specific tool call sequences) and 'when' (explicit trigger phrases section listing numerous natural language triggers). The 'Trigger phrases:' clause serves as an explicit 'Use when' equivalent. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would actually say: 'debug latency spike', 'why is my API slow', 'errors are increasing', 'SLO burning', 'find root cause', 'debug an outage'. These span both technical and conversational phrasings. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — specifically scoped to Honeycomb production investigation workflows with named Honeycomb-specific features (BubbleUp, trace analysis, SLO). Unlikely to conflict with generic debugging or monitoring skills due to the Honeycomb-specific tooling references. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
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. The content is concise while covering multiple investigation patterns, error recovery, and anti-patterns. The progressive disclosure is well-structured with clear references to detailed guides and related skills.
| 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 provides specific tool calls (get_workspace_context, run_bubbleup, get_trace, create_board), concrete query patterns (P99(duration_ms), HEATMAP, COUNT with filters), and detailed interpretation guidance for BubbleUp results and trace waterfalls. The investigation patterns section provides copy-ready sequences for common scenarios. | 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 'Stay on the Path' section reinforces the feedback loop by discouraging skipping verification. The 'When Results Are Empty' section provides error recovery guidance. The workflow has clear checkpoints and chaining between steps (BubbleUp findings become WHERE filters for traces). | 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 are clearly organized. The main content is appropriately scoped as an overview without inlining reference material. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
7f27e27
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.