CtrlK
BlogDocsLog inGet started
Tessl Logo

incident-management

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

Quality

88%

Does it follow best practices?

Impact

Pending

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 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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
confighub/confighub-skills
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.