Use when the user is in the middle of a production incident and needs an orchestrated plan — phrases like "we have an outage", "prod is crashing", "page me through this", "what do I do first?", "mitigate or roll back?", "production is down since the last release", "something's broken in staging — help me triage", "we're on an incident call, walk me through the ConfigHub side", "post-incident cleanup". Triage the situation, decide between stabilize-and-mitigate vs head-moving rollback vs drift reconciliation, route to the right mutation skill with the scope and `--change-desc` composed, and drive the post-incident verification + close-out. Do not load for planned releases (use `promote-release`), for routine change management, or for single-Unit edits the user is confidently making on their own (use `cub-mutate`).
89
88%
Does it follow best practices?
Impact
Pending
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 an excellent skill description that thoroughly covers trigger scenarios with natural user language, clearly defines what the skill does with specific concrete actions, and explicitly disambiguates from related skills. The 'Do not load for...' section is a particularly strong addition that reduces conflict risk. The description uses appropriate third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: triage the situation, decide between stabilize-and-mitigate vs rollback vs drift reconciliation, route to the right mutation skill with scope and --change-desc, and drive post-incident verification + close-out. | 3 / 3 |
Completeness | Clearly answers both 'what' (triage, decide between mitigation strategies, route to mutation skills, drive post-incident verification) and 'when' (explicit 'Use when' clause with extensive trigger phrases). Also includes explicit 'do not use when' guidance for disambiguation. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural phrases users would actually say during an incident: 'we have an outage', 'prod is crashing', 'page me through this', 'what do I do first?', 'mitigate or roll back?', 'production is down', 'something's broken in staging', 'post-incident cleanup'. These are highly realistic trigger phrases. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche (production incidents/outages). Explicitly disambiguates from related skills by naming them ('promote-release' for planned releases, 'cub-mutate' for single-Unit edits), which strongly reduces conflict risk. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong orchestrator skill that excels at actionability and workflow clarity — the triage decision tree, three clear paths, hand-off protocols, and stop conditions are well-designed for high-pressure incident scenarios. The main weaknesses are moderate verbosity (some explanatory prose that Claude doesn't need) and the length of the single file, which could benefit from splitting detailed sections into referenced sub-documents. The `--change-desc` templates and CLI commands are particularly well-crafted for copy-paste use during incidents.
Suggestions
Trim explanatory prose that Claude already knows (e.g., 'An incident is an ongoing loss of service', 'This costs nothing in the moment and saves hours in the postmortem') to reduce token usage by ~10-15%.
Consider extracting the mitigation table and close-out checklist into referenced sub-files (e.g., `mitigation-patterns.md`, `close-out-checklist.md`) to improve progressive disclosure and reduce the main file's length.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is thorough and mostly earns its length given the complexity of incident orchestration, but some sections are slightly verbose — e.g., the 'Principle' section, the 'Do not load for' list (which duplicates frontmatter), and some explanatory asides like 'This costs nothing in the moment and saves hours in the postmortem' that Claude doesn't need to be told. Overall reasonably efficient for the scope but could be tightened. | 2 / 3 |
Actionability | Highly actionable throughout: concrete CLI commands for triage queries, specific restore-target syntax, a mitigation table mapping symptoms to exact mutation commands, structured hand-off instructions with `--change-desc` templates, and executable tag/verify commands for close-out. Every path has copy-paste-ready commands and clear routing decisions. | 3 / 3 |
Workflow Clarity | Excellent multi-step workflow with five explicit triage questions that route to three clearly defined paths (A/B/C), each with sequenced steps and validation checkpoints. The 'Stop conditions' section acts as guardrails, the 'Verify chain' section provides explicit post-action validation, and feedback loops are present (e.g., 'confirm the targeted skill returned success before the next step'). The 'After green — close-out' section provides a clear post-incident checklist. | 3 / 3 |
Progressive Disclosure | References to companion skills and reference files are well-signaled at the bottom, and the skill appropriately delegates mutations to other skills. However, no bundle files were provided to verify the referenced paths exist, and the skill itself is quite long (~250 lines) with the mitigation table and close-out details that could potentially be split into referenced sub-documents. The content is well-organized with clear headers but is borderline monolithic. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
59ea831
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.