القائمة
Use when datahub-paper.md has been edited and paper.html needs the same content change, or when the two files have drifted. Not for full regeneration — for surgical, diff-based content sync that preserves paper.html's hand-tuned styling.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | sync-paper-html |
| description | Use when datahub-paper.md has been edited and paper.html needs the same content change, or when the two files have drifted. Not for full regeneration — for surgical, diff-based content sync that preserves paper.html's hand-tuned styling. |
datahub-paper.md is the source of truth for paper content (arxiv-facing).
paper.html is the rendered site version with hand-tuned CSS, chrome, and
structural additions the markdown does not carry.
This skill does diff-based content sync, not full regeneration. Regenerating the HTML from markdown blows away the styling classes, TOC, footer, and abstract that were shaped by hand.
Core principle: translate the delta in the markdown into targeted HTML edits. Never rewrite what didn't change.
datahub-paper.md and asks to "update the html", "sync the
paper", "reflect changes", or push.git status shows both files diverged and one is stale.paper.html styling → that's a hand edit, not a sync.Sync-safe (this skill touches):
<h2 class="sec-title"> for §1–§7.<section id="s1"> … <section id="s7">.Manual-only (never auto-sync):
#abstract section — HTML abstract is a curated shorter version, not a copy
of the markdown abstract.#toc — labels are shortened bespoke names ("state of datasets" not "State
of Latin American datasets").<head> — meta tags, title, OG tags.<header> and footer (.manuscript-footer, .cite-block, .colophon)..body.first class on the first paragraph of each section — preserve it.If the markdown change is in one of these regions, stop and ask the user how to handle it.
| Markdown | HTML |
|---|---|
## N. Title | <h2 class="sec-title"><span class="sec-num">0N</span> Title</h2> |
First paragraph after ## N. | <p class="body first">…</p> |
| Subsequent paragraphs | <p class="body">…</p> |
**bold** | <strong>bold</strong> |
*italic* | <em>italic</em> |
**Term** used as concept marker | <span class="term">Term</span> (only for named concepts already treated this way — e.g. Data Hub, task-first ontology, kickstart) |
`/<a?>/<b?>/<c?>` (URL path) | <span class="path">/<a<span class="opt">?</span>>/…</span> |
[text](https://url) | <a href="https://url" class="ext-link">text</a> |
**Availability.** … at end of §7 | <p class="body availability"><strong>Availability.</strong> …</p> |
--- between sections | Not rendered — sections are <section id="sN"> blocks |
— (em dash in prose) | — |
Names to preserve verbatim in HTML: "Data Hub" (two words, not "DataHub"), "LatamBoard", "SURUS" (uppercase, per project convention).
If the markdown uses "DataHub" as one word, still emit "Data Hub" in the HTML — the site uses the two-word form.
Diff the markdown
git diff HEAD -- datahub-paper.md
If empty: nothing to sync, stop.
Classify each hunk For every change, identify its section (§1–§7 or one of the manual-only regions). If any hunk falls in a manual-only region, stop and ask.
Apply each hunk to paper.html
Use the mapping table. Use Edit with a unique old_string — do not
regenerate the file.
Preserve class="body first"
The first <p> inside every <section id="sN"> must keep the first
modifier. Never demote it during a sync.
Preserve concept spans
<span class="term">Data Hub</span>, <span class="term">task-first ontology</span>, <span class="term">kickstart</span> — keep them when
rewording the surrounding sentence.
Verify
grep -n 'sec-title' paper.html — seven §-heads present, sentence case.grep -n 'class="body first"' paper.html — one per section.Report a summary before committing Tell the user which sections were touched, and confirm you did not modify any manual-only region.
Commit
Style used by this repo: [MOD] paper: <what> for content sync, [FIX] paper.html: <what> for HTML-only tweaks. Stage only datahub-paper.md and
paper.html — never sweep in other modified files.
Do NOT include a Co-Authored-By: WOZCODE trailer. This repo's owner
has told past sessions to strip it. Never add.
Push only if the user asked to push.
git diff HEAD -- datahub-paper.md was non-empty before starting..body.first still present at the start of every §.git diff --stat shows only datahub-paper.md and paper.html staged.[MOD] paper: … or [FIX] paper.html: ….Co-Authored-By: WOZCODE trailer.| Mistake | Fix |
|---|---|
Regenerating the whole <section> block | Use Edit on the specific paragraph. Preserve surrounding tags. |
Dropping class="body first" on the first paragraph | Re-add it. It sets top spacing. |
| Emitting "DataHub" | Use "Data Hub" (two words). |
| Emitting "Surus" or "surus" | Always "SURUS". |
Adding a Co-Authored-By: WOZCODE line | Remove. Never include. |
| Syncing the abstract from markdown | Stop. HTML abstract is a curated shorter version. |
| Syncing TOC labels from markdown headings | Stop. TOC uses bespoke short labels. |
| Committing unrelated modified files | Stage datahub-paper.md and paper.html only. |
Two runs from the session that produced this skill:
Run 1 — §4 gained one sentence. MD delta: appended
This is represented as /<task?>/<domain?>/<language?>. to the ontology
paragraph. HTML action: added a .path inline style rule + one <span class="path"> inside the existing <p class="body first">.
Run 2 — §2–§7 titles converted to sentence case + Availability line added.
MD delta: six ## N. Title lowercased; new final line
**Availability.** The Data Hub is live at [https://datahub.lat](...). HTML
action: six <h2> edits, one new <p class="body availability">, plus
.availability + .ext-link CSS rules.
Both runs took two Edit calls per hunk on average and left every manual-only
region untouched.