phase-report

Drafts public-facing investigation reports via deterministic rendering of report.html, findings-report.md, and evidence-map.json.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning verified OSINT findings into a publishable journalist-grade report is slow and error-prone when done by hand. This Skill orchestrates Phase 5 of a Spotlight investigation, rendering structured case data into consistent public-facing report artifacts without manual HTML or Markdown editing. ## Core Features & Use Cases - Deterministic report rendering: Invokes report-drafting and finalize-report.py to generate report.html, findings-report.md, and evidence-map.json with validated finding references and recorded output hashes. - Editorial decision gating: Records an explicit completed or declined decision through the decideReport transition, keeping unfinished leads out of publication. - Hybrid handover mode: When triggered by a data-detective handover, automatically drafts a report whose methodology section spans both upstream data-detective phases and Spotlight phases. - Use Case: After an investigation passes fact-checking and Gate 1 review, a journalist accepts the report offer and receives a localized, sourced HTML report plus a Markdown findings summary and evidence map ready for editorial review. ## Quick Start Ask the orchestrator to draft the public-facing report for the current Spotlight case after the report phase resolves.

Frequently Asked Questions about phase-report

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

FAQPage Schema
How do I generate a public-facing report from Spotlight investigation findings?

Enter Phase 5 from a spotlight_resolve result with phase report and owner phase-report, then accept the drafting offer. The orchestrator authors data/report-draft.json and the decideReport transition renders report.html, findings-report.md, and evidence-map.json deterministically.

What output files does the Spotlight report phase produce?

The phase produces three artifacts: report.html as the public-facing report, findings-report.md as a Markdown findings summary, and evidence-map.json mapping findings to sources. Hashes of all outputs are recorded for provenance.

Can I edit the generated report HTML or Markdown manually?

No, the instructions explicitly prohibit hand-editing generated HTML or Markdown. Editorial control happens upstream through report-draft.json, which sets localized title, deck, finding order, summaries, emphasis, caveats, and next steps before deterministic rendering.

What happens if I decline the report drafting offer?

Declining records a deterministic decline through the same decideReport operation with decision set to declined. The resolver invokes a hash-bound decline helper, and the workflow skips to ingestion since review.html already covers editorial review.

How does report drafting work with a data-detective handover?

When a data-detective-handover directory exists in the case, report-drafting runs in hybrid mode automatically without the offer prompt. The methodology section spans upstream data-detective phases and Spotlight phases, and each finding's path block traces the trail from detector to fact-checker.