@orth/cli 0.2.2 → 0.2.3

package/dist/commands/api.js

@@ -36,7 +36,7 @@ async function apiCommand(slug, path, options) {
                     chalk_1.default.white(api.name || "") +
                     chalk_1.default.gray(` (${api.endpoints?.length || 0} endpoints)`));
             }
-            console.log(chalk_1.default.gray("\nRun 'ortho api <slug>' to see endpoints for an API"));
+            console.log(chalk_1.default.gray("\nRun 'orth api <slug>' to see endpoints for an API"));
             return;
         }
         if (path) {
@@ -127,7 +127,7 @@ async function apiCommand(slug, path, options) {
         const api = data.results.find((a) => a.slug === slug);
         if (!api) {
             console.log(chalk_1.default.yellow(`API '${slug}' not found.`));
-            console.log(chalk_1.default.gray("Run 'ortho api' to see available APIs"));
+            console.log(chalk_1.default.gray("Run 'orth api' to see available APIs"));
             return;
         }
         console.log(chalk_1.default.bold(`\n${chalk_1.default.cyan(api.name)} (${api.slug})\n`));
@@ -139,8 +139,8 @@ async function apiCommand(slug, path, options) {
                 console.log(chalk_1.default.gray(`       ${endpoint.description.slice(0, 80)}${endpoint.description.length > 80 ? "..." : ""}`));
             }
         }
-        console.log(chalk_1.default.gray("\nRun 'ortho api " + slug + " <path>' for endpoint details"));
-        console.log(chalk_1.default.gray("Run 'ortho run " + slug + " <path>' to call an endpoint"));
+        console.log(chalk_1.default.gray("\nRun 'orth api " + slug + " <path>' for endpoint details"));
+        console.log(chalk_1.default.gray("Run 'orth run " + slug + " <path>' to call an endpoint"));
     }
     catch (error) {
         spinner.stop();

package/dist/commands/skills.d.ts

@@ -21,6 +21,10 @@ export declare function skillsSubmitCommand(inputPath: string | undefined, optio
     name?: string;
     tags?: string;
 }): Promise<void>;
