endor-troubleshooting-scans

Diagnose Endor Labs scan regressions by comparing scan pairs and searching logs.

4|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/endorlabs/endorlabs-sdk --skill endor-troubleshooting-scans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: endor-troubleshooting-scans
Source: https://github.com/endorlabs/endorlabs-sdk/tree/main/agent-knowledge/skills/endor-troubleshooting-scans
Command: npx skills add https://github.com/endorlabs/endorlabs-sdk --skill endor-troubleshooting-scans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose why an Endor Labs scan regressed, failed, or produced suspiciously different results between runs by comparing scan results, checking logs, and isolating dependency-resolution issues.

Core Features & Use Cases

  • Project and scan resolution: Resolve projects from names or Endor app scan-history URLs and identify the relevant scan window.
  • Regression analysis: Compare adjacent or user-supplied scan pairs, rank anomalies, and diff aggregate metrics such as status, dependency counts, and finding totals.
  • Error triage: Search embedded scan logs for failure signatures, fall back to scan log retrieval when needed, and probe package-version resolution errors when dependency metrics collapse.
  • Use case: A scan suddenly reports fewer dependencies and partial success; this Skill compares the latest scans, surfaces embedded resolution errors, and points you to the likely root cause.

Quick Start

Ask the assistant to analyze the latest two scans for a project, compare their metrics, and search for embedded error messages or dependency-resolution failures.

Frequently Asked Questions about endor-troubleshooting-scans

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

FAQPage Schema
How do I find the root cause of an Endor Labs scan regression?

To diagnose an Endor Labs scan regression, compare adjacent scan pairs to rank anomalies, diff aggregate metrics like dependency counts, and search embedded scan logs for failure signatures to isolate the root cause.

Why does my scan suddenly report fewer dependencies and partial success?

A scan reporting fewer dependencies and partial success often indicates a dependency-resolution collapse; you can probe package-version resolution errors and search embedded scan logs to pinpoint the specific resolution failure.

How do I compare two Endor Labs scans to identify metric differences?

Comparing Endor Labs scans involves resolving the project from an app scan-history URL, selecting a bounded scan-window retrieval, and diffing aggregate metrics such as status, dependency counts, and finding totals.

Can I use a scan-history URL to triage recent Endor Labs scan failures?

Yes, you can use an app scan-history URL to resolve projects and apply heuristic recent-run triage to identify the relevant scan window and isolate failure signatures.

What is the best way to troubleshoot dependency resolution errors in scan logs?

Troubleshooting dependency resolution errors requires searching embedded scan logs for failure signatures, applying log fallback handling if needed, and probing package-version resolution errors during metric collapse.

When should I use bounded scan-window retrieval for scan troubleshooting?

Bounded scan-window retrieval is necessary when diagnosing pipeline regressions on recent runs, ensuring analysis focuses strictly on relevant adjacent scan pairs rather than overwhelming the comparison with unrelated historical data.