Diagnoses and routes failures by analyzing error patterns, classifying severity, and applying retry logic, suppression budgets, and escalation rules. Use when handling errors, troubleshooting failures, recovering from API errors or timeouts, deciding whether to retry or escalate an issue, or managing service outages and tool dependency failures. Applies to any scenario where a check has failed, evidence of success is missing, or an unresolved error needs a structured response. Includes explicit untrusted-content/prompt-injection guardrails for third-party inputs.
98
Quality
94%
Does it follow best practices?
Impact
100%
1.16xAverage score across 9 eval scenarios
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 an excellent skill description that clearly articulates specific capabilities (error pattern analysis, severity classification, retry logic, escalation rules) and provides comprehensive trigger guidance. The description uses appropriate third-person voice, includes natural user terminology, and carves out a distinct niche for error handling and failure recovery scenarios.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'analyzing error patterns', 'classifying severity', 'applying retry logic', 'suppression budgets', and 'escalation rules'. Uses third person voice correctly. | 3 / 3 |
Completeness | Clearly answers both what ('Diagnoses and routes failures by analyzing error patterns...') AND when with explicit 'Use when...' clause covering multiple trigger scenarios including error handling, troubleshooting, recovery, and escalation decisions. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'errors', 'failures', 'troubleshooting', 'API errors', 'timeouts', 'retry', 'escalate', 'service outages', 'tool dependency failures'. These are terms users naturally use when encountering problems. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on error handling, failure diagnosis, and recovery logic. The combination of retry logic, suppression budgets, and escalation rules creates a distinct domain unlikely to conflict with general coding or documentation skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured error triage skill with excellent workflow clarity and appropriate conciseness. The validation checkpoint and explicit tier-to-action mappings provide clear guidance. The main weakness is the pseudocode for suppression budget tracking rather than executable code, though the concrete examples partially compensate by showing how to apply the framework.
Suggestions
Convert the suppression budget pseudocode to executable Python with concrete implementations for budget_store operations
Add executable code snippets for the retry logic with exponential back-off mentioned in Example 2
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, avoiding explanations of concepts Claude already knows. Every section serves a purpose with no padding or unnecessary context about what errors are or how triage works conceptually. | 3 / 3 |
Actionability | Provides clear tier definitions and concrete examples, but the suppression budget code is pseudocode rather than executable. The workflow steps are clear but lack fully executable implementations for the retry/escalation logic. | 2 / 3 |
Workflow Clarity | Excellent 5-step workflow with explicit validation checkpoint preventing advancement when tier is unknown. Clear feedback loop pattern (detect → gather → classify → execute → report) with explicit escalation conditions and the 'do not advance' guardrail. | 3 / 3 |
Progressive Disclosure | Well-organized with clear sections progressing from triggers to tiers to workflow to examples. The note about extracting suppression budget to a separate file for advanced implementations shows appropriate awareness of when to split content. | 3 / 3 |
Total | 11 / 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.
Install with Tessl CLI
npx tessl i markusdowne/error-triage-ladder@0.1.3Reviewed
Table of Contents