fix(author): the skill sends a chat with its text alone to the page of full addresses

Merged
AL
17h ago
+38-13

Closes #180.

A chat given a link to the h5p-author skill has its text and none of its files, and SKILL.md gave it addresses to put together: the brief as a relative link, a type's file as https://missing-elements.github.io/h5p/build/types/<Type>.md, a bundle as https://missing-elements.github.io/h5p/bundles/<type>.zip. A chat's fetch tool may open only addresses it has seen whole; an outside review of the skill had …/bundles/H5P.Blanks.zip refused so. https://missing-elements.github.io/h5p/skill/ writes out the skill's files whole for this, but SKILL.md never named it, and it listed no bundle.

What changes

  • SKILL.md sends a chat that has its text alone to the page first, to take every address from it (a paragraph after the intro); steps 2 and 3 take a type's file, the build tool and the bundle at the addresses it lists. The patterns stay in step 3, for a chat whose tool takes them.
  • The page lists the build tool and every bundle in missing-elements/missing-elements.github.io#18, which works with 0.9.0 and can merge first.
  • README.md says the page lists what the build fetches; design/author.md says why, and what was measured.

Tested

On Haiku, in a stand-in for such a chat: a fetch tool that opens a page or file only at an address that has appeared whole in the conversation, the site as #18 builds it, npm cut off; asked for a three-question Question Set.

0.9.0's textthis text
opened the brief and the type files0 of 26 of 6, nothing refused
reached the build tool and the bundlethe tool only6 of 6
built in the chat0 of 2: a build page link2 of the 3 given the tool as served built from the bundle at once, and both pass h5p-verify; the third reached npm, which the stand-in failed to cut off in a subfolder, and built with that

Without the brief, both 0.9.0 runs chose an author and a licence the user had not given, which the brief says never to do. The first three runs of this text had the build tool swapped for a stand-in that logged its runs, and each refused to run it, the test's fault, so the three reruns got the file as served.

No code changed. The package's tests copy SKILL.md as it is, and none reads its text.

To release

h5p-author 0.9.1, a patch for the skill's text. Then the site's pin moves to it, which serves the new SKILL.md at /h5p/skill/SKILL.md (#18 lets its test take either release). Installed copies: npx skills update -g, and a new upload to the Claude app.


Summary by cubic

Fixes #180: a chat that has the h5p-author skill's text alone is now sent to the page of full addresses first, so its fetch tool sees every file address whole instead of assembled names, which got the bundle refused. No code changed.

Bug Fixes

  • SKILL.md tells such a chat to open https://missing-elements.github.io/h5p/skill/ first and take every address from it, including the build tool and the bundle.
  • The patterns stay in step 3 for chats whose fetch tools take them.
  • In a stand-in chat with npm cut off, the old text got the brief, the type file, and the bundle refused in both runs; the new text opened all of them in all six runs and built from the bundle.
  • README.md and design/author.md now describe the page and what was measured.