remote-skills 0.0.2 → 0.0.3

package/README.md

@@ -5,14 +5,18 @@
 ## Quick start
 
 ```bash
+# Install remote-skills
+npx remote-skills install
+
 # Show current collection list
-npx remote-skills show collections
+npx remote-skills config show collections
 
+# (Optional)
 # Replace the entire collection list
-npx remote-skills set collection collection-1 collection-2
+npx remote-skills config set collection collection-1 collection-2
 
 # Add one collection
-npx remote-skills add collection collection-3
+npx remote-skills config add collection collection-3
 ```
 
 ## Skill Collections
@@ -55,20 +59,18 @@ npx remote-skills uninstall --gemini
 npx remote-skills uninstall --codex --claude
 ```
 
-### Add
-
-`add` supports two forms:
-
-- Add a collection ID:
+### Add Collection
 
 ```bash
-npx remote-skills add collection <id>
+npx remote-skills config add collection <id>
 ```
 
-- Copy `skills/remote-skills` into a specific directory:
+### Install to Specific Directory
+
+Copy `skills/remote-skills` into a specific directory:
 
 ```bash
-npx remote-skills add <DIR>
+npx remote-skills install <DIR>
 ```
 
 Result path:
@@ -80,15 +82,15 @@ Result path:
 ### Config Commands
 
 Manage `timeout`, `collection`, and `maxSkillCount`:
-(`add collection <id>` below is different from `add <DIR>` in the Add section.)
+(`config add collection <id>` below is different from `install <DIR>` above.)
 
 ```bash
-npx remote-skills show [timeout|collections|maxSkillCount]
-npx remote-skills set timeout <ms>
-npx remote-skills set maxSkillCount <n>
-npx remote-skills set collection <id1> <id2> ...
-npx remote-skills add collection <id>
-npx remote-skills remove collection <id>
+npx remote-skills config show [timeout|collections|maxSkillCount]
+npx remote-skills config set timeout <ms>
+npx remote-skills config set maxSkillCount <n>
+npx remote-skills config set collection <id1> <id2> ...
+npx remote-skills config add collection <id>
+npx remote-skills config remove collection <id>
 ```
 
 ### Config Target Resolution

package/bin/remote-skills.js

@@ -8,7 +8,7 @@ const BUNDLED_CLI_MODULE_PATH = path.resolve(
   __dirname,
   "../skills/remote-skills/cli/cli.js"
 );
-const CONFIG_SHORTCUT_COMMANDS = new Set(["show", "set", "add", "remove"]);
+const CONFIG_COMMANDS = new Set(["show", "set", "add", "remove"]);
 const AGENT_DIR_CANDIDATES = {
   codex: [".codex", "codex"],
   claude: [".claude", "claude"],
@@ -26,27 +26,39 @@ const LOCAL_CLI_MODULE_CANDIDATES = [
 
 const usage = () => {
   console.log(`Usage:
-  remote-skills add <DIR>
+  remote-skills install <DIR>
   remote-skills install [--codex] [--claude] [--gemini]
   remote-skills uninstall [--codex] [--claude] [--gemini]
   remote-skills <query>... [-s|--session <sessionId>] [--debug]
-  remote-skills show [timeout|collections|maxSkillCount]
-  remote-skills set timeout <ms>
-  remote-skills set maxSkillCount <n>
-  remote-skills set collection <id1> <id2> ...
-  remote-skills add collection <id>
-  remote-skills remove collection <id>
+  remote-skills config show [timeout|collections|maxSkillCount]
+  remote-skills config set timeout <ms>
+  remote-skills config set maxSkillCount <n>
+  remote-skills config set collection <id1> <id2> ...
+  remote-skills config add collection <id>
+  remote-skills config remove collection <id>
 
 Examples:
-  remote-skills add /path/to/project
+  remote-skills install /path/to/project
   remote-skills install
   remote-skills install --gemini
   remote-skills install --codex --claude
   remote-skills uninstall --gemini
