Convert a resolved Slack incident into a reusable on-call debugging skill for the `oncall-investigator-skills` repo. Use when Codex is given a resolved incident channel URL and should decide whether to create a new skill, update an existing skill, or skip because the issue is too one-off; gather evidence from Slack, Jira, BigQuery, Groundcover, product docs, code paths, and existing repo skills; then write the full `SKILL.md`, publish it, and notify the same incident channel unless the user asks for draft-only mode.
Convert a resolved incident into a reusable debugging skill for future on-call investigators.
Produce a complete SKILL.md, not an RCA recap, and prefer future reuse over incident narration.
/Users/adityagupta/Projects/oncall-investigator-skills.Read /Users/adityagupta/Projects/oncall-investigator-skills/.cursor/commands/skill-generator.md first and treat it as the behavioral contract for this skill.
Also inspect:
*/SKILL.md files in /Users/adityagupta/Projects/oncall-investigator-skillshttps://help.spotdraft.com/Match the style, density, and operational usefulness of the existing incident skills in that repo.
execute_sql calls are known to fail.{contract_id}, {workspace_id}, {request_id}, {approval_id}, {template_id}, {cluster}, and {error_message}./Users/adityagupta/Projects/oncall-investigator-skills.NEW_SKILL: a distinct reusable workflow not already coveredUPDATE_EXISTING_SKILL: an existing skill already covers most of the issue, but this incident adds a valuable new failure mode, query, workaround, Jira reference, or environment quirkNO_SKILL: the incident is too one-off or process-specific to justify a reusable skillSKILL.md in the target skill directory.name and description.description invocation-friendly and specific enough that another agent would know when to use the skill.By default, finish the full workflow unless the user explicitly asks for draft-only or no-post mode.
SKILL.md in /Users/adityagupta/Projects/oncall-investigator-skills.skill: add <skill-name> for new skillsskill: update <skill-name> for updatesorigin master.Skill Created: or Skill Updated:If the user asks for draft-only mode, still produce the same artifact and summary locally, but skip commit, push, and Slack posting.
Use this structure when returning the result locally:
DecisionNEW_SKILL, UPDATE_EXISTING_SKILL, or NO_SKILLWhySkill ScopeFinal ArtifactSKILL.md.PublishedIf the decision is NO_SKILL, omit publication steps that were intentionally skipped and explain why.