unoverse 0.1.196 → 0.1.198

package/lib/skills.mjs

@@ -36,11 +36,63 @@ export function skillFilesFromLlms(text, origin = DOCS) {
   return out;
 }
 
+/**
+ * A served page, back into the file the skill was authored as.
+ *
+ * The site does not serve a page's markdown verbatim (observed 2026-09-05): it prepends a
+ * "Documentation Index" quote block, renders the frontmatter `description` as a lead
+ * quote, and injects an H1 from the filename ("# SKILL", "# Node"). Claude Code needs
+ * SKILL.md to open with `name:` and `description:` frontmatter, and a reference to be its
+ * own body. So: drop the index block, drop the injected title (it equals the filename
+ * stem), lift the lead quote, and for SKILL.md write the frontmatter back. Pure.
+ */
+export function pageToSkillFile(rel, text) {
+  const lines = text.split("\n");
+  let i = 0;
+  // 1. the site's index block: leading quoted lines, then a blank
+  if (/^> ## Documentation Index/.test(lines[0] ?? "")) {
+    while (i < lines.length && lines[i].startsWith(">")) i++;
+    while (i < lines.length && lines[i].trim() === "") i++;
+  }
+  // 2. the frontmatter description, rendered as a lead quote
+  let description = "";
+  if ((lines[i] ?? "").startsWith("> ")) {
+    const quote = [];
+    while (i < lines.length && lines[i].startsWith("> ")) quote.push(lines[i++].slice(2));
+    description = quote.join(" ").trim();
+    while (i < lines.length && lines[i].trim() === "") i++;
+  }
+  // 3. the injected title, which is the filename stem
+  const stem = basename(rel).replace(/\.md$/, "");
+  if ((lines[i] ?? "").trim().toLowerCase() === `# ${stem}`.toLowerCase()) {
+    i++;
+    while (i < lines.length && lines[i].trim() === "") i++;
+  }
+  const body = lines.slice(i).join("\n").replace(/\s+$/, "") + "\n";
+  return { description, body };
+}
+
+/** The file to write for one skill page: SKILL.md gets its frontmatter back. */
+export function skillFileText(skill, rel, text) {
+  const { description, body } = pageToSkillFile(rel, text);
+  if (basename(rel) !== "SKILL.md") return body;
+  const desc = JSON.stringify(description || `The ${skill} skill.`);
+  return `---\nname: ${skill}\ndescription: ${desc}\n---\n\n${body}`;
+}
+
+/**
+ * The site sits behind a CDN that serves llms.txt and pages from cache for a while after
+ * a release (observed 2026-09-05: ninety minutes, and the new skill pages absent from the
+ * listing throughout). An installer that read the cache would install last release's
+ * skills right after this one. A fresh query string is a fresh cache key.
+ */
+const fresh = (url) => `${url}?t=${Date.now()}`;
+
 export async function installSkills() {
   const target = join(homedir(), ".claude", "skills");
   let files;
   try {
-    const res = await fetch(`${DOCS}/llms.txt`);
+    const res = await fetch(fresh(`${DOCS}/llms.txt`));
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
     files = skillFilesFromLlms(await res.text());
   } catch {
@@ -57,11 +109,11 @@ export async function installSkills() {
   const tmp = mkdtempSync(join(tmpdir(), "unoverse-skills-"));
   try {
     for (const f of files) {
-      const res = await fetch(f.url);
+      const res = await fetch(fresh(f.url));
       if (!res.ok) throw new Error(`${f.url}: HTTP ${res.status}`);
       const p = join(tmp, f.skill, f.rel);
       mkdirSync(dirname(p), { recursive: true });
-      writeFileSync(p, await res.text());
+      writeFileSync(p, skillFileText(f.skill, f.rel, await res.text()));
     }
     mkdirSync(target, { recursive: true });
     // REPLACED WHOLE, ours only. Each skill folder the site carries is removed and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unoverse",
-  "version": "0.1.196",
+  "version": "0.1.198",
   "description": "The Unoverse front door — create a Studio project, a universe, or a client app, and launch Studio.",
   "license": "SEE LICENSE IN README.md",
   "type": "module",
@@ -27,6 +27,7 @@
     "url": "git+https://github.com/unoverse-platform/unoverse.git"
   },
   "scripts": {
+    "test": "node --test tests/",
     "prepack": "node scripts/vendor-operator.mjs && node scripts/vendor-base.mjs"
   }
 }