ingest

Archives verified investigation findings into a structured knowledge vault with registries and claim notes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? After an OSINT investigation concludes, confirmed findings risk being lost in case-local files. This Skill stages and commits approved findings into a durable, queryable knowledge vault with consistent schemas, registries, and cross-linked notes. ## Core Features & Use Cases - Structured Vault Ingestion: Creates or updates investigation, entity, methodology, tool, and claim notes with strict frontmatter contracts and kebab-case IDs. - Eligibility-Gated Claims Layer: Only findings with verified or partially_verified verdicts, adequate grounding, sources, and non-RLM origin become claim notes; every exclusion is logged. - Atomic Registry Updates: Maintains master, investigations, entities, methodology, tools, and claims registries plus a derived alias index and human-gated merge proposals. - Use Case: After fact-checking a corporate investigation, run this Skill to archive verified claims into the vault, link entities across cases, and update the knowledge base index for future retrieval. ## Quick Start Ingest the approved findings from the current case directory into the knowledge vault and update all registries.

Frequently Asked Questions about ingest

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

FAQPage Schema
How do I archive investigation findings into a knowledge vault?▼

Run the ingest process after fact-checking completes: it reads findings.json, fact-check.json, investigation-log.json, and summary.json from the case directory, then creates investigation, entity, methodology, tool, and claim notes while updating all vault registries atomically.

Which findings become claim notes in the vault?▼

Only findings passing the eligibility gate become claim notes: verdict verified or partially_verified, grounding confidence_cap above low, at least one source reference, and non-RLM origin. Excluded findings are logged with reasons and remain flagged in the investigation note.

Does the ingest skill handle duplicate entities or aliases?▼

Yes. New entity names and aliases are normalized and checked against the derived alias index. Collisions produce entries in entities/_merge-proposals.json for human review; ingest never merges entities automatically and proceeds with both entities separate.

What happens if ingestion fails partway through?▼

A vault-level .ingest-lock prevents concurrent runs, and the journaled commit resumes or restores the exact pending operation rather than starting over. The case-local ingestion.json receipt is updated to failed while preserving its dependency digest.

Can a later investigation update an existing claim note?▼

Later investigations never rewrite existing claim content. Re-verification or supersession appends a dated row to the claim's Supersession History table, updates verified/verified_by frontmatter, and may promote the layer from lead to durable.