Skip to content

AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary

docs: split html synthesis instructions by mode

Trevin Chowc65bd764ddb7
diff --git a/skills/last30days/references/save-html-brief.md b/skills/last30days/references/save-html-brief.md
index 01613eb5..13651d15 100644
--- a/skills/last30days/references/save-html-brief.md
+++ b/skills/last30days/references/save-html-brief.md
@@ -19,12 +19,15 @@ The contract has two modes:
```bash
# 1. Write your synthesis prose VERBATIM to a temp file. The synthesis is the
# "What I learned:" prose label, the bold-lead-in paragraphs with their
-# inline citations as you wrote them in chat, and the "KEY PATTERNS from
-# the research:" numbered list. Do NOT include the badge or the engine
-# footer in the temp file - the engine adds those when it renders the HTML.
-# Use the EXACT text you just wrote in chat. Do not paraphrase, do not
-# summarize, do not reorder. The HTML must read identically to the chat
-# response in voice and citations.
+# inline citations, and the "KEY PATTERNS from the research:" numbered list.
+# Do NOT include the badge or the engine footer in the temp file - the engine
+# adds those when it renders the HTML.
+# - HTML-as-deliverable mode: use the exact synthesis draft you prepared for
+# the artifact. Do not paste it to chat first.
+# - Normal-report-plus-HTML mode: use the exact synthesis text you already
+# wrote in chat.
+# In both modes, do not paraphrase, summarize, or reorder. The HTML must read
+# identically to the intended report in voice and citations.
SYNTHESIS_FILE="/tmp/last30days-synthesis-${CLAUDE_SESSION_ID}.md"
# >| not >: fixed path may already exist on a same-session re-run; a plain >
# is refused under `set -o noclobber`.
diff --git a/tests/test_html_save_contract.py b/tests/test_html_save_contract.py
index 1fbaacdb..82822c70 100644
--- a/tests/test_html_save_contract.py
+++ b/tests/test_html_save_contract.py
@@ -27,6 +27,8 @@ def test_html_deliverable_is_artifact_first_not_full_markdown_repeat():
assert "**HTML as the requested deliverable**" in text
assert 'prose like "give it to me in HTML"' in text
assert "the HTML artifact is the primary output" in text
+ assert "use the exact synthesis draft you prepared for" in text
+ assert "Do not paste it to chat first" in text
assert "do **not** paste the full Markdown report back into chat" in text
assert "The user asked for an HTML deliverable" in text