-  remote-skills set collection rskill-1 rskill-2
+  remote-skills config set collection rskill-1 rskill-2
   remote-skills react architecture -s cache`);
 };
 
+const ensureConfigPrefixForConfigCommands = (args) => {
+  const [command] = args;
+
+  if (!CONFIG_COMMANDS.has(command)) {
+    return;
+  }
+
+  throw new Error(
+    `Config command must start with 'config'. Use: remote-skills config ${args.join(" ")}`
+  );
+};
+
 const hasDir = (dirPath) =>
   fs.existsSync(dirPath) && fs.statSync(dirPath).isDirectory();
 const hasFile = (filePath) =>
@@ -243,18 +255,19 @@ const main = async () => {
   }
 
   if (args[0] === "add") {
-    if (args[1] === "collection") {
-      await cliModule.main(["config", ...args]);
-      return;
-    }
-    if (!args[1]) {
-      throw new Error("Missing target directory. Usage: remote-skills add <DIR>");
-    }
-    copySkillDirectory(args[1]);
-    return;
+    throw new Error(
+      "Use 'remote-skills install <DIR>' for directory installation, or 'remote-skills config add collection <id>' for config."
+    );
   }
 
   if (args[0] === "install") {
+    if (args[1] && !args[1].startsWith("--")) {
+      if (args.length > 2) {
+        throw new Error("Usage: remote-skills install <DIR>");
+      }
+      copySkillDirectory(args[1]);
+      return;
+    }
     installToAgents(parseTargetAgents(args.slice(1)));
     return;
   }
@@ -264,10 +277,7 @@ const main = async () => {
     return;
   }
 
-  if (CONFIG_SHORTCUT_COMMANDS.has(args[0])) {
-    await cliModule.main(["config", ...args]);
-    return;
-  }
+  ensureConfigPrefixForConfigCommands(args);
 
   await cliModule.main(args);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-skills",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Remote-skill: AI agent skills that are automatically discovered and downloaded when needed instead of being permanently included in the agent’s context.",
   "homepage": "https://rskills.cokplay.com",
   "main": "skills/remote-skills/cli/cli.js",

package/skills/remote-skills/cli/README.md

@@ -2,16 +2,10 @@
 
 `cli/cli.js` provides remote skill search/download and CLI config management.
 
-If you want to run the `remote-skills` binary directly via npx from npm package name:
-
-```bash
-npx --package remote-skills remote-skills --help
-```
-
 ## 1) Where to run
 
 ```bash
-npx remote-skills --help
+node cli.js --help
 ```
 
 ---
@@ -19,7 +13,7 @@ npx remote-skills --help
 ## 2) Basic usage
 
 ```bash
-npx remote-skills "<query>" ... --session|-s "<sessionId>" [--debug]
+node cli/cli.js "<query>" ... --session|-s "<sessionId>" [--debug]
 ```
 
 ### Options
@@ -41,9 +35,7 @@ npx remote-skills "<query>" ... --session|-s "<sessionId>" [--debug]
 ## 3) Config commands
 
 ```bash
-npx remote-skills config <command> [args]
-# or shorthand:
-npx remote-skills <show|set|add|remove> ...
+node cli/cli.js config <command> [args]
 ```
 
 ### Supported commands
@@ -70,40 +62,27 @@ Main keys:
 ### Search
 
 ```bash
-npx remote-skills react -s rskill-20260307-demo
-npx remote-skills "react" "next" -s rskill-batch --debug
+node cli/cli.js react -s rskill-20260307-demo
+node cli/cli.js "react" "next" -s rskill-batch --debug
 ```
 
 ### Read config
 
 ```bash
-npx remote-skills config show
-npx remote-skills config show timeout
-npx remote-skills config show collections
-npx remote-skills config show maxSkillCount
-
-# shorthand
-npx remote-skills show
-npx remote-skills show timeout
-npx remote-skills show collections
-npx remote-skills show maxSkillCount
+node cli/cli.js config show
+node cli/cli.js config show timeout
+node cli/cli.js config show collections
+node cli/cli.js config show maxSkillCount
 ```
 
 ### Update config
 
 ```bash
-npx remote-skills config set timeout 15000
-npx remote-skills config set maxSkillCount 50
-npx remote-skills config set collection rskills-1 rskills-2
-npx remote-skills config add collection rskills-3
-npx remote-skills config remove collection rskills-1
-
-# shorthand
-npx remote-skills set timeout 15000
-npx remote-skills set maxSkillCount 50
-npx remote-skills set collection rskills-1 rskills-2
-npx remote-skills add collection rskills-3
-npx remote-skills remove collection rskills-1
+node cli/cli.js config set timeout 15000
+node cli/cli.js config set maxSkillCount 50
+node cli/cli.js config set collection rskills-1 rskills-2
+node cli/cli.js config add collection rskills-3
+node cli/cli.js config remove collection rskills-1
 ```
 
 ### How collection commands behave

package/skills/remote-skills/cli/lib/config.js

@@ -102,13 +102,8 @@ const parseCollectionValues = (values) =>
   values.map((value) => toText(value)).filter(Boolean);
 
 const unique = (values) => [...new Set(values)];
-const normalizeShowTarget = (target) =>
-  target === "collection" ? "collections" : target;
-
 const readShowValue = (target, config) => {
-  const normalizedTarget = normalizeShowTarget(target);
-
-  if (!normalizedTarget || normalizedTarget === "all") {
+  if (!target || target === "all") {
     return {
       timeout: config.timeout,
       collection: config.collection,
@@ -116,15 +111,15 @@ const readShowValue = (target, config) => {
     };
   }
 
-  if (normalizedTarget === "timeout") {
+  if (target === "timeout") {
     return config.timeout;
   }
 
-  if (normalizedTarget === "collections") {
+  if (target === "collections") {
     return config.collection;
   }
 
-  if (normalizedTarget === "maxskillcount") {
+  if (target === "maxskillcount") {
     return config.maxSkillCount;
   }
 
@@ -137,12 +132,11 @@ const runConfigCommand = async (args = []) => {
   const target = toText(rawTarget).toLowerCase();
 
   if (command === "show") {
-    const normalizedTarget = normalizeShowTarget(target);
     const config = loadConfig();
     return {
       status: "Success",
       command,
-      target: normalizedTarget || "all",
+      target: target || "all",
       value: readShowValue(target, config),
     };
   }