knowledge-raptor

Search and teach a RAPTOR knowledge base of runbooks, incidents, and service dependencies.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill knowledge-raptor-erwinv2k-tkg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: knowledge-raptor
Source: https://github.com/erwinv2k-TKG/AgentesVSC/tree/main/packs/incidentfox/sre-agent/.claude/skills/knowledge-raptor
Command: npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill knowledge-raptor-erwinv2k-tkg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve? During incident response, engineers waste time hunting through wikis and chat history for known fixes, past incidents, and service dependency information. This Skill queries the RAPTOR knowledge base directly, surfacing curated runbooks, similar past incidents, and dependency graphs before falling back to Confluence. ## Core Features & Use Cases - Incident-Aware Search: Match current symptoms against runbooks and past incidents, optionally filtered by affected service. - Service Dependency Graph Queries: Look up dependencies, dependents, owners, runbooks, and blast radius for any service entity. - Similar Incident Retrieval: Find historical incidents with matching symptoms to reuse known resolutions. - Knowledge Teaching: Record new learnings from an investigation with typed knowledge (procedural, factual, etc.), entity links, and confidence scores, with automatic duplicate and contradiction detection. - Use Case: When payment-gateway returns 503 errors, search for matching runbooks, check the blast radius of the service, find similar past incidents, and after resolution teach the root cause back to the knowledge base. ## Quick Start Ask the agent to search the RAPTOR knowledge base for runbooks and past incidents matching the current symptoms of the affected service.

Frequently Asked Questions about knowledge-raptor

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

FAQPage Schema
How do I search a knowledge base for incident runbooks by symptoms?

Run search_incident.py with a --symptoms description and optionally a --service filter. It returns matching runbooks, past incidents, and service context ranked by relevance from the RAPTOR API.

How do I find the blast radius of a service dependency failure?

Use query_graph.py with --entity set to the service name and --query-type blast_radius. The script returns direct dependents, total affected count, and the list of impacted services from the dependency graph.

Does the RAPTOR knowledge base require authentication or API tokens?

No credentials are needed. RAPTOR is an internal Kubernetes service reached directly via ClusterIP, and the client only needs the RAPTOR_URL environment variable pointing at the service endpoint.

Should I search RAPTOR or Confluence first during an incident?

Start with RAPTOR because it holds structured knowledge learned from past investigations, including runbooks and incident patterns. Fall back to Confluence for detailed architecture docs and team wikis, then teach new findings back to RAPTOR.

What happens if I teach duplicate or contradictory knowledge?

The teach endpoint automatically detects duplicates and contradictions. The response status indicates whether the knowledge was created, merged with an existing node, flagged as a duplicate, or marked as a contradiction pending review.