@quadient/skillshare 0.1.0 → 1.0.0

package/README.md

@@ -9,6 +9,8 @@ bun run index.ts
 bun run index.ts login
 bun run index.ts login local
 bun run index.ts list
+bun run index.ts install
+bun run index.ts install "Prompt Lint"
 bun run index.ts upload ./examples/prompt-lint --version 0.1.0
 bun run index.ts install 12 0.1.0 --target ./installed
 bun run index.ts install --skill-version-id 42 --target ./installed
@@ -17,6 +19,7 @@ bun run index.ts install --skill-version-id 42 --target ./installed
 Interactive behavior:
 
 - If the current directory already contains SKILL.md, the TUI offers to upload it before showing the main action picker.
+- `install` opens the guided installer. When you pass `<skillId|skillName>`, the installer opens with that skill already selected; adding `[version]` skips the version picker too.
 - After install or upload, the CLI writes skillshare.metadata.json into the skill directory with the skill id, name, description, and installed or published version.
 - When skillshare.metadata.json already exists, uploads publish a new version of that skill instead of creating a duplicate entry.
 - New skill creation derives name and description from SKILL.md frontmatter when available, so the user usually only needs to enter the initial version.

package/dist/index.js

@@ -71,7 +71,9 @@ Commands:
   list
   show <skillId> [version]
   upload <directory> --version <version> [--skill-id <id>] [--name <name> --description <desc>]
-  install <skillId> [version] --target <directory>
+  install
+  install <skillId|skillName> [version]
+  install <skillId|skillName> [version] --target <directory>
   install --skill-version-id <id> --target <directory>
 
 Options:
@@ -160,7 +162,7 @@ async function main() {
                 }
                 case 'install': {
                     const skillVersionId = options.flags['skill-version-id'];
-                    const skillId = options.positionals[0];
+                    const skillRef = options.positionals[0];
                     const version = options.positionals[1];
                     const target = options.flags.target;
                     if (skillVersionId) {
@@ -185,16 +187,24 @@ async function main() {
                         console.log(`Installed skillVersion ${parsedSkillVersionId} (${detail.skillId}@${detail.version}) to ${target}`);
                         return;
                     }
-                    if (!skillId || !target) {
-                        throw new Error('install requires <skillId> [version] --target <directory> or --skill-version-id <id> --target <directory>');
+                    if (!target) {
+                        await runInteractiveInstall(client, {
+                            skillRef,
+                            version,
+                        });
+                        return;
                     }
-                    const skill = await client.get(`/api/skills/${skillId}`);
+                    if (!skillRef) {
+                        throw new Error('install requires <skillId|skillName> [version] when --target <directory> is provided');
+                    }
+                    const skills = await client.get('/api/skills');
+                    const skill = resolveSkillReference(skills, skillRef);
                     const effectiveVersion = version ?? skill.latestVersion;
                     if (!effectiveVersion) {
-                        throw new Error(`Skill '${skillId}' does not have a published version.`);
+                        throw new Error(`Skill '${skill.name}' does not have a published version.`);
                     }
-                    const detail = await client.get(`/api/skills/${skillId}/versions/${effectiveVersion}`);
-                    await client.post(`/api/skills/${skillId}/versions/${effectiveVersion}/downloads`);
+                    const detail = await client.get(`/api/skills/${skill.id}/versions/${effectiveVersion}`);
+                    await client.post(`/api/skills/${skill.id}/versions/${effectiveVersion}/downloads`);
                     await writeSkillVersionToDirectory(client, {
                         skillId: skill.id,
                         skillName: skill.name,
@@ -203,7 +213,7 @@ async function main() {
                         files: detail.files,
                         targetRoot: target,
                     });
-                    console.log(`Installed ${skillId}@${effectiveVersion} to ${target}`);
+                    console.log(`Installed ${skill.name}@${effectiveVersion} to ${target}`);
                     return;
                 }
             }
@@ -266,14 +276,18 @@ async function ensureInteractiveLogin(baseUrl) {
         await login(baseUrl);
     }
 }
-async function runInteractiveInstall(client) {
+async function runInteractiveInstall(client, options) {
     const skills = await client.get('/api/skills');
     if (skills.length === 0) {
         throw new Error('No skills available in the registry.');
     }
-    const skill = await promptForSkill(skills);
+    const skill = options?.skillRef
+        ? resolveSkillReference(skills, options.skillRef)
+        : await promptForSkill(skills);
     const detail = await client.get(`/api/skills/${skill.id}`);
-    const selectedVersion = await promptForVersion(detail);
+    const selectedVersion = options?.version
+        ? resolveSkillVersion(detail, options.version)
+        : await promptForVersion(detail);
     const scope = await promptForInstallScope();
     const selectedAgents = await promptForAgents(scope);
     if (selectedAgents.length === 0) {
@@ -723,6 +737,47 @@ function normalizeText(value) {
     const trimmed = value?.trim();
     return trimmed ? trimmed : null;
 }
+function resolveSkillReference(skills, reference) {
+    const normalizedReference = normalizeText(reference)?.toLowerCase();
+    if (!normalizedReference) {
+        throw new Error('Skill reference is required.');
+    }
+    const idMatch = skills.find((skill) => String(skill.id) === normalizedReference);
+    if (idMatch) {
+        return idMatch;
+    }
+    const exactNameMatches = skills.filter((skill) => normalizeText(skill.name)?.toLowerCase() === normalizedReference);
+    const exactNameMatch = exactNameMatches[0];
+    if (exactNameMatches.length === 1 && exactNameMatch) {
+        return exactNameMatch;
+    }
+    if (exactNameMatches.length > 1) {
+        throw new Error(`Skill reference '${reference}' matches multiple skills: ${formatSkillMatches(exactNameMatches)}. Use the numeric skill id instead.`);
+    }
+    const slugMatches = skills.filter((skill) => createInstalledSkillDirectoryName(skill) === normalizedReference);
+    const slugMatch = slugMatches[0];
+    if (slugMatches.length === 1 && slugMatch) {
+        return slugMatch;
+    }
+    if (slugMatches.length > 1) {
+        throw new Error(`Skill reference '${reference}' matches multiple skills: ${formatSkillMatches(slugMatches)}. Use the numeric skill id instead.`);
+    }
+    throw new Error(`Skill '${reference}' was not found. Run "skillshare list" to inspect available skills.`);
+}
+function resolveSkillVersion(detail, version) {
+    const normalizedVersion = normalizeText(version);
+    if (!normalizedVersion) {
+        throw new Error('Version is required.');
+    }
+    const requestedVersion = detail.versions.find((item) => item.version === normalizedVersion);
+    if (!requestedVersion) {
+        throw new Error(`Skill '${detail.name}' does not have version '${normalizedVersion}'.`);
+    }
+    return requestedVersion.version;
+}
+function formatSkillMatches(skills) {
+    return skills.map((skill) => `${skill.id}:${skill.name}`).join(', ');
+}
 function filterSkills(skills, query) {
     const normalized = query.trim().toLowerCase();
     return skills.filter((skill) => skill.name.toLowerCase().includes(normalized) ||
@@ -1032,11 +1087,21 @@ async function openBrowser(url) {
         return;
     }
     if (process.platform === 'win32') {
-        const result = await runProcess('cmd', ['/c', 'start', '', url], { allowFailure: true });
-        if (result.exitCode !== 0) {
-            throw new Error(result.stderr.trim() || 'Failed to open browser.');
+        for (const [command, args] of [
+            ['explorer.exe', [url]],
+            ['rundll32.exe', ['url.dll,FileProtocolHandler', url]],
+        ]) {
+            try {
+                const result = await runProcess(command, args, { allowFailure: true });
+                if (result.exitCode === 0) {
+                    return;
+                }
+            }
+            catch {
+                // Try the next opener.
+            }
         }
-        return;
+        throw new Error('Failed to open browser.');
     }
     const result = await runProcess('xdg-open', [url], { allowFailure: true });
     if (result.exitCode !== 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quadient/skillshare",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Skillshare CLI for installing and publishing Quadient skills",
   "type": "module",
   "bin": {