llmist 18.0.0 → 18.1.0

package/dist/index.js

@@ -4133,15 +4133,30 @@ function createLoadSkillGadget(registry) {
   const summaries = registry.getMetadataSummaries();
   const skillNames = registry.getModelInvocable().map((s) => s.name);
   const description = [
-    "Load one or more skill bodies into context. Pass an array even for a",
-    'single skill: `{skills: ["some-skill"]}`. **This gadget is an iteration',
-    "barrier \u2014 no other gadgets in the same tool batch will execute, so load",
-    "every skill you know you'll need in one shot.** The loaded bodies are",
-    "sticky and survive context compaction.",
+    "Load one or more skill bodies into context. Pass `skills` as a JSON",
+    "array of skill-name strings \u2014 NOT a string of a JSON-encoded array.",
+    'Right: `{"skills": ["alpha"]}` or `{"skills": ["alpha", "beta"]}`.',
+    'Wrong: `{"skills": "[\\"alpha\\"]"}` (the value is a string, not an array).',
+    "**This gadget is an iteration barrier \u2014 no other gadgets in the same",
+    "tool batch will execute, so load every skill you know you'll need in",
+    "one shot.** The loaded bodies are sticky and survive context compaction.",
     "",
     "Available skills:",
     summaries
   ].join("\n");
+  const examples = [];
+  if (skillNames.length >= 1) {
+    examples.push({
+      params: { skills: [skillNames[0]] },
+      comment: "Single-skill call \u2014 `skills` is still an array of length 1."
+    });
+  }
+  if (skillNames.length >= 2) {
+    examples.push({
+      params: { skills: [skillNames[0], skillNames[1]] },
+      comment: "Multi-skill call \u2014 load several skills in one shot to avoid round-trips."
+    });
+  }
   return createGadget({
     name: LOAD_SKILL_GADGET_NAME,
     description,
@@ -4155,6 +4170,7 @@ function createLoadSkillGadget(registry) {
     }),
     stickyResult: true,
     iterationBarrier: true,
+    examples,
     execute: async ({ skills: skillNamesArg, arguments: args }) => {
       const sections = [];
       for (const skillName of skillNamesArg) {