@almyty/skills 1.0.10 → 1.0.12

package/README.md

@@ -7,7 +7,7 @@ Install and manage almyty skills in 30+ AI coding agents (Claude Code, Cursor, W
 ```bash
 $ npx @almyty/auth login
 $ npx @almyty/skills gateways
-$ npx @almyty/skills install @org/gateway
+$ npx @almyty/skills install org/gateway
 ```
 
 ## Commands
@@ -16,23 +16,23 @@ $ npx @almyty/skills install @org/gateway
 |---------|-------------|
 | `gateways` | List your gateways |
 | `list` | List all available skills |
-| `list @org/gateway` | List skills from one gateway |
+| `list org/gateway` | List skills from one gateway |
 | `search <query>` | Search skills by keyword |
-| `install @org/gateway` | Install all skills from a gateway |
-| `install @org/gateway/skill` | Install a single skill |
+| `install org/gateway` | Install all skills from a gateway |
+| `install org/gateway/skill` | Install a single skill |
 | `installed` | Show locally installed skills |
 | `remove` | Remove all installed skills |
-| `run @org/gateway/skill [--key value]` | Execute a skill |
+| `run org/gateway/skill [--key value]` | Execute a skill |
 | `daemon [--interval 60]` | Sync all skills on a schedule |
-| `watch @org/gateway [--interval 60]` | Watch a specific gateway for changes |
+| `watch org/gateway [--interval 60]` | Watch a specific gateway for changes |
 
 ## References
 
-Skills are referenced as `@org/gateway` or `@org/gateway/skill`:
+Skills are referenced as `org/gateway` or `org/gateway/skill`:
 
 ```bash
-$ npx @almyty/skills install @acme/petstore
-$ npx @almyty/skills run @acme/petstore/get-pet --id 123
+$ npx @almyty/skills install acme/petstore
+$ npx @almyty/skills run acme/petstore/get-pet --id 123
 ```
 
 ## Where skills get installed
@@ -77,14 +77,14 @@ Default behavior:
 Examples:
 
 ```bash
-$ npx @almyty/skills install @acme/petstore                          # interactive picker
-$ npx @almyty/skills install @acme/petstore --all                    # every project-detected
-$ npx @almyty/skills install @acme/petstore --all --global           # project AND home detected
-$ npx @almyty/skills install @acme/petstore --global                 # only home-detected agents
-$ npx @almyty/skills install @acme/petstore -a codex                 # codex at whichever scope it lives
-$ npx @almyty/skills install @acme/petstore -a codex --global        # force codex at ~/.codex/skills
-$ npx @almyty/skills install @acme/petstore --agent '*' -y           # every known agent at project
-$ npx @almyty/skills install @acme/petstore -p ./agents/skills       # custom directory
+$ npx @almyty/skills install acme/petstore                          # interactive picker
+$ npx @almyty/skills install acme/petstore --all                    # every project-detected
+$ npx @almyty/skills install acme/petstore --all --global           # project AND home detected
+$ npx @almyty/skills install acme/petstore --global                 # only home-detected agents
+$ npx @almyty/skills install acme/petstore -a codex                 # codex at whichever scope it lives
+$ npx @almyty/skills install acme/petstore -a codex --global        # force codex at ~/.codex/skills
+$ npx @almyty/skills install acme/petstore --agent '*' -y           # every known agent at project
+$ npx @almyty/skills install acme/petstore -p ./agents/skills       # custom directory
 ```
 
 The 25+ supported agents include Claude Code, Codex, Cursor, Windsurf,

package/dist/client.js

@@ -114,16 +114,52 @@ export class AlmytyClient {
     }
     async executeSkill(gatewayId, toolId, parameters) {
         // The execute endpoint expects a UUID. If toolId is a name slug,
-        // resolve it by listing the gateway's tools and matching.
+        // resolve by listing the gateway's tools and matching either
+        // the raw tool name, its kebab slug, OR the new
+        // `${gateway-slug}-${tool-slug}` composed form (with shared
+        // head segments deduped — the same rule the backend uses to
+        // generate SKILL.md names).
         const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
         let resolvedId = toolId;
         if (!uuidRegex.test(toolId)) {
-            const tools = await this.request(`/gateways/${gatewayId}/tools`);
-            const list = tools?.data?.gatewayTools || tools?.data?.data || tools?.data || [];
-            const match = (Array.isArray(list) ? list : []).find((gt) => {
+            const gateway = await this.request(`/gateways/${gatewayId}`).catch(() => null);
+            const gatewaySlug = gateway?.data?.endpoint?.replace(/^\/+/, '') || '';
+            // Walk every page — server caps limit at 100.
+            const allTools = [];
+            let page = 1;
+            while (true) {
+                const resp = await this.request(`/gateways/${gatewayId}/tools?limit=100&page=${page}`);
+                const data = resp?.data || resp;
+                const items = data?.gatewayTools || data?.data || (Array.isArray(data) ? data : []);
+                allTools.push(...(Array.isArray(items) ? items : []));
+                const totalPages = data?.totalPages ?? 1;
+                if (page >= totalPages || items.length === 0)
+                    break;
+                page++;
+                if (page > 50)
+                    break;
+            }
+            const slugify = (s) => (s || '').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+            const dedupeShared = (head, tail) => {
+                const h = head.split('-').filter(Boolean);
+                const t = tail.split('-').filter(Boolean);
+                let i = 0;
+                while (i < t.length && i < h.length && t[i] === h[i])
+                    i++;
+                return t.slice(i).join('-');
+            };
+            const match = allTools.find((gt) => {
                 const t = gt.tool || gt;
-                const slug = t.name?.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
-                return slug === toolId || t.name === toolId;
+                if (!t)
+                    return false;
+                const rawName = t.name || '';
+                const slug = slugify(rawName);
+                const composed = gatewaySlug
+                    ? `${gatewaySlug}-${dedupeShared(gatewaySlug, slug)}`
+                    : slug;
+                return (rawName === toolId ||
+                    slug === toolId ||
+                    composed === toolId);
             });
             if (!match) {
                 throw new Error(`Tool "${toolId}" not found in gateway ${gatewayId}`);

package/dist/index.js

@@ -6,7 +6,7 @@ import { installSkills, removeSkills, listInstalledSkills } from './installer.js
 import { loadConfig, resolveTargets } from './config.js';
 import { generateMetaSkill } from './meta-skill.js';
 import { selectInstallTargetsAuto, selectInstallTargetsInteractive, } from './target-selector.js';
-const VERSION = '1.0.10';
+const VERSION = '1.0.12';
 function printHelp() {
     console.log(`
 almyty Skills CLI v${VERSION}
@@ -74,9 +74,9 @@ Target selection (install):
 Examples:
   npx @almyty/skills daemon
   npx @almyty/skills install myorg/petstore/get-pet
-  npx @almyty/skills install @org/gw -a codex -a claude
-  npx @almyty/skills install @org/gw --path ./tmp/skills --yes
-  npx @almyty/skills install @org/gw --all
+  npx @almyty/skills install acme/petstore -a codex -a claude
+  npx @almyty/skills install acme/petstore --path ./tmp/skills --yes
+  npx @almyty/skills install acme/petstore --all
   npx @almyty/skills search "weather"
   npx @almyty/skills run myorg/petstore/get-pet --petId 123
 `);
@@ -182,7 +182,7 @@ function requireRef(args, command) {
     const ref = getRef(args);
     if (!ref) {
         console.error('Error: reference required');
-        console.error(`  npx @almyty/skills ${command} @<org>/<gateway>`);
+        console.error(`  npx @almyty/skills ${command} <org>/<gateway>`);
         console.error(`  npx @almyty/skills ${command} <skill-name>`);
         process.exit(1);
     }
@@ -239,7 +239,7 @@ async function main() {
                 const slug = gw.name.toLowerCase().replace(/\s+/g, '-');
                 console.log(`  ${gw.name}`);
                 console.log(`    Type: ${gw.type}`);
-                console.log(`    Use:  npx @almyty/skills install @<org>/${slug}`);
+                console.log(`    Use:  npx @almyty/skills install <org>/${slug}`);
                 console.log('');
             }
             break;
@@ -256,7 +256,7 @@ async function main() {
                 }
                 console.log(`\n${allSkills.length} skills available:\n`);
                 for (const skill of allSkills) {
-                    const label = skill.gateway ? `@${skill.orgSlug}/${skill.gatewaySlug}/${skill.name}` : skill.name;
+                    const label = skill.gateway ? `${skill.orgSlug}/${skill.gatewaySlug}/${skill.name}` : skill.name;
                     const desc = skill.description ? ` — ${skill.description}` : '';
                     console.log(`  ${label}${desc}`);
                 }
@@ -283,7 +283,7 @@ async function main() {
                 }
                 console.log(`\n${allSkills.length} skills available:\n`);
                 for (const skill of allSkills) {
-                    const label = skill.gateway ? `@${skill.orgSlug}/${skill.gatewaySlug}/${skill.name}` : skill.name;
+                    const label = skill.gateway ? `${skill.orgSlug}/${skill.gatewaySlug}/${skill.name}` : skill.name;
                     const desc = skill.description ? ` — ${skill.description}` : '';
                     console.log(`  ${label}${desc}`);
                 }
@@ -332,10 +332,11 @@ async function main() {
             }
             else if (parsed.type === 'skill') {
                 console.log('Fetching skill...');
-                const gatewayRef = `@${parsed.orgSlug}/${parsed.gatewaySlug}`;
+                const gatewayRef = `${parsed.orgSlug}/${parsed.gatewaySlug}`;
                 const fetched = await client.fetchSkills(gatewayRef);
                 const match = fetched.find(s => s.name === parsed.skillName ||
-                    s.fileName === `almyty-${parsed.skillName}`);
+                    s.fileName === `almyty-${parsed.skillName}` ||
+                    s.fileName === parsed.skillName);
                 if (!match) {
                     console.error(`Skill "${parsed.skillName}" not found in ${gatewayRef}`);
                     const available = fetched.map(s => s.name).join(', ');
@@ -511,7 +512,7 @@ async function main() {
             }
             if (totalFound === 0) {
                 console.log('No almyty skills installed in this directory.');
-                console.log('Install: npx @almyty/skills install @<org>/<gateway>');
+                console.log('Install: npx @almyty/skills install <org>/<gateway>');
             }
             break;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almyty/skills",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Install API skills into AI coding agents \u2014 Claude Code, Cursor, Windsurf, Copilot, Codex",
   "type": "module",
   "main": "dist/index.js",