skill-port 0.1.2 → 0.1.3

package/README.md

@@ -1,5 +1,11 @@
 # skill-port
 
+[![npm version](https://img.shields.io/npm/v/skill-port?logo=npm)](https://www.npmjs.com/package/skill-port)
+[![npm downloads](https://img.shields.io/npm/dm/skill-port)](https://www.npmjs.com/package/skill-port)
+[![CI](https://img.shields.io/github/actions/workflow/status/lu-zhengda/skill-port/ci.yml?branch=main&label=ci)](https://github.com/lu-zhengda/skill-port/actions/workflows/ci.yml)
+[![Publish](https://img.shields.io/github/actions/workflow/status/lu-zhengda/skill-port/publish.yml?label=publish)](https://github.com/lu-zhengda/skill-port/actions/workflows/publish.yml)
+[![License](https://img.shields.io/github/license/lu-zhengda/skill-port)](./LICENSE)
+
 `skill-port` converts AI coding skill packages between:
 
 - `codex`
@@ -13,18 +19,28 @@ The CLI is intentionally simple:
 
 ## Install
 
+From npmjs:
+
 ```bash
-npm install
-npm run build
-npm link
+npx skill-port --help
 ```
 
-Then run:
+Global install:
 
 ```bash
+npm install -g skill-port
 skill-port --help
 ```
 
+Project-local install (if you do not want global install):
+
+```bash
+npm i skill-port
+npx skill-port --help
+```
+
+Note: `npm i skill-port` is a valid local install. To run the CLI from a local install, use `npx skill-port` (or `npm exec skill-port`).
+
 ## Commands
 
 ### list

package/dist/{chunk-UGQBG2TQ.js → chunk-OZ2PBTWL.js}

@@ -817,7 +817,14 @@ async function convertSkill(options) {
   let wroteFiles = false;
   if (!options.dryRun) {
     if (path7.resolve(outputDir) === path7.resolve(inputDir)) {
-      throw new Error("Output directory cannot be the same as input directory.");
+      if (sourceProvider === targetProvider) {
+        throw new Error(
+          `Detected source provider '${sourceProvider}' and target provider '${targetProvider}' for the same skill path (${outputDir}). This is a no-op conversion to the same provider. Choose a different --to provider, or set --target-scope/--out to write elsewhere.`
+        );
+      }
+      throw new Error(
+        `Output directory resolves to the input directory (${outputDir}). Set --out (or --target-scope in scoped mode) to a different path.`
+      );
     }
     await ensureOutputDirectory(outputDir, Boolean(options.overwrite));
     await copySkillDirectory(inputDir, outputDir);

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   formatTextReport,
   listSkillsByScope,
   validateSkillName
-} from "./chunk-UGQBG2TQ.js";
+} from "./chunk-OZ2PBTWL.js";
 
 // src/cli.ts
 import path from "path";

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   formatSkillsText,
   formatTextReport,
   listSkillsByScope
-} from "./chunk-UGQBG2TQ.js";
+} from "./chunk-OZ2PBTWL.js";
 export {
   StrictModeError,
   convertScopedSkill,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-port",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Convert AI coding skills across OpenAI/Codex, Claude Code, and Cursor Skills formats.",
   "license": "MIT",
   "type": "module",