+export declare function skillsUpdateCommand(slug: string, inputPath: string | undefined, options: {
+    name?: string;
+    tags?: string;
+}): Promise<void>;
 export declare function skillsRequestVerificationCommand(slug: string): Promise<void>;
 export declare function skillsPublishCommand(slug: string, options: {
     unpublish?: boolean;

package/dist/commands/skills.js

@@ -43,6 +43,7 @@ exports.skillsCreateCommand = skillsCreateCommand;
 exports.skillsInstallCommand = skillsInstallCommand;
 exports.skillsInitCommand = skillsInitCommand;
 exports.skillsSubmitCommand = skillsSubmitCommand;
+exports.skillsUpdateCommand = skillsUpdateCommand;
 exports.skillsRequestVerificationCommand = skillsRequestVerificationCommand;
 exports.skillsPublishCommand = skillsPublishCommand;
 exports.skillsRequestCommand = skillsRequestCommand;
@@ -63,7 +64,7 @@ const AGENT_DIRS = {
     openclaw: path.join(os.homedir(), ".openclaw", "skills"),
 };
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills list
+// orth skills list
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsListCommand(options) {
     const spinner = (0, ora_1.default)("Loading skills...").start();
@@ -93,8 +94,8 @@ async function skillsListCommand(options) {
             console.log(chalk_1.default.gray(`  Slug: ${skill.slug}`));
             console.log();
         }
-        console.log(chalk_1.default.gray("Run 'ortho skills show <slug>' to see skill details"));
-        console.log(chalk_1.default.gray("Run 'ortho skills add <slug>' to add a skill locally"));
+        console.log(chalk_1.default.gray("Run 'orth skills show <slug>' to see skill details"));
+        console.log(chalk_1.default.gray("Run 'orth skills add <slug>' to add a skill locally"));
     }
     catch (error) {
         spinner.stop();
@@ -103,7 +104,7 @@ async function skillsListCommand(options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills search <query>
+// orth skills search <query>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsSearchCommand(query, options) {
     const spinner = (0, ora_1.default)("Searching skills...").start();
@@ -128,7 +129,7 @@ async function skillsSearchCommand(query, options) {
             console.log(chalk_1.default.gray(`  Slug: ${skill.slug}`));
             console.log();
         }
-        console.log(chalk_1.default.gray("Run 'ortho skills show <slug>' for full details"));
+        console.log(chalk_1.default.gray("Run 'orth skills show <slug>' for full details"));
     }
     catch (error) {
         spinner.stop();
@@ -137,7 +138,7 @@ async function skillsSearchCommand(query, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills show <slug>
+// orth skills show <slug>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsShowCommand(slug) {
     const spinner = (0, ora_1.default)("Loading skill...").start();
@@ -191,7 +192,7 @@ async function skillsShowCommand(slug) {
             console.log(chalk_1.default.bold("Install:"));
             console.log(chalk_1.default.white(`  ${skill.installCommand}`));
         }
-        console.log(chalk_1.default.gray(`\nRun 'ortho skills add ${skill.slug}' to add locally`));
+        console.log(chalk_1.default.gray(`\nRun 'orth skills add ${skill.slug}' to add locally`));
     }
     catch (error) {
         spinner.stop();
@@ -200,7 +201,7 @@ async function skillsShowCommand(slug) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills create <githubRepo>
+// orth skills create <githubRepo>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsCreateCommand(githubRepo, options) {
     const spinner = (0, ora_1.default)("Creating skill from GitHub...").start();
@@ -242,7 +243,7 @@ async function skillsCreateCommand(githubRepo, options) {
             console.log(chalk_1.default.gray(`  ${data.skill.description}`));
         }
         console.log(chalk_1.default.bold("\nYour skill is on the platform but not yet verified."));
-        console.log(chalk_1.default.white(`To request verification: ${chalk_1.default.cyan(`ortho skills request-verification ${data.skill.slug}`)}`));
+        console.log(chalk_1.default.white(`To request verification: ${chalk_1.default.cyan(`orth skills request-verification ${data.skill.slug}`)}`));
         console.log(chalk_1.default.gray("Once verified, you can toggle discoverability anytime."));
     }
     catch (error) {
@@ -252,7 +253,7 @@ async function skillsCreateCommand(githubRepo, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills add <slug>
+// orth skills add <slug>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsInstallCommand(slug, options) {
     const spinner = (0, ora_1.default)("Fetching skill...").start();
@@ -333,7 +334,7 @@ async function skillsInstallCommand(slug, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills init [name]
+// orth skills init [name]
 // ─────────────────────────────────────────────────────────────────────────────
 // Known binary/large file extensions to skip when reading local files
 const SKIP_EXTENSIONS = new Set([
@@ -419,7 +420,7 @@ Describe the next step.
         console.log(chalk_1.default.bold("\nNext steps:"));
         console.log(chalk_1.default.white("  1. Edit SKILL.md with your skill's instructions"));
         console.log(chalk_1.default.white("  2. Add any supporting files to scripts/, references/, or assets/"));
-        console.log(chalk_1.default.white(`  3. Submit to Orthogonal: ${chalk_1.default.cyan(`ortho skills submit ${dirPath}`)}`));
+        console.log(chalk_1.default.white(`  3. Submit to Orthogonal: ${chalk_1.default.cyan(`orth skills submit ${dirPath}`)}`));
     }
     catch (error) {
         console.error(chalk_1.default.red(`Error: ${error instanceof Error ? error.message : "Unknown error"}`));
@@ -427,7 +428,7 @@ Describe the next step.
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills submit [path]
+// orth skills submit [path]
 // ─────────────────────────────────────────────────────────────────────────────
 function readFilesRecursive(dirPath, basePath = "") {
     const files = [];
@@ -508,7 +509,7 @@ async function skillsSubmitCommand(inputPath, options) {
         if (!primaryFile) {
             spinner.stop();
             console.error(chalk_1.default.red("Error: No SKILL.md found in the root of the directory"));
-            console.log(chalk_1.default.gray("Run 'ortho skills init' to create a skill template"));
+            console.log(chalk_1.default.gray("Run 'orth skills init' to create a skill template"));
             process.exit(1);
         }
         // Parse frontmatter
@@ -565,7 +566,7 @@ async function skillsSubmitCommand(inputPath, options) {
             console.log(chalk_1.default.gray(`  ${data.skill.description.slice(0, 100)}`));
         }
         console.log(chalk_1.default.bold("\nYour skill is on the platform but not yet verified."));
-        console.log(chalk_1.default.white(`To request verification: ${chalk_1.default.cyan(`ortho skills request-verification ${data.skill.slug}`)}`));
+        console.log(chalk_1.default.white(`To request verification: ${chalk_1.default.cyan(`orth skills request-verification ${data.skill.slug}`)}`));
         console.log(chalk_1.default.gray("Once verified, you can toggle discoverability anytime."));
         console.log(chalk_1.default.gray(`Dashboard: https://orthogonal.com/dashboard/skills`));
     }
@@ -576,7 +577,88 @@ async function skillsSubmitCommand(inputPath, options) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills request-verification <slug>
+// orth skills update <slug> [path]
+// ─────────────────────────────────────────────────────────────────────────────
+async function skillsUpdateCommand(slug, inputPath, options) {
+    const dirPath = inputPath ? path.resolve(inputPath) : process.cwd();
+    const spinner = (0, ora_1.default)("Reading skill files...").start();
+    try {
+        // Validate directory exists
+        if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory()) {
+            spinner.stop();
+            console.error(chalk_1.default.red(`Error: ${dirPath} is not a directory`));
+            process.exit(1);
+        }
+        // Read all files
+        const files = readFilesRecursive(dirPath);
+        if (files.length === 0) {
+            spinner.stop();
+            console.error(chalk_1.default.red("Error: No files found in the directory"));
+            process.exit(1);
+        }
+        // Validate SKILL.md exists
+        const primaryFile = files.find((f) => f.isPrimary);
+        if (!primaryFile) {
+            spinner.stop();
+            console.error(chalk_1.default.red("Error: No SKILL.md found in the root of the directory"));
+            process.exit(1);
+        }
+        // Parse frontmatter
+        // Note: Unlike submit, name/description are optional for updates
+        // We only send them if provided (to allow partial updates)
+        const frontmatter = parseFrontmatter(primaryFile.content);
+        const skillName = options.name || frontmatter.name;
+        const skillDescription = frontmatter.description;
+        // Check size limits
+        const totalSize = files.reduce((acc, f) => acc + f.content.length, 0);
+        if (files.length > 50) {
+            spinner.stop();
+            console.error(chalk_1.default.red("Error: Too many files (max 50)"));
+            process.exit(1);
+        }
+        if (totalSize > 1024 * 1024) {
+            spinner.stop();
+            console.error(chalk_1.default.red("Error: Total content too large (max 1MB)"));
+            process.exit(1);
+        }
+        spinner.text = "Updating skill...";
+        const tags = options.tags
+            ? options.tags.split(",").map((t) => t.trim())
+            : undefined;
+        const updatePayload = {
+            files: files.map((f) => ({
+                filePath: f.filePath,
+                content: f.content,
+                isPrimary: f.isPrimary,
+            })),
+        };
+        if (skillName)
+            updatePayload.name = skillName;
+        if (skillDescription)
+            updatePayload.description = skillDescription;
+        if (tags)
+            updatePayload.tags = tags;
+        const data = await (0, api_js_1.apiRequest)(`/skills/${slug}`, {
+            method: "PUT",
+            body: updatePayload,
+        });
+        spinner.stop();
+        console.log(chalk_1.default.green(`\n✓ Skill updated successfully`));
+        console.log(chalk_1.default.bold(`\n${data.skill.name}`));
+        console.log(chalk_1.default.gray(`  Slug: ${data.skill.slug}`));
+        console.log(chalk_1.default.gray(`  Files: ${files.length}`));
+        if (data.skill.description) {
+            console.log(chalk_1.default.gray(`  ${data.skill.description.slice(0, 100)}`));
+        }
+    }
+    catch (error) {
+        spinner.stop();
+        console.error(chalk_1.default.red(`Error: ${error instanceof Error ? error.message : "Unknown error"}`));
+        process.exit(1);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// orth skills request-verification <slug>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsRequestVerificationCommand(slug) {
     const spinner = (0, ora_1.default)("Submitting verification request...").start();
@@ -604,16 +686,16 @@ async function skillsRequestVerificationCommand(slug) {
     }
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills publish <slug> (deprecated - redirects to request-verification)
+// orth skills publish <slug> (deprecated - redirects to request-verification)
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsPublishCommand(slug, options) {
     console.log(chalk_1.default.yellow("Note: Direct publishing has been replaced with a verification workflow."));
-    console.log(chalk_1.default.white(`\nTo request your skill to be verified, run:\n  ${chalk_1.default.cyan(`ortho skills request-verification ${slug}`)}`));
+    console.log(chalk_1.default.white(`\nTo request your skill to be verified, run:\n  ${chalk_1.default.cyan(`orth skills request-verification ${slug}`)}`));
     console.log(chalk_1.default.white("Once verified, you can toggle discoverability from your dashboard."));
     console.log(chalk_1.default.gray("\nOr manage from the dashboard: https://orthogonal.com/dashboard/skills"));
 }
 // ─────────────────────────────────────────────────────────────────────────────
-// ortho skills request <input>
+// orth skills request <input>
 // ─────────────────────────────────────────────────────────────────────────────
 async function skillsRequestCommand(input) {
     const spinner = (0, ora_1.default)("Submitting skill request...").start();

package/dist/index.js

@@ -175,6 +175,15 @@ skillsGroup
     (0, analytics_js_1.trackEvent)("skills.submit", { path: inputPath });
     await (0, skills_js_1.skillsSubmitCommand)(inputPath, options);
 }));
+skillsGroup
+    .command("update <slug> [path]")
+    .description("Update an existing skill with local files")
+    .option("-n, --name <name>", "Override skill name from frontmatter")
+    .option("-t, --tags <tags>", "Comma-separated tags")
+    .action(asyncAction(async (slug, inputPath, options) => {
+    (0, analytics_js_1.trackEvent)("skills.update", { slug, path: inputPath });
+    await (0, skills_js_1.skillsUpdateCommand)(slug, inputPath, options);
+}));
 skillsGroup
     .command("request-verification <slug>")
     .description("Request verification for your skill (required before discoverability)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orth/cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "CLI to access all APIs and skills on the Orthogonal platform",
   "main": "dist/index.js",
   "bin": {