← ClaudeAtlas

explain-doclisted

Explanation pages in the user's HTML style (html-style) that make a concept understood rather than list an API - an algorithm, a data structure, a protocol, an architecture, a piece of math or physics, how a system or a feature works - each page in two versions switched in place (Simple - analogies, plain words, concrete numbers; Technical - precise terms, formulas, complexity, edge cases, code, sources) with diagrams (inline SVG), step-by-step animations (stepper with play / step controls), formulas (MathML, offline), interactive examples (sliders / inputs computing live results and charts, simulations checking the formulas), worked examples, pitfalls, check-yourself questions and a glossary. Static self-contained page. Use whenever the user asks to explain how something works with a page / visual / interactive explanation, a tutorial for understanding, an explainer, or "une explication simple et une technique".
TsukiNi22/ai-utils · ★ 1 · AI & Automation · score 74
Install: claude install-skill TsukiNi22/ai-utils
# Explanation pages (Simple | Technical) `SKILL_DIR` = directory of this file. Built on **`html-style`** (`../html-style`: tokens, components, rules, `new_page.py`, `check_style.py`): load it first. Not for API references or user guides (`html-doc`), nor for the reference of a protocol - its frames, codes, commands (`protocol-doc`; an explanation page can link to it), nor for reports (`report`). ## 1. Ask (one AskUserQuestion call, French), unless already given 1. **Public visé par défaut** (level shown at the first visit): `Simple (Recommandé)` · `Technique`. 2. **Langue** : `Anglais (Recommandé)` · `Français` · `Bilingue EN / FR` (`--lang-switch`, `html-style`). Not asked when the folder already holds `html-doc` pages: the page follows the site (bilingual EN / FR like them). 3. **Emplacement** : `docs/explain/<sujet>.html (Recommandé)` (in a repository) · `Dossier courant` · other. Both levels are always written; the switch (and `?level=simple|technical` in the address) picks the one shown. ## 2. Build ```bash python3 ../html-style/scripts/new_page.py SKILL_DIR/templates/explain.body.html -o <out>.html \ --css SKILL_DIR/templates/explain.css --js SKILL_DIR/templates/explain.js \ --actions SKILL_DIR/templates/actions.html --attr data-page=explain data-nav-title="<tab name>" \ --set PROJECT="..." TITLE="..." SUBTITLE="..." FOOTER="..." python3 ../html-style/scripts/sync_nav.py <folder of the page> ``` `explain.body.html` is a complete working example (hash t