fix(explain-diff): arrow class no longer collides with edge callout; bundle fill_template.py

Eval iteration 1: the callout 'edge' variant picked up the diagram connector styles, and all three skill runs hand-wrote a template filler. fill_template.py takes values.json with @fragment files, escapes </ in the quiz; suite 21 checks.
This commit is contained in:
bchanot committed 2026-10-17 13:10:37 +02:00
1 parent b353fac2ba
commit faedb98699
5 files changed
+112 -19

No files matched your search

+12 -5
View File
@@ -113,11 +113,18 @@ less than three styled boxes.
The skill folder is `$HOME/.claude/skills/explain-diff/`.
1. Read `references/components.md` (the snippet catalog), then start from
a copy of `assets/template.html`.
2. Replace every `{{…}}` placeholder. Section ids stay `background`,
`intuition`, `code` and `quiz`: the table of contents and the checker
rely on them.
1. Read `references/components.md` (the snippet catalog) and the
placeholders of `assets/template.html`.
2. Write each section body as its own HTML fragment file, the quiz as a
JSON list, and a `values.json` mapping every placeholder to its text or
to `@<fragment file>`. Keep these working files in a temporary folder,
never in the repo. Then build the page:
```bash
python3 "$HOME/.claude/skills/explain-diff/scripts/fill_template.py" values.json <file>
```
It refuses a missing or unknown placeholder. Section ids stay
`background`, `intuition`, `code` and `quiz`: the table of contents and
the checker rely on them.
3. Code goes in `<pre>` blocks, HTML-escaped (`<` as `&lt;`, `>` as `&gt;`,
`&` as `&amp;`). An unescaped `<T>` generic or JSX tag silently swallows
the code that follows it.