Skip to content

Commit e5038bd

Browse files
authored
Merge pull request #81 from missing-elements/docs/guide-by-capability
The guide goes by what a chat has, not by its name
2 parents 19dc77d + 62966e9 commit e5038bd

4 files changed

Lines changed: 100 additions & 64 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`, installed once in a chat's place for skills, or attached to the message in each new chat where it has none, 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 with a place for skills or plugins installs the skill from a zip, once (Claude's Skills and ChatGPT's Plugins, 2026-11-13). A chat with neither reads it from the zip attached to the message, in each new chat (Grok, 2026-11-15). An agent with a terminal takes it with `npx skills add`. `/h5p/create-with-ai/` says each. 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 (ChatGPT's, 2026-11-13), 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, one that runs commands on your computer, 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)