report-drafting

Generates validated Markdown, HTML, and evidence-ledger reports from fact-checked investigation findings.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning verified OSINT findings into a publishable report risks citation hallucination, inconsistent formatting, and unverifiable claims. This Skill separates editorial synthesis (done by the model) from deterministic rendering and validation (done by code), so every citation, verdict, and confidence level traces back to ground-truth case files. ## Core Features & Use Cases - Structured draft authoring: The model writes report-draft.json with title, deck, finding order, headlines, summaries, caveats, and next steps, referencing only fact-checked finding IDs. - Deterministic rendering: Code validates finding references and produces three artifacts: findings-report.md (claim-by-claim audit), report.html (designed publication artifact), and evidence-map.json (machine-readable claim-to-source ledger). - Diagram selection: Optionally select flow, hierarchy, network, loop, timeline, or bar diagrams from existing findings data; the renderer owns all Mermaid, SVG, and layout output. - Use Case: After an OSINT investigation passes its fact-check gate, use this Skill to synthesize the verified findings into a publication-ready HTML report with an auditable evidence ledger, without ever hand-editing generated HTML. ## Quick Start Ask the agent to run Phase 5 report drafting on the current case directory so it authors report-draft.json from findings.json and fact-check.json, then renders the final Markdown, HTML, and evidence map.

Frequently Asked Questions about report-drafting

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

FAQPage Schema
How do I generate an investigation report from fact-checked findings?

Author a report-draft.json file that references finding IDs from findings.json and fact-check.json, covering every finding exactly once. The deterministic renderer then validates the references and produces findings-report.md, report.html, and evidence-map.json.

What files does the report-drafting phase produce?

It produces three deliverables: findings-report.md for editors and fact-checkers, report.html as the designed publication artifact, and evidence-map.json as a machine-readable claim-to-verdict-to-source ledger for audit and replication.

Can I edit the generated HTML report by hand?

No. Hand-editing generated HTML or Markdown is explicitly forbidden. If rendering fails, revise only report-draft.json based on the reported failure and re-run the deterministic finalizer, which is byte-deterministic for identical inputs.

How do I add diagrams to an investigation report?

Add an optional diagrams item in report-draft.json selecting flow, hierarchy, network, loop, timeline, or bar types, citing supporting finding IDs and existing connections from findings.json. Never write Mermaid, SVG, CSS, or coordinates yourself; the renderer owns all visual output.

Why does report validation fail on quote selections?

In activated 1.1 cases, quote_selections may contain only an expression_id, never copied quote text. Missing, dangling, tampered, superseded, or withdrawn expression references fail validation before any report artifacts are replaced.