feat(author): the skill no longer sends a chat with its text alone to the skill's page

Merged
AL
1d ago
+45-28

Closes #196.

What changes

  • SKILL.md: the two "with this text alone" passages are removed. One was in the opening and sent a chat to /h5p/skill/ first. The other was in step 2 and sent it there for a type's file. Step 3 still takes the build tool's and the bundles' addresses from that page, which the site keeps serving.
  • design/author.md: the rule A chat with the skill's text alone takes every address from the skill's page becomes The skill is installed, and its page lists what step 3 fetches. Its history stays, and it records why the passages went and what was measured.
  • design/author.md: Where npx cannot install, a page builds records that ChatGPT's own download tool saved nothing on the owner's account. A bundle per content type says that Grok's sandbox fetched a bundle and ChatGPT's did not.
  • README.md and packages/author/README.md: they point to the install step at missing-elements.github.io/h5p/create-with-ai/#install instead of offering the skill as a link.

Measured on Haiku

Without the skill installed. The user's message gave the skill page's address, as the site's old prompt did. The web tool opened only addresses seen whole, and npm was cut off. Three runs per text:

0.9.7 textThis text
Opened the page, the brief and the type files3 of 33 of 3
Fetched the tool and the bundle, and built3 of 33 of 3
Package plays in the verifier3 of 33 of 3
Link decodes to the source file exactly2 of 2 with a file3 of 3

The passages cost nothing here: the page itself says to read SKILL.md first, and it lists every address.

  • One 0.9.7 run left its files in a folder of its own and told the user they were in out/.
  • One run of this text also offered npx @missing-elements/h5p-verify@latest … --preview as an optional check "on a computer with npm".

With the skill installed, npm cut off and no web tool, this text only, 2 runs: both handed over the build page's link and the source file. One run dropped two characters of the link while writing its reply, the way ChatGPT does. That is the first time on Haiku, and the source file still builds, which is what 0.9.7 added it for.

Checked

  • pnpm --filter @missing-elements/h5p-author test:unit: 183 tests pass.
  • typecheck passes.
  • sync:skill changes nothing.

It reaches users with the next author release and the site's pin bump after it.


Summary by cubic

The h5p-author skill no longer tells a chat that has only its text to open /h5p/skill/ first for addresses. SKILL.md drops both "with this text alone" passages, and step 3 still fetches the build tool and bundles from that page, which stays for installed copies.

  • design/author.md renames the rule and records measurements: Grok fetched the bundle from the page, while ChatGPT's download tool saved none of eleven files, so the page stays the route there.
  • README.md and packages/author/README.md now point to the install step at create-with-ai/#install instead of offering the skill as a link.