phase-preflight

Validates storage durability, search backings, integrations, and workspace configuration before OSINT investigations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting an OSINT investigation without verifying the environment leads to silent evidence loss, broken search tooling, and misconfigured case workspaces. This Skill runs a strict preflight checklist that confirms durable case storage, working search and fetch backings, available OSINT skills, and valid knowledge workspace configuration before any investigation begins. ## Core Features & Use Cases - Storage Durability Verification: Writes and reads back a probe file to confirm the case directory lives on durable, user-owned storage that survives the session, preventing total evidence loss. - Sovereign Search/Fetch Detection: Checks Crawl4AI and SearXNG availability, with optional Firecrawl and Apify fallbacks detected via environment keys without echoing secrets. - Skill and Integration Inventory: Confirms required OSINT skills resolve, runs manifest-based integration preflight with model-tier rules, and writes results to .spotlight-config.json. - Use Case: Before launching a new investigation into a corporate entity, run this preflight to confirm the case workspace is durable, SearXNG search is reachable, the OpenKnowledge vault validates, and all required investigator skills load correctly. ## Quick Start Run the Spotlight preflight checks to validate my environment, storage, and integrations before starting a new investigation.

Frequently Asked Questions about phase-preflight

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

FAQPage Schema
How do I validate my environment before starting an OSINT investigation?

Run the Spotlight preflight phase, which checks durable case storage, search and fetch backings, required OSINT skills, and vault configuration in order. It stops at the first failure and writes results to .spotlight-config.json.

What search and scraping tools does Spotlight preflight check?

Preflight checks Crawl4AI for fetching and a self-hosted SearXNG instance for search as the default sovereign backings. Firecrawl and Apify are optional fallbacks enabled only when FIRECRAWL_API_KEY or APIFY_API_TOKEN are present.

Does Spotlight work without Firecrawl or Apify API keys?

Yes, a pure-sovereign install using Crawl4AI and SearXNG is fully supported without any API keys. Firecrawl and Apify are optional escape hatches, and preflight continues as long as one search and one fetch backing are available.

Why does Spotlight preflight write a probe file to the case directory?

The probe verifies that CASE_ROOT is durable, user-owned storage that survives the session. Some runtimes use ephemeral filesystems where a case would validate green but be destroyed at session end, causing total evidence loss.

What happens when a preflight check fails?

Preflight stops at the first failure and prompts the user with a specific remediation message, such as providing an absolute durable storage path or installing Crawl4AI. It never silently falls back to an unverified location.