skills 1.7.3 → 1.7.4

package/README.md

@@ -46,7 +46,7 @@ private repositories, and all options.
 | `npx skills find [query]`         | Search for skills                |
 | `npx skills list`                 | List installed skills            |
 | `npx skills use <source>@<skill>` | Use one skill without installing |
-| `npx skills sync`                 | Sync skills from npm dependencies |
+| `npx skills experimental_sync`    | Sync skills from npm dependencies (experimental) |
 | `npx skills check`                | Check for available updates      |
 | `npx skills update [skills...]`   | Update installed skills          |
 | `npx skills remove [skills...]`   | Remove installed skills          |
@@ -64,18 +64,19 @@ npx skills use vercel-labs/agent-skills@web-design-guidelines --agent claude-cod
 
 Omit `--agent` to print the prompt instead. See [`skills use`](docs/commands.md#skills-use).
 
-## Sync Skills from npm Packages
+## Sync Skills from npm Packages (Experimental)
 
 Some npm packages bundle instructions for your agent alongside their code:
 
 ```bash
 npm install -D skills agent-browser
-npx skills sync -y
+npx skills experimental_sync -y
 ```
 
 Sync links packaged skills into your project so they update with
 the dependency. It also supports skill packs declared in `package.json`.
-See [npm skills and automatic setup](docs/commands.md#skills-sync).
+This feature is experimental; its options and behavior may change as we iterate.
+See [npm skills and automatic setup](docs/commands.md#skills-experimental_sync).
 
 ## Supported Agents
 

package/dist/cli.mjs

@@ -4182,7 +4182,7 @@ async function tryBlobInstall(ownerRepo, options = {}) {
 		tree
 	};
 }
-var version$1 = "1.7.3";
+var version$1 = "1.7.4";
 const NOTION_API_VERSION = "2026-03-11";
 const NTN_TIMEOUT_MS = 3e4;
 const NTN_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
@@ -6682,7 +6682,7 @@ async function runSync(args, options = {}) {
 		}
 	}
 	console.log();
-	if (!agentResult.isAgent) intro(import_picocolors.default.bgCyan(import_picocolors.default.black(" skills sync ")));
+	if (!agentResult.isAgent) intro(import_picocolors.default.bgCyan(import_picocolors.default.black(" skills experimental_sync ")));
 	if (agentResult.isAgent) log.info(import_picocolors.default.bgCyan(import_picocolors.default.black(import_picocolors.default.bold(` ${agentResult.agent.name} `))) + " Agent detected — installing non-interactively");
 	const spinner$2 = spinner();
 	spinner$2.start("Scanning node_modules for skills…");
@@ -8652,7 +8652,7 @@ function showBanner() {
 	console.log();
 	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills experimental_install${RESET} ${DIM}Restore from skills-lock.json${RESET}`);
 	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills init ${DIM}[name]${RESET}          ${DIM}Create a new skill${RESET}`);
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills sync${RESET}                 ${DIM}Sync skills from node_modules${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills experimental_sync${RESET}    ${DIM}Sync skills from node_modules${RESET}`);
 	console.log();
 	console.log(`${DIM}try:${RESET} npx skills add vercel-labs/agent-skills`);
 	console.log();
@@ -8683,8 +8683,8 @@ function showHelp() {
 		["skills update -g", "update global skills only"],
 		["skills experimental_install", "restore from skills-lock.json"],
 		["skills init my-skill"],
-		["skills sync", "sync from node_modules"],
-		["skills sync -y", "sync without prompts"]
+		["skills experimental_sync", "sync from node_modules (experimental)"],
+		["skills experimental_sync -y", "sync without prompts"]
 	];
 	const exampleWidth = Math.max(...examples.filter(([, description]) => description).map(([command]) => command.length));
 	const formattedExamples = examples.map(([command, description]) => {
@@ -8720,7 +8720,7 @@ ${BOLD}Update Options:${RESET}
 ${BOLD}Project:${RESET}
   experimental_install Restore skills from skills-lock.json
   init [name]          Initialize a skill (creates <name>/SKILL.md or ./SKILL.md)
-  sync                 Sync skills from node_modules into agent directories (alias: experimental_sync)
+  experimental_sync    Sync skills from node_modules into agent directories (alias: sync)
 
 ${BOLD}Add Options:${RESET}
   -g, --global           Install skill globally (user-level) instead of project-level
@@ -8747,7 +8747,7 @@ ${BOLD}Remove Options:${RESET}
   -y, --yes              Skip confirmation prompts
   --all                  Remove every installed skill (-y implied). Do not combine with named skills.
   
-${BOLD}Sync Options:${RESET}
+${BOLD}Experimental Sync Options:${RESET}
   -a, --agent <agents>   Specify agents to install to (use '*' for all agents)
   -y, --yes              Skip confirmation prompts
   --copy                 Copy skills instead of linking them to node_modules

package/docs/commands.md

@@ -252,16 +252,22 @@ npx skills rm my-skill
 | `-y, --yes`    | Skip confirmation prompts                        |
 | `--all`        | Shorthand for `--skill '*' --agent '*' -y`       |
 
-## `skills sync`
+## Experimental commands
+
+These commands are still experimental. Their names, options, and behavior may change.
+
+<a id="skills-sync"></a>
+
+### `skills experimental_sync`
 
-Sync skills from npm packages and `package.json` declarations. `experimental_sync`
-remains supported as an alias.
+Sync skills from npm packages and `package.json` declarations. `sync` remains
+supported as a compatibility alias for users of skills@1.7.3.
 
 Install a package that ships skills, then sync them into your project:
 
 ```bash
 npm install -D skills agent-browser
-npx skills sync -y
+npx skills experimental_sync -y
 ```
 
 Sync reads installed dependencies declared in your project's `package.json`, including
@@ -275,7 +281,7 @@ The `.agents/skills/` directory is the shared location. Selecting Claude Code al
 creates links under `.claude/skills/` pointing to the shared skills:
 
 ```bash
-npx skills sync -a claude-code -y
+npx skills experimental_sync -a claude-code -y
 ```
 
 Outside an agent, sync detects installed agents. When run inside a coding agent,
@@ -289,7 +295,7 @@ To run sync after dependency installation, add a `prepare` script:
 ```json
 {
   "scripts": {
-    "prepare": "skills sync -y"
+    "prepare": "skills experimental_sync -y"
   }
 }
 ```
@@ -327,10 +333,6 @@ The include/exclude filters apply to both packaged and remote skills. For remote
 skills, the package pattern matches the package declaring the entry (`.` for the
 project's own field). Eve always receives copies because it rewrites skill frontmatter.
 
-## Experimental commands
-
-These commands are still experimental. Their names, options, and behavior may change.
-
 ### Restore skills from the project lock file
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills",
-  "version": "1.7.3",
+  "version": "1.7.4",
   "description": "The open agent skills ecosystem",
   "type": "module",
   "bin": {