skillmds 1.3.6 → 1.3.8

package/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Changelog
 
-All notable changes to `skillmds` are documented here. Versions follow [semver](https://semver.org).
+All notable changes to `get-skill` (published as `skillmds` until 1.3.6) are documented here. Versions follow [semver](https://semver.org).
+
+## 1.3.8
+
+- **Skills install all their files.** `add`, `update` and the MCP install tool now fetch every registry skill's bundle, not only skills marked as packs. Some skills were recorded as single-file while carrying scripts or references, and installed only their SKILL.md. A single-file skill whose bundle can't be reached still installs from its SKILL.md, as before.
+
+## 1.3.7
+
+- **The package is now `get-skill`.** Install and run it as `npx get-skill add owner/name`, `npx get-skill search "pdf"`, and so on; MCP clients start the server with `npx -y get-skill`. `npm i -g get-skill` installs the `get-skill` and `skillmd` commands. Every release is still published as `skillmds` too, with identical contents, so existing setups keep working.
 
 ## 1.3.6
 

package/README.md

@@ -2,32 +2,32 @@
   <img src="https://skillmd.com/brand/banner.png" alt="SkillMD" width="560">
 </p>
 
-# skillmds
+# get-skill
 
-[![npm version](https://img.shields.io/npm/v/skillmds.svg)](https://www.npmjs.com/package/skillmds)
-[![license](https://img.shields.io/npm/l/skillmds.svg)](https://github.com/skillmds/skillmd/blob/main/LICENSE)
+[![npm version](https://img.shields.io/npm/v/get-skill.svg)](https://www.npmjs.com/package/get-skill)
+[![license](https://img.shields.io/npm/l/get-skill.svg)](https://github.com/skillmds/skillmd/blob/main/LICENSE)
 [![source](https://img.shields.io/badge/source-skillmds%2Fskillmd-blue?logo=github)](https://github.com/skillmds/skillmd)
 
 Tools for working with [Agent Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) (`SKILL.md`) from the [SkillMD](https://skillmd.com) registry. One package, two binaries:
 
 - **`skillmd`** — a CLI to lint, scan, search, install, and publish skills.
-- **`skillmds`** — an MCP server exposing the registry to MCP clients (Claude Code, Claude Desktop, Cursor, …).
+- **`get-skill`** — the same CLI, and an MCP server exposing the registry to MCP clients (Claude Code, Claude Desktop, Cursor, …).
 
 Both validate `SKILL.md` with the same engine ([`@skillmds/core`](https://www.npmjs.com/package/@skillmds/core)), so the CLI and the registry apply identical rules. Source lives at [github.com/skillmds/skillmd](https://github.com/skillmds/skillmd).
 
 ## Install
 
 ```bash
-npm i -g skillmds
+npm i -g get-skill
 ```
 
-This installs both the `skillmd` and `skillmds` commands. To run the CLI without installing:
+This installs both the `get-skill` and `skillmd` commands. To run the CLI without installing:
 
 ```bash
-npx skillmds lint .
+npx get-skill lint .
 ```
 
-**Which binary runs what.** `skillmds` with any argument runs the CLI. `skillmds` with no arguments starts the **MCP server** when stdin is piped (how an MCP client launches it), and opens the interactive CLI menu when there's a terminal attached. `skillmd` is always the CLI.
+**Which binary runs what.** `get-skill` with any argument runs the CLI. `get-skill` with no arguments starts the **MCP server** when stdin is piped (how an MCP client launches it), and opens the interactive CLI menu when there's a terminal attached. `skillmd` is always the CLI.
 
 ## CLI: `skillmd`
 
@@ -152,12 +152,12 @@ skillmd publish ./my-skill --dry-run
 skillmd publish ./my-skill --force   # publish despite warnings; never bypasses errors
 ```
 
-## MCP server: `skillmds`
+## MCP server: `get-skill`
 
 Claude Code:
 
 ```bash
-claude mcp add skillmd -- npx -y skillmds
+claude mcp add skillmd -- npx -y get-skill
 ```
 
 Other MCP clients:
@@ -165,7 +165,7 @@ Other MCP clients:
 ```jsonc
 {
   "mcpServers": {
-    "skillmd": { "command": "npx", "args": ["-y", "skillmds"] }
+    "skillmd": { "command": "npx", "args": ["-y", "get-skill"] }
   }
 }
 ```

package/bin/skillmd.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-// The `skillmd` CLI, shipped inside the `skillmds` package.
+// The `skillmd` CLI, shipped inside the `get-skill` package.
 import("../dist/cli.js");

package/dist/{chunk-HGVEADWS.js → chunk-MPBRLZWJ.js}

@@ -2,7 +2,7 @@
 import { existsSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
-var UNSUPPORTED = (what) => new Error(`${what} sources are not supported yet \u2014 clone it locally and run \`skillmd add ./path/to/skill\`.`);
+var UNSUPPORTED = (what) => new Error(`${what} sources are not supported yet \u2014 clone it locally and run \`npx get-skill add ./path/to/skill\`.`);
 function assertSubpath(sub) {
   if (!sub) return void 0;
   const clean = sub.replace(/^\/+|\/+$/g, "");
@@ -321,7 +321,7 @@ async function resolveSource(arg, opts = {}) {
     if (st.isFile()) return [loadLocal(spec.path)];
     const files = findSkillFiles(spec.path);
     if (files.length === 0) {
-      throw new Error(`No SKILL.md found under ${spec.path}. Point at a skill directory, e.g. "skillmd lint ./my-skill", or run "skillmd init" to create one.`);
+      throw new Error(`No SKILL.md found under ${spec.path}. Point at a skill directory, e.g. "npx get-skill lint ./my-skill", or run "npx get-skill init" to create one.`);
     }
     return files.map(loadLocal);
   }
@@ -337,7 +337,7 @@ async function resolveSource(arg, opts = {}) {
     return [{ path: spec.display, raw, slug: `gist-${spec.id.slice(0, 8)}` }];
   }
   if (spec.kind === "plugin") {
-    throw new Error(`"${spec.display}" is a plugin, not a single skill \u2014 install it with \`skillmd add ${spec.display}\`.`);
+    throw new Error(`"${spec.display}" is a plugin, not a single skill \u2014 install it with \`npx get-skill add ${spec.display}\`.`);
   }
   const gh = asGithub(spec);
   const { dir, cleanup } = await downloadGithub(gh, "skillmd-src-", opts, Boolean(gh.subpath));

package/dist/cli.js

@@ -31,7 +31,7 @@ import {
   uninstallSkill,
   upsertEntry,
   writeConfig
-} from "./chunk-HGVEADWS.js";
+} from "./chunk-MPBRLZWJ.js";
 
 // src/index.ts
 import { Command as Command13 } from "commander";
@@ -608,7 +608,7 @@ async function runInfo(slug, flags, deps = {}) {
   const commitSha = safeText(s.provenance?.commit_sha ?? s.commit_sha, 100);
   if (sourceRepo) lines.push(pc7.dim(`  source: ${sourceRepo}${commitSha ? ` @ ${commitSha.slice(0, 8)}` : ""}`));
   lines.push(pc7.dim(`  page: https://skillmd.com/skills/${slugTxt}`));
-  lines.push(pc7.dim(`  install: ${safeText(s.install?.cli, 300) || `npx skillmds add ${slugTxt}`}`));
+  lines.push(pc7.dim(`  install: ${safeText(s.install?.cli, 300) || `npx get-skill add ${slugTxt}`}`));
   return { ok: true, exitCode: 0, output: lines.join("\n"), skill: s };
 }
 function infoCommand() {
@@ -920,19 +920,20 @@ async function registryCandidate(owner, name, source, client) {
     type: skill.type,
     securityFlags: skill.security_flags
   };
+  const missing = [];
+  const bundle = await fetchBundle(client.base, registrySlug, client.token, { missing });
+  if (bundle && bundle.length) {
+    const sk = bundle.find((file) => file.path === "SKILL.md");
+    const note2 = bundleNote(bundle, missing);
+    return {
+      ...meta,
+      type: bundle.length > 1 ? "pack" : meta.type,
+      raw: sk ? sk.contents.toString("utf8") : skillMdFor(skill),
+      files: bundle,
+      ...note2 ? { note: note2 } : {}
+    };
+  }
   if (skill.type === "pack") {
-    const missing = [];
-    const bundle = await fetchBundle(client.base, registrySlug, client.token, { missing });
-    if (bundle && bundle.length) {
-      const sk = bundle.find((file) => file.path === "SKILL.md");
-      const note2 = bundleNote(bundle, missing);
-      return {
-        ...meta,
-        raw: sk ? sk.contents.toString("utf8") : skillMdFor(skill),
-        files: bundle,
-        ...note2 ? { note: note2 } : {}
-      };
-    }
     const pack = await resolvePackFiles(skill);
     if (pack) return { ...meta, ...pack };
   }
@@ -1421,7 +1422,7 @@ async function offerFindSkills(source, flags, run2, ui, deps) {
     project: !global,
     agent: run2.agents
   }, deps);
-  ui.message(r.exitCode === 0 ? `${pc8.green(GLYPH.ok)} find-skills added` : pc8.yellow(`${GLYPH.warn} find-skills could not be added. Try later: npx skillmds add ${FIND_SKILLS}`));
+  ui.message(r.exitCode === 0 ? `${pc8.green(GLYPH.ok)} find-skills added` : pc8.yellow(`${GLYPH.warn} find-skills could not be added. Try later: npx get-skill add ${FIND_SKILLS}`));
 }
 async function runAddWithUI(source, flags, opts = {}) {
   const term = opts.term ?? { ...realTerminal(), env: flags.env ?? process.env };
@@ -1456,7 +1457,7 @@ async function runAddWithUI(source, flags, opts = {}) {
     }
     ui.message(run2.output);
     await offerFindSkills(source, flags, run2, ui, base);
-    ui.outro(run2.exitCode === 0 ? `Done. Run ${pc8.cyan("skillmd list")} to see everything installed.` : pc8.red("Some skills were not installed."));
+    ui.outro(run2.exitCode === 0 ? `Done. Run ${pc8.cyan("npx get-skill list")} to see everything installed.` : pc8.red("Some skills were not installed."));
     return { run: run2, printed: true };
   } catch (e) {
     ui.outro(pc8.red("Nothing was installed."));
@@ -1489,7 +1490,7 @@ function runList(flags = {}) {
   if (flags.json) {
     return { items, output: JSON.stringify(items.map(({ name, scope, path, agents, source, mode, tracked, description }) => ({ name, scope, path, agents, source: source ?? null, mode, tracked, description })), null, 2) };
   }
-  if (items.length === 0) return { items, output: pc9.dim("No installed skills found. Install one with `skillmd add owner/name`.") };
+  if (items.length === 0) return { items, output: pc9.dim("No installed skills found. Install one with `npx get-skill add owner/name`.") };
   const w = Math.max(...items.map((i) => i.name.length), 4);
   const lines = items.map((i) => {
     const tag = i.tracked ? pc9.dim(i.source ?? "") : pc9.yellow("untracked");
@@ -1666,9 +1667,9 @@ function makeDefaultUpdateDeps(opts = {}) {
           if (e.status === 404) return null;
           throw e;
         }
+        const bundle = await fetchBundle(base, slug, token);
+        if (bundle?.length) return { files: bundle, commit_sha: skill.commit_sha ?? void 0 };
         if (skill.type === "pack") {
-          const bundle = await fetchBundle(base, slug, token);
-          if (bundle?.length) return { files: bundle, commit_sha: skill.commit_sha ?? void 0 };
           const pack = await resolvePackFiles(skill);
           if (pack) return { files: pack.files, commit_sha: skill.commit_sha ?? void 0 };
         }
@@ -1707,7 +1708,7 @@ async function runUpdate(names, flags, deps = defaultUpdateDeps) {
       const label2 = `${s.name}${scopes.length > 1 ? pc11.dim(` [${s.scope}]`) : ""}`;
       const entry = lock.skills[s.name];
       if (!entry) {
-        lines.push(pc11.dim(`- ${label2} untracked \u2014 reinstall with \`skillmd add\` to track updates`));
+        lines.push(pc11.dim(`- ${label2} untracked \u2014 reinstall with \`npx get-skill add\` to track updates`));
         continue;
       }
       if (entry.source.startsWith("local:")) {
@@ -1787,7 +1788,7 @@ var defaultDeps2 = {
   resolve: resolveSource,
   async submit(payload, flags) {
     const { api, hasToken } = createClient(flags);
-    if (!hasToken) throw new Error("No token. Run `skillmd login` or pass --token.");
+    if (!hasToken) throw new Error("No token. Run `npx get-skill login` or pass --token.");
     return api(`/api/skills`, {
       method: "POST",
       headers: { "content-type": "application/json" },
@@ -2113,18 +2114,18 @@ try {
   version = JSON.parse(readFileSync3(new URL("../package.json", import.meta.url), "utf8")).version;
 } catch {
 }
-var program = new Command13("skillmd").version(version).description("Lint, validate, and install Agent Skills from the SkillMD registry.").option("--json", "machine-readable output").option("--token <token>", "personal access token (prefer `skillmd login` or SKILLMD_TOKEN \u2014 command-line tokens show up in process lists)").option("--api <url>", "override the registry API base URL").option("--insecure-http", "allow an http:// --api base (local development only)");
+var program = new Command13("get-skill").version(version).description("Lint, validate, and install Agent Skills from the SkillMD registry.").option("--json", "machine-readable output").option("--token <token>", "personal access token (prefer `npx get-skill login` or SKILLMD_TOKEN \u2014 command-line tokens show up in process lists)").option("--api <url>", "override the registry API base URL").option("--insecure-http", "allow an http:// --api base (local development only)");
 program.configureHelp({ sortSubcommands: false });
 program.addHelpText("after", `
 Examples:
-  $ skillmd add anthropic/pdf                  install from the registry (asks project vs global)
-  $ skillmd add owner/repo/skills/x#main -g    a GitHub subfolder at a ref, into your user dirs
-  $ skillmd add ./my-skill -a claude-code -p   a local skill into this project for one agent
-  $ skillmd add anthropic/pdf -y --json        non-interactive, machine-readable
-  $ skillmd list                               everything installed, project and global
-  $ skillmd check                              which installed skills have updates
-  $ skillmd update -g                          update your user-level skills
-  $ skillmd remove pdf                         remove a skill from every agent
+  $ npx get-skill add anthropic/pdf                  install from the registry (asks project vs global)
+  $ npx get-skill add owner/repo/skills/x#main -g    a GitHub subfolder at a ref, into your user dirs
+  $ npx get-skill add ./my-skill -a claude-code -p   a local skill into this project for one agent
+  $ npx get-skill add anthropic/pdf -y --json        non-interactive, machine-readable
+  $ npx get-skill list                               everything installed, project and global
+  $ npx get-skill check                              which installed skills have updates
+  $ npx get-skill update -g                          update your user-level skills
+  $ npx get-skill remove pdf                         remove a skill from every agent
 
 Quality:   lint  scan  rules  init
 Registry:  search  info  add  list  remove  update  check
@@ -2134,7 +2135,7 @@ Docs: https://skillmd.com/docs/cli`);
 program.hook("preAction", (thisCmd) => {
   const opts = thisCmd.opts();
   if (opts.token && process.stderr.isTTY) {
-    console.error(pc15.yellow("\u26A0 --token is visible in your shell history and process list; prefer `skillmd login` or SKILLMD_TOKEN."));
+    console.error(pc15.yellow("\u26A0 --token is visible in your shell history and process list; prefer `npx get-skill login` or SKILLMD_TOKEN."));
   }
 });
 program.addCommand(lintCommand());

package/dist/mcp.js

@@ -13,7 +13,7 @@ import {
   safeText,
   stripTerminalEscapes,
   telemetryDisabled
-} from "./chunk-HGVEADWS.js";
+} from "./chunk-MPBRLZWJ.js";
 
 // src/mcp/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -205,24 +205,23 @@ async function installFromRegistry(args, ctx, deps = {}) {
   if (bad) return bad;
   let files = [{ path: "SKILL.md", contents: raw }];
   let note = "";
-  if (skill.type === "pack") {
-    try {
-      const missing = [];
-      const bundle = await getBundle(ctx.base, `${owner}/${name}`, ctx.token, { missing });
-      if (bundle?.length) {
-        files = bundle.some((f) => f.path === "SKILL.md") ? bundle : [...bundle, { path: "SKILL.md", contents: raw }];
-        if (missing.length) note = missingFilesNote(missing);
-      } else {
-        const pack = await getPackFiles(skill);
-        if (pack) {
-          files = pack.files;
-          if (pack.pinMiss) note = "pinned commit unavailable upstream \u2014 fetched the source repo's default branch instead";
-        } else note = "pack assets could not be fetched \u2014 only SKILL.md was written";
-      }
-    } catch (e) {
-      if (e instanceof IntegrityError) return notice(`Refused: ${owner}/${name} failed integrity verification \u2014 ${e.message}. Not installed.`);
-      note = `pack assets could not be fetched (${e instanceof Error ? e.message : String(e)}) \u2014 only SKILL.md was written`;
+  const pack = skill.type === "pack";
+  try {
+    const missing = [];
+    const bundle = await getBundle(ctx.base, `${owner}/${name}`, ctx.token, { missing });
+    if (bundle?.length) {
+      files = bundle.some((f) => f.path === "SKILL.md") ? bundle : [...bundle, { path: "SKILL.md", contents: raw }];
+      if (missing.length) note = missingFilesNote(missing);
+    } else if (pack) {
+      const fromGitHub = await getPackFiles(skill);
+      if (fromGitHub) {
+        files = fromGitHub.files;
+        if (fromGitHub.pinMiss) note = "pinned commit unavailable upstream \u2014 fetched the source repo's default branch instead";
+      } else note = "pack assets could not be fetched \u2014 only SKILL.md was written";
     }
+  } catch (e) {
+    if (e instanceof IntegrityError) return notice(`Refused: ${owner}/${name} failed integrity verification \u2014 ${e.message}. Not installed.`);
+    if (pack) note = `pack assets could not be fetched (${e instanceof Error ? e.message : String(e)}) \u2014 only SKILL.md was written`;
   }
   const written = skillMdOf(files);
   if (written === null) files = [...files, { path: "SKILL.md", contents: raw }];

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "skillmds",
-  "version": "1.3.6",
-  "description": "SkillMD for agents: the `skillmds` MCP server + the `skillmd` CLI (lint, scan, search, install, publish Agent Skills) from skillmd.com.",
+  "version": "1.3.8",
+  "description": "Find, install, lint and publish Agent Skills (SKILL.md) from skillmd.com: the get-skill CLI and MCP server.",
   "license": "MIT",
   "author": "SkillMD",
   "type": "module",
   "mcpName": "com.skillmd/skillmd",
   "bin": {
-    "skillmds": "bin/skillmd-mcp.mjs",
-    "skillmd": "bin/skillmd.mjs"
+    "get-skill": "bin/skillmd-mcp.mjs",
+    "skillmd": "bin/skillmd.mjs",
+    "skillmds": "bin/skillmd-mcp.mjs"
   },
   "files": [
     "bin",
@@ -21,6 +22,7 @@
     "node": ">=18"
   },
   "keywords": [
+    "get-skill",
     "mcp",
     "model-context-protocol",
     "cli",