Skip to content

Commit 3df9e6e

Browse files
committed
Create with AI: the first step is giving the chat the skill, which Grok takes with each message
The step was headed "Install the skill, once", which Grok cannot do (cubic's review on #63). The guide's heading, its opening and the build page's step now say Claude and ChatGPT keep the skill once installed, and Grok takes the zip with the message in each new chat. The step keeps its id, install, which other pages link to. Refs #62
1 parent 9e60eab commit 3df9e6e

3 files changed

Lines changed: 15 additions & 13 deletions

File tree

‎src/_includes/site-foot.njk‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@
3434
<h2>Guides</h2>
3535
<ul role="list">
3636
<li><a href="/h5p/create-with-ai/">Create H5P content with AI</a></li>
37-
<li><a href="/h5p/create-with-ai/#install">Install the h5p-author skill</a></li>
37+
<li><a href="/h5p/create-with-ai/#install">Give your chat the h5p-author skill</a></li>
3838
</ul>
3939
</div>
4040
<div>

‎src/h5p/build/index.njk‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -132,8 +132,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' da
132132
</header>
133133
<ol class="how" role="list">
134134
<li>
135-
<h3>Install the skill, once</h3>
136-
<p>The h5p-author skill is the instructions that tell a chat how to write H5P. Download it and add it to your chat: <a href="/h5p/create-with-ai/#install">where it goes in Claude, ChatGPT and Grok</a>.</p>
135+
<h3>Give your chat the skill</h3>
136+
<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>
137137
</li>
138138
<li>
139139
<h3>Ask your chat</h3>

‎src/h5p/create-with-ai/index.njk‎

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ socialImage:
1212
alt: "The build page: its headline, Build an H5P activity with AI, and a course presentation playing beside it."
1313
# The top bar's links to the page's own sections (topbar.njk).
1414
topbarLinks:
15-
- { href: "#install", text: "Install" }
15+
- { href: "#install", text: "The skill" }
1616
- { href: "#prompts", text: "Prompts" }
1717
- { href: "#types", text: "Types" }
1818
- { href: "#open-source", text: "Open source" }
@@ -34,11 +34,12 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
3434
<p class="lead">
3535
An AI chat can write a whole H5P activity, not only its questions: a quiz, flash cards, a
3636
course presentation or any of <a href="#types">{{ skill.offered.length }} H5P types</a>. Here
37-
is how, from installing the skill to the <code>.h5p</code> file in your Moodle.
37+
is how, from giving your chat the skill to the <code>.h5p</code> file in your Moodle.
3838
</p>
3939
<p>
4040
The chat needs the h5p-author skill, the instructions that tell it how to write H5P: you
41-
<a href="#install">install it once</a>. Then the chat writes the activity. Claude and Grok
41+
<a href="#install">give it to your chat</a>, once in Claude and ChatGPT, and with your
42+
message in Grok. Then the chat writes the activity. Claude and Grok
4243
make it a <code>.h5p</code> file for Moodle or any other H5P site in the chat, and for
4344
ChatGPT <a href="/h5p/build/">the build page</a> makes the file in your browser. The skill
4445
and the page are free and <a href="#open-source">open source</a>, with no account.
@@ -53,9 +54,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
5354
kept in a ChatGPT Project built there on the owner's free account on 2026-11-14 (#49). Its
5455
heading keeps the id that the top bar and the skill's page link to. -#}
5556
<section class="step" aria-labelledby="install">
56-
<h2 id="install"><span class="step-marker"><span class="step-number">1</span></span> Install the skill, once</h2>
57+
<h2 id="install"><span class="step-marker"><span class="step-number">1</span></span> Give your chat the skill</h2>
5758
<p>
58-
In Claude and ChatGPT the skill then stays, for every activity you ask for. Where it goes
59+
Claude and ChatGPT install it once and keep it, for every activity you ask for. Grok has
60+
nothing to install it into, and takes it with your message, in each new chat. Where it goes
5961
depends on the chat:
6062
</p>
6163
<ul>
@@ -75,10 +77,10 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
7577
hands over the activity's source, to paste or open on the build page.
7678
</li>
7779
<li>
78-
<strong>Grok</strong> has no place to install a skill: download
80+
<strong>Grok</strong>: download
7981
<a href="/h5p/skill/h5p-author.zip" download>h5p-author.zip</a>, the same file as for
80-
Claude, and attach it to the message where you ask, in each new chat. Grok builds the <code>.h5p</code> file in
81-
the chat.
82+
Claude, and attach it to the message where you ask, in each new chat. Grok builds the
83+
<code>.h5p</code> file in the chat.
8284
</li>
8385
<li>
8486
<strong>An agent with a terminal</strong>, such as Claude Code, Codex or Cursor:
@@ -278,8 +280,8 @@ csp: "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self'; o
278280
<h3>The chat doesn't use the skill</h3>
279281
<p>
280282
Name it in your message, as the prompts here do: "Use the h5p-author skill to…". If the chat
281-
knows no such skill, check that it is still installed where <a href="#install">step 1</a> put
282-
it, and ask in a new chat.
283+
knows no such skill, check that it is still where <a href="#install">step 1</a> put it, or
284+
attached to your message in Grok, and ask in a new chat.
283285
</p>
284286

285287
<h3>The chat says it cannot get the build tool</h3>

0 commit comments

Comments
 (0)