build-incident-history

Transform raw incident dumps into validated SUMMARY.md dossiers and inventory files.

2|Updated May 28, 2026
One-click install
npx skills add https://github.com/tsuga-dev/agent-plugins --skill build-incident-history
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-incident-history
Source: https://github.com/tsuga-dev/agent-plugins/tree/main/plugins/tsuga/skills/build-incident-history
Command: npx skills add https://github.com/tsuga-dev/agent-plugins --skill build-incident-history

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

build-incident-history converts raw incident inputs into a structured incident-history archive that downstream agents can reliably search and reason over.

Core Features & Use Cases

  • Creates per-incident dossiers: Generates one folder per incident containing a validated SUMMARY.md with a documented Diagnostic path.
  • Builds a stable retrieval index: Writes an _inventory.csv and preserves metadata.json fields used by snapshot filtering.
  • Bootstraps from heterogeneous sources: Accepts Slack exports, incident reports, GitHub PR/issue artifacts, and Tsuga CLI command logs to reconstruct incident narratives.

Quick Start

Use the build-incident-history skill to generate skills/incident-history/references/incidents/ from local raw inputs in inputs/incidents/<INC-id>/.

Frequently Asked Questions about build-incident-history

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a searchable incident history archive from raw Slack exports and CLI logs?

You can build an incident history archive by feeding raw Slack exports, GitHub artifacts, and Tsuga CLI logs into a processor that generates validated SUMMARY.md dossiers and retrieval indexes. This transforms heterogeneous incident inputs into structured, searchable records.

What is the best way to structure incident metadata for downstream agent retrieval?

Structuring incident metadata for retrieval requires generating metadata.json fields and an _inventory.csv index alongside per-incident SUMMARY.md files. This deterministic structure with canonical section order enables downstream agents to reliably search and reason over incident histories.

Can I bootstrap an incident knowledge base from GitHub PR artifacts and incident reports?

Yes, you can bootstrap an incident knowledge base from GitHub PR artifacts, incident reports, and Tsuga CLI command logs. The process accepts these heterogeneous sources to reconstruct incident narratives and output validated dossiers under an incidents directory.

How do I preserve a copyable diagnostic path with real tsuga CLI syntax in incident summaries?

Preserving a diagnostic path in incident summaries requires a transformation process that enforces canonical section order and documents real tsuga CLI syntax directly within a validated SUMMARY.md dossier for each incident.

Does building an incident history archive require specific input folder structures?

Yes, building the archive requires placing raw incident inputs like metadata, timelines, and paging context into local inputs/incidents/<INC-id>/ folders so the processor can generate the corresponding output dossier and inventory files.

Why use a structured incident archive instead of keeping raw incident dumps?

A structured incident archive replaces raw dumps with validated SUMMARY.md dossiers and metadata-driven artifacts, solving the problem of unreliable search by providing deterministic structure and stable retrieval indexes for downstream reasoning.