spotlight

Orchestrates OSINT investigations from lead intake through gated findings and knowledge ingestion.

43|8|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/buriedsignals/spotlight --skill spotlight-buriedsignals
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spotlight
Source: https://github.com/buriedsignals/spotlight/tree/main/skills/spotlight
Command: npx skills add https://github.com/buriedsignals/spotlight --skill spotlight-buriedsignals

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Open-source investigations often stall as unstructured research: leads get lost, claims go unverified, and unfinished work gets treated as publishable fact. Spotlight turns a lead into a structured case file with a scoped brief, approved methodology, sourced findings, independent fact-checking, and provenance records, enforced by human approval gates. ## Core Features & Use Cases - Gated investigation orchestration: Sequences phases (brief, methodology, execution, fact-check, report, ingestion) and requires explicit user approval at each gate before proceeding. - Delegated agent research: Spawns investigator and fact-checker agents with iteration limits, evidence grounding rules, and readiness criteria such as minimum high-confidence findings and independent sources per claim. - Durable case state and recovery: Tracks phase, attempts, and resume state via a resolver so interrupted investigations recover without re-reading artifacts. - Use Case: A journalist receives a tip about a suspicious government contract. Spotlight creates a case directory, drafts a methodology for approval, runs bounded research cycles against public sources, fact-checks each claim, and presents verified findings at Gate 1 for editorial review. ## Quick Start Ask the agent to investigate a lead, for example: "Investigate the ownership network behind this company and verify the claims in this document."

Frequently Asked Questions about spotlight

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

FAQPage Schema
How do I run an OSINT investigation with an AI agent?▼

Provide a lead, URL, document, entity, or question and the orchestrator creates a case directory, drafts a methodology for your approval, then delegates research to investigator and fact-checker agents. Each phase ends at a human gate requiring your explicit approval before continuing.

What search and scraping tools does Spotlight support?▼

Spotlight uses abstract tool verbs that runtime adapters bind to integrations such as SearXNG for search and Crawl4AI for scraping. If a verb is unsupported by your adapter, the orchestrator stops and reports the gap rather than silently substituting.

Can Spotlight run investigations without internet access?▼

Yes, sensitive mode strips fetch and search from agent permissions, restricting research to local case files and the knowledge vault. Such investigations are flagged as constrained rather than verified at Gate 1 since new-source readiness criteria cannot be met.

What happens when an investigation stalls or fails readiness checks?▼

After five execution cycles without meeting readiness criteria, the stall protocol presents the gaps and offers options: continue cycles, pivot the angle, or review current findings as-is. It never auto-advances past a failed gate.

How does Spotlight verify findings before publication?▼

Every finding requires a locally scraped source file, verbatim quotes, and grounding metadata linking claims to evidence. A fact-checker agent independently verifies claims, and Gate 1 requires at least three high-confidence findings with two or more independent sources per key claim.