CtrlK
BlogDocsLog inGet started
Tessl Logo

production-investigation

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

Quality

100%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
honeycombio/agent-skill
Reviewed

Table of Contents

Is this your skill?

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.