Skip to content

Commit d5bcecc

Browse files
committed
The guide goes by what a chat has, not by its name
The how-to and the build page gave their steps by product: where the skill goes in Claude, ChatGPT and Grok, which of them builds the file, and what each lacks. Grok imported the zip under Skills on 2026-11-13 and had no place for one two days later, so such a step sends its reader the wrong way until it is edited again. Each step now names what a reader can look for in their own chat and says what to do with it and without it: a place for skills, plugins, or neither for the skill; code that runs Node.js and gets the build tool, or the source for the build page; and for the build archive a project, or the message. No page says what one product does or lacks. The chats in the titles stay as examples, and what was seen in each chat stays in the comments and the README with its date. The help entry on a chat's link said a link is made by running code: the skill gives the build page's plain address and no link (h5p-toolkit#215). Closes #80.
1 parent 19dc77d commit d5bcecc

4 files changed

Lines changed: 87 additions & 61 deletions

File tree

‎README.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,13 @@ The site of the [missing-elements](https://github.com/missing-elements) web comp
1010
| `/pdfjs-viewer/` | The docs of `<pdfjs-viewer-element>`, with a live preview | [src/pdfjs-viewer/](src/pdfjs-viewer/) |
1111
| `/h5p/build/` | The build page, for people: what it makes, a sample that plays, and the build of a chat's source into a `.h5p`, in the visitor's browser | [src/h5p/build/](src/h5p/build/) |
1212
| `/h5p/create-with-ai/` | The how-to, for people: installing the skill, asking a chat, the prompts to start from, the types, and what to do when something goes wrong | [src/h5p/create-with-ai/](src/h5p/create-with-ai/) |
13-
| `/h5p/skill/` | The skill as zips to install: `h5p-author.zip` for Claude's Skills and for Grok, attached to a message, `h5p-author-chatgpt.zip` for ChatGPT's Plugins; and a page that lists them and the bundles' addresses, each in full, which no page links to | [src/h5p/skill/](src/h5p/skill/); the zips written by [vite.config.ts](vite.config.ts) |
13+
| `/h5p/skill/` | The skill as zips to install: `h5p-author.zip` for a chat's place for skills, or attached to a message, and `h5p-author-chatgpt.zip`, the same skill laid out as a plugin; and a page that lists them and the bundles' addresses, each in full, which no page links to | [src/h5p/skill/](src/h5p/skill/); the zips written by [vite.config.ts](vite.config.ts) |
1414
| `/h5p/bundles/` | The skill's build tool and a library bundle per content type, for a chat that runs Node but cannot reach npm; and `h5p-author-build.tar.gz`, the tool and every library in one archive, for a person to attach to a chat whose code can download nothing | written by [vite.config.ts](vite.config.ts) |
1515
| `/h5p/build/types/` | The skill's type files, which the build page copies for the chat | written by [vite.config.ts](vite.config.ts) |
1616

17-
A chat takes the skill installed: from a zip in Claude and ChatGPT, attached to a message in Grok, which has no place to install a skill, or with `npx skills add` in an agent with a terminal, as `/h5p/create-with-ai/` says. Where the skill cannot reach npm, it builds from the tool and a bundle in `/h5p/bundles/`, at the addresses `/h5p/skill/` lists, if it can run Node and fetch a file: Grok did, on 2026-11-13. Where its code runs Node but can fetch nothing, as in ChatGPT, it builds from `h5p-author-build.tar.gz` once the person attaches it or keeps it in a ChatGPT Project (the owner's free account, 2026-11-14), and otherwise hands them the source for `/h5p/build/`, which builds in their browser. The tool is a Node.js program, so a chat whose code runs no Node, as most chat apps for local models, hands over the source; an agent with a terminal and a local model builds offline from the archive.
17+
The pages go by what a chat has, not by its name (the owner, 2026-11-20): what one chat does changes within weeks, so no page says what a product does or lacks, and the chats in their titles are examples. What was seen is kept here and in the pages' comments, with its date.
18+
19+
A chat takes the skill installed: from a zip where it has a place for skills or plugins (Claude's Skills and ChatGPT's Plugins, 2026-11-13), attached to a message where it has none (Grok, 2026-11-15), or with `npx skills add` in an agent with a terminal, as `/h5p/create-with-ai/` says. Where the skill cannot reach npm, it builds from the tool and a bundle in `/h5p/bundles/`, at the addresses `/h5p/skill/` lists, if it can run Node and fetch a file: Grok did, on 2026-11-13. Where its code runs Node but can fetch nothing, as ChatGPT's could not, it builds from `h5p-author-build.tar.gz` once the person attaches it or keeps it in a project of the chat's (a ChatGPT Project on the owner's free account, 2026-11-14), and otherwise hands them the source for `/h5p/build/`, which builds in their browser. The tool is a Node.js program, so a chat whose code runs no Node, as most chat apps for local models, hands over the source; an agent with a terminal and a local model builds offline from the archive.
1820

1921
Until 2026-11-13 the site's prompts sent a chat to read the skill at `/h5p/skill/` instead. That worked only in chats that now take the zip, so the prompts name the installed skill, and no page links to `/h5p/skill/`. Its page stays, for the skill's route 3 and the copies already installed, which take the bundles' addresses from it. The skill's text files were served there one by one too until h5p-author 0.10.0: the zips carry them, so the site serves them only as zips. A copy of 0.9.7 or older, in a chat that has its text alone, and a prompt copied before 2026-11-13 find no files there now.
2022

‎src/h5p/build/index.njk‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
9898
<li class="feature">
9999
<span class="feature-icon icon-ai" aria-hidden="true"></span>
100100
<h3>Works with your AI chat</h3>
101-
<p>Claude and ChatGPT take the h5p-author skill as a zip you upload once, and Grok reads Claude's zip attached to your message. An agent with a terminal, such as Claude Code, Codex or Cursor, installs it with one command.</p>
101+
<p>The h5p-author skill is a zip of text files. A chat with a place for skills takes it once, and any other reads it attached to your message. An agent with a terminal, such as Claude Code, Codex or Cursor, installs it with one command.</p>
102102
</li>
103103
<li class="feature">
104104
<span class="feature-icon icon-browser" aria-hidden="true"></span>
@@ -119,7 +119,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
119119
</div>
120120
</section>
121121

122-
{#- The prompt is a code block, which site.js gives a Copy button. It names the skill, which the
122+
{#- The steps say what a chat can do, and name none: what one chat does changes within weeks, and
123+
the guide goes by what the reader's chat has (create-with-ai/index.njk says why). The chats
124+
in the page's title and under the heading are examples of an AI chat.
125+
The prompt is a code block, which site.js gives a Copy button. It names the skill, which the
123126
chat has once the first step is done, and the content type, so the chat asks nothing (since
124127
2026-11-14 the skill asks for the type at most, and writes the author and licence the prompt
125128
gives, or defaults): the sample is what Haiku wrote for this request, with the site's name and
@@ -129,20 +132,20 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
129132
<div class="wrap">
130133
<header class="band-head">
131134
<h2 id="make-heading">How it works</h2>
132-
<p>Three steps, in Claude, ChatGPT or Grok.</p>
135+
<p>Three steps, in the AI chat you use: ChatGPT, Claude, Grok or another.</p>
133136
</header>
134137
<ol class="how" role="list">
135138
<li>
136139
<h3>Give your chat the skill</h3>
137-
<p>The h5p-author skill is the instructions that tell a chat how to write H5P. Download it and add it to your chat, once in Claude and ChatGPT and with your message in Grok: <a href="/h5p/create-with-ai/#install">where it goes in each</a>.</p>
140+
<p>The h5p-author skill is the instructions that tell a chat how to write H5P. Download it and give it to your chat, once where the chat keeps skills, or with your message where it keeps none: <a href="/h5p/create-with-ai/#install">where it goes</a>.</p>
138141
</li>
139142
<li>
140143
<h3>Ask your chat</h3>
141144
<p>Paste the prompt below into a new chat, with a subject of your own. It names the type, so the chat asks nothing and writes the activity.</p>
142145
</li>
143146
<li>
144147
<h3>Play it, then download it</h3>
145-
<p>Claude and Grok build the <code>.h5p</code> file in the chat, and so does ChatGPT with <a href="/h5p/create-with-ai/#install">the build archive</a>, kept in a Project or attached. Without it, ChatGPT hands over the activity's source, to <a href="#build-it">open or paste below</a>.</p>
148+
<p>A chat whose code can run the build tool builds the <code>.h5p</code> file in the chat, from <a href="/h5p/create-with-ai/#archive">the build archive</a> where it cannot download the tool. Any other chat hands over the activity's source, to <a href="#build-it">open or paste below</a>.</p>
146149
</li>
147150
</ol>
148151
<div class="prompt-box">

0 commit comments

Comments
 (0)