reskill 1.21.0 → 1.22.1

package/README.md

@@ -70,6 +70,7 @@ npx reskill@latest <command>  # Or use npx directly
 | `--no-save`               | `install`                                                     | Install without saving to `skills.json` (for personal skills) |
 | `-g, --global`            | `install`, `uninstall`, `list`                                | Install/manage skills globally (user directory)               |
 | `-a, --agent <agents...>` | `install`                                                     | Specify target agents (e.g., `cursor`, `claude-code`)         |
+| `-a, --agent <agent>`     | `list`                                                        | List skills installed to a specific agent                     |
 | `--mode <mode>`           | `install`                                                     | Installation mode: `symlink` (default) or `copy`              |
 | `--all`                   | `install`                                                     | Install to all agents                                          |
 | `-y, --yes`               | `install`, `uninstall`, `publish`                             | Skip confirmation prompts                                      |

package/README.zh-CN.md

@@ -70,6 +70,7 @@ npx reskill@latest <command>  # 或直接使用 npx
 | `--no-save`               | `install`                                                     | 安装时不保存到 `skills.json`（用于个人技能） |
 | `-g, --global`            | `install`, `uninstall`, `list`                                | 全局安装/管理技能（用户目录）                |
 | `-a, --agent <agents...>` | `install`                                                     | 指定目标 Agent（如 `cursor`, `claude-code`） |
+| `-a, --agent <agent>`     | `list`                                                        | 列出安装到指定 Agent 的技能                  |
 | `--mode <mode>`           | `install`                                                     | 安装模式：`symlink`（默认）或 `copy`         |
 | `--all`                   | `install`                                                     | 安装到所有 Agent                             |
 | `-y, --yes`               | `install`, `uninstall`, `publish`                             | 跳过确认提示                                 |

package/dist/cli/commands/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAq6BpC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,SAuHvB,CAAC;AAEL,eAAe,cAAc,CAAC"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+7BpC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,SAuHvB,CAAC;AAEL,eAAe,cAAc,CAAC"}

package/dist/cli/commands/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;GAEG;AACH,eAAO,MAAM,WAAW,SAsCpB,CAAC;AAEL,eAAe,WAAW,CAAC"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,eAAO,MAAM,WAAW,SAyDpB,CAAC;AAEL,eAAe,WAAW,CAAC"}

package/dist/cli/index.js

@@ -3480,6 +3480,65 @@ ${CURSOR_BRIDGE_MARKER}
     }
 }
 // ============================================================================
+// Internal helpers
+// ============================================================================
+/**
+ * Extract a human-readable reason from an error thrown by `fetch()`.
+ *
+ * Node's undici throws a generic `TypeError: fetch failed` and stashes the
+ * real reason in `error.cause`. The chain can be deeper than one level —
+ * e.g. through a corporate proxy:
+ *   TypeError: fetch failed
+ *     → DOMException { message: 'Request was cancelled' }
+ *         → RequestAbortedError { code: 'UND_ERR_ABORTED', message: 'aborted' }
+ *
+ * Walk the `cause` chain and prefer the deepest entry that carries a `code`,
+ * since that's the actionable bit for triage. Falls back to the deepest
+ * available `message`, then to the outermost error's message.
+ *
+ * Produces strings like `UND_ERR_CONNECT_TIMEOUT: Connect Timeout Error`.
+ */ function formatFetchCause(err) {
+    // Cap traversal depth to defend against pathological self-referential chains.
+    const MAX_DEPTH = 8;
+    let bestCode;
+    let bestMessage;
+    let fallbackMessage;
+    const seen = new Set();
+    let current = err;
+    for(let depth = 0; depth < MAX_DEPTH && null != current; depth++){
+        if (seen.has(current)) break;
+        seen.add(current);
+        if ('object' != typeof current) break;
+        const node = current;
+        if ('string' == typeof node.code && node.code) {
+            // Prefer the deepest code, so keep overwriting as we descend.
+            bestCode = node.code;
+            if ('string' == typeof node.message && node.message) bestMessage = node.message;
+        } else if ('string' == typeof node.message && node.message && !fallbackMessage) // Remember the first non-empty message in case no code is ever found.
+        // Skip undici's generic outer wrapper to avoid surfacing "fetch failed".
+        {
+            if ('fetch failed' !== node.message) fallbackMessage = node.message;
+        }
+        current = node.cause;
+    }
+    if (bestCode && bestMessage) return `${bestCode}: ${bestMessage}`;
+    if (bestCode) return bestCode;
+    if (fallbackMessage) return fallbackMessage;
+    return err?.message || String(err);
+}
+/**
+ * Render a URL for inclusion in error messages without leaking the query string.
+ * Signed download URLs put the signature in the query, so we strip it.
+ * Returns `<origin><pathname>`, or `<unknown url>` if parsing fails.
+ */ function describeUrl(rawUrl) {
+    try {
+        const u = new URL(rawUrl);
+        return `${u.origin}${u.pathname}`;
+    } catch  {
+        return '<unknown url>';
+    }
+}
+// ============================================================================
 // RegistryClient Class
 // ============================================================================
 class RegistryClient {
@@ -3498,6 +3557,22 @@ class RegistryClient {
         return `${registry}/api`;
     }
     /**
+   * Wrap `fetch()` to convert undici's generic `TypeError: fetch failed`
+   * (raised on DNS / TCP / TLS / connect-timeout errors) into a
+   * {@link RegistryError} that surfaces the underlying `cause` code and
+   * the (sanitized) URL. Without this, users only see `fetch failed`,
+   * which is not actionable for support triage.
+   *
+   * HTTP-level errors (non-2xx responses) are NOT touched here — call sites
+   * still handle them as before.
+   */ async safeFetch(url, init) {
+        try {
+            return await fetch(url, init);
+        } catch (err) {
+            throw new RegistryError(`Network error contacting ${describeUrl(url)}: ${formatFetchCause(err)}`);
+        }
+    }
+    /**
    * Get authorization headers
    */ getAuthHeaders() {
         const headers = {
@@ -3511,7 +3586,7 @@ class RegistryClient {
    * Get current user info (whoami)
    */ async whoami() {
         const url = `${this.getApiBase()}/skill-auth/me`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3529,7 +3604,7 @@ class RegistryClient {
    * @throws RegistryError if authentication fails
    */ async loginCli() {
         const url = `${this.getApiBase()}/skill-auth/login-cli`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'POST',
             headers: this.getAuthHeaders()
         });
@@ -3585,7 +3660,7 @@ class RegistryClient {
    * @throws RegistryError if skill not found or request failed
    */ async getSkillInfo(skillName) {
         const url = `${this.getApiBase()}/skills/${encodeURIComponent(skillName)}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3620,7 +3695,7 @@ class RegistryClient {
         if (void 0 !== options.limit) params.set('limit', String(options.limit));
         if (void 0 !== options.offset) params.set('offset', String(options.offset));
         const url = `${this.getApiBase()}/skills?${params.toString()}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3654,7 +3729,7 @@ class RegistryClient {
         if (/^\d+\.\d+\.\d+/.test(version)) return version;
         // Otherwise treat it as a tag and query dist-tags
         const url = `${this.getApiBase()}/skills/${encodeURIComponent(skillName)}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3692,7 +3767,7 @@ class RegistryClient {
         // Use redirect: 'manual' to capture x-integrity header from 302 responses.
         // The registry returns a 302 redirect to OSS with the integrity header,
         // which would be lost if fetch auto-follows the redirect.
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders(),
             redirect: 'manual'
@@ -3702,7 +3777,7 @@ class RegistryClient {
             const integrity = response.headers.get('x-integrity') || '';
             const location = response.headers.get('location');
             if (!location) throw new RegistryError('Missing redirect location in download response', response.status);
-            const downloadResponse = await fetch(location);
+            const downloadResponse = await this.safeFetch(location);
             if (!downloadResponse.ok) throw new RegistryError(`Download from storage failed: ${downloadResponse.status}`, downloadResponse.status);
             const arrayBuffer = await downloadResponse.arrayBuffer();
             const tarball = Buffer.from(arrayBuffer);
@@ -3802,7 +3877,7 @@ class RegistryClient {
         });
         formData.append('tarball', tarballBlob, `${skillName.replace('/', '-')}.tgz`);
         // Send request
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'POST',
             headers: this.getAuthHeaders(),
             body: formData
@@ -3825,7 +3900,7 @@ class RegistryClient {
             path: groupPath
         });
         const url = `${this.getApiBase()}/skill-groups/resolve?${params.toString()}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3848,7 +3923,7 @@ class RegistryClient {
         if (options.flat) params.set('flat', 'true');
         const qs = params.toString();
         const url = `${this.getApiBase()}/skill-groups${qs ? `?${qs}` : ''}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3866,7 +3941,7 @@ class RegistryClient {
    * @returns Created group
    */ async createGroup(input) {
         const url = `${this.getApiBase()}/skill-groups`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'POST',
             headers: {
                 ...this.getAuthHeaders(),
@@ -3891,7 +3966,7 @@ class RegistryClient {
         const params = dryRun ? '?dry_run=true' : '';
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}${params}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'DELETE',
             headers: this.getAuthHeaders()
         });
@@ -3910,7 +3985,7 @@ class RegistryClient {
    */ async listGroupMembers(groupId) {
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}/members`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3930,7 +4005,7 @@ class RegistryClient {
    */ async addGroupMembers(groupId, userIds, role = 'developer') {
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}/members`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'POST',
             headers: {
                 ...this.getAuthHeaders(),
@@ -3957,7 +4032,7 @@ class RegistryClient {
         });
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}/members?${params.toString()}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'DELETE',
             headers: this.getAuthHeaders()
         });
@@ -3975,7 +4050,7 @@ class RegistryClient {
    */ async updateGroupMemberRole(groupId, userId, role) {
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}/members`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'PATCH',
             headers: {
                 ...this.getAuthHeaders(),
@@ -4308,6 +4383,16 @@ class RegistryResolver {
         return this.isGlobal;
     }
     /**
+   * Determine if the installation is effectively global.
+   *
+   * Claude Cowork 3P always installs to a global app-managed directory regardless
+   * of the isGlobal flag. When all target agents are claude-cowork-3p, the
+   * installation should be treated as global (skip skills.json/skills.lock writes).
+   */ isEffectivelyGlobal(targetAgents) {
+        if (this.isGlobal) return true;
+        return targetAgents.length > 0 && targetAgents.every((a)=>a === claude_3p_installer_CLAUDE_COWORK_3P_AGENT);
+    }
+    /**
    * Get project root directory
    */ getProjectRoot() {
         return this.projectRoot;
@@ -4717,8 +4802,10 @@ class RegistryResolver {
     /**
    * List installed skills
    *
-   * Checks both canonical (.agents/skills/) and legacy (.skills/) locations.
-   */ list() {
+   * When `agent` is specified, lists skills installed to that specific agent.
+   * Otherwise checks both canonical (.agents/skills/) and legacy (.skills/) locations.
+   */ list(options) {
+        if (options?.agent) return this.listByAgent(options.agent);
         const skills = [];
         const seenNames = new Set();
         // Check canonical location first (.agents/skills/)
@@ -4752,6 +4839,38 @@ class RegistryResolver {
                 seenNames.add(name);
             }
         }
+        // In global mode, also include claude-cowork-3p skills (always global)
+        if (this.isGlobal) try {
+            for (const name of listClaude3pSkills()){
+                if (seenNames.has(name)) continue;
+                const skillPath = getClaude3pSkillPath(name);
+                const skill = this.getInstalledSkillFromPath(name, skillPath);
+                if (skill) {
+                    skills.push(skill);
+                    seenNames.add(name);
+                }
+            }
+        } catch  {
+        // Claude Cowork 3P not configured or accessible — skip silently
+        }
+        return skills;
+    }
+    /**
+   * List skills installed to a specific agent
+   */ listByAgent(agent) {
+        const installer = new Installer({
+            cwd: this.projectRoot,
+            global: this.isGlobal
+        });
+        const skillNames = installer.listInstalledSkills(agent);
+        const skills = [];
+        for (const name of skillNames)try {
+            const skillPath = installer.getAgentSkillPath(name, agent);
+            const skill = this.getInstalledSkillFromPath(name, skillPath);
+            if (skill) skills.push(skill);
+        } catch  {
+        // Skip skills whose paths cannot be resolved (e.g. claude-3p not configured)
+        }
         return skills;
     }
     /**
@@ -5005,14 +5124,15 @@ class RegistryResolver {
             const results = await installer.installToAgents(skillInfo.dirPath, skillInfo.name, targetAgents, {
                 mode: mode
             });
-            if (!this.isGlobal) this.lockManager.lockSkill(skillInfo.name, {
+            const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+            if (!effectivelyGlobal) this.lockManager.lockSkill(skillInfo.name, {
                 source: skillSource,
                 version: semanticVersion,
                 ref: gitRef,
                 resolved: repoUrl,
                 commit: cacheResult.commit
             });
-            if (!this.isGlobal && save) {
+            if (!effectivelyGlobal && save) {
                 this.config.ensureExists();
                 this.config.addSkill(skillInfo.name, `${baseRefForSave}#${skillInfo.name}`);
             }
@@ -5070,8 +5190,9 @@ class RegistryResolver {
         const results = await installer.installToAgents(sourcePath, skillName, targetAgents, {
             mode: mode
         });
-        // Update lock file (project mode only)
-        if (!this.isGlobal) {
+        // Update lock file (project mode only, skip for effectively-global installs)
+        const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+        if (!effectivelyGlobal) {
             const lockSource = registryContext?.lockSource ?? `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`;
             this.lockManager.lockSkill(skillName, {
                 source: lockSource,
@@ -5082,8 +5203,8 @@ class RegistryResolver {
                 registry: registryContext?.registryUrl
             });
         }
-        // Update skills.json (project mode only)
-        if (!this.isGlobal && save) {
+        // Update skills.json (project mode only, skip for effectively-global installs)
+        if (!effectivelyGlobal && save) {
             this.config.ensureExists();
             const configRef = registryContext?.configRef ?? this.config.normalizeSkillRef(ref);
             this.config.addSkill(skillName, configRef);
@@ -5141,8 +5262,9 @@ class RegistryResolver {
         const results = await installer.installToAgents(sourcePath, skillName, targetAgents, {
             mode: mode
         });
-        // Update lock file (project mode only)
-        if (!this.isGlobal) {
+        // Update lock file (project mode only, skip for effectively-global installs)
+        const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+        if (!effectivelyGlobal) {
             const lockSource = registryContext?.lockSource ?? `http:${httpInfo.host}/${skillName}`;
             this.lockManager.lockSkill(skillName, {
                 source: lockSource,
@@ -5153,8 +5275,8 @@ class RegistryResolver {
                 registry: registryContext?.registryUrl
             });
         }
-        // Update skills.json (project mode only)
-        if (!this.isGlobal && save) {
+        // Update skills.json (project mode only, skip for effectively-global installs)
+        if (!effectivelyGlobal && save) {
             this.config.ensureExists();
             const configRef = registryContext?.configRef ?? ref;
             this.config.addSkill(skillName, configRef);
@@ -5274,8 +5396,9 @@ class RegistryResolver {
             const results = await installer.installToAgents(extractedPath, shortName, targetAgents, {
                 mode: mode
             });
-            // 7. Update lock file (project mode only)
-            if (!this.isGlobal) this.lockManager.lockSkill(shortName, {
+            // 7. Update lock file (project mode only, skip for effectively-global installs)
+            const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+            if (!effectivelyGlobal) this.lockManager.lockSkill(shortName, {
                 source: `registry:${resolvedParsed.fullName}`,
                 version,
                 ref: version,
@@ -5283,8 +5406,8 @@ class RegistryResolver {
                 commit: resolved.integrity,
                 registry: resolvedRegistryUrl
             });
-            // 8. Update skills.json (project mode only)
-            if (!this.isGlobal && save) {
+            // 8. Update skills.json (project mode only, skip for effectively-global installs)
+            if (!effectivelyGlobal && save) {
                 this.config.ensureExists();
                 // Save with full name for registry skills
                 this.config.addSkill(shortName, ref);
@@ -5350,7 +5473,8 @@ class RegistryResolver {
             registryContext
         };
         // Save custom registry to skills.json.registries (for reinstall without lock file)
-        if (!this.isGlobal && options.registry) {
+        const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+        if (!effectivelyGlobal && options.registry) {
             const registryName = this.deriveRegistryName(options.registry);
             if (registryName) {
                 this.config.ensureExists();
@@ -5453,8 +5577,9 @@ class RegistryResolver {
             const metadata = this.getSkillMetadataFromDir(extractedPath);
             const skillName = metadata?.name ?? shortName;
             const semanticVersion = metadata?.version ?? version;
-            // Update lock file (project mode only)
-            if (!this.isGlobal) this.lockManager.lockSkill(skillName, {
+            // Update lock file (project mode only, skip for effectively-global installs)
+            const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+            if (!effectivelyGlobal) this.lockManager.lockSkill(skillName, {
                 source: `registry:${parsed.fullName}`,
                 version: semanticVersion,
                 ref: version,
@@ -5462,8 +5587,8 @@ class RegistryResolver {
                 commit: '',
                 registry: registryUrl
             });
-            // Update skills.json (project mode only)
-            if (!this.isGlobal && save) {
+            // Update skills.json (project mode only, skip for effectively-global installs)
+            if (!effectivelyGlobal && save) {
                 this.config.ensureExists();
                 this.config.addSkill(skillName, parsed.fullName);
                 // Save custom registry to skills.json.registries (for reinstall without lock file)
@@ -5537,10 +5662,11 @@ class RegistryResolver {
             installDir: defaults.installDir
         });
         const results = installer.uninstallFromAgents(name, targetAgents);
-        // Remove from lock file (project mode only)
-        if (!this.isGlobal) this.lockManager.remove(name);
-        // Remove from skills.json (project mode only)
-        if (!this.isGlobal && this.config.exists()) this.config.removeSkill(name);
+        // Remove from lock file (project mode only, skip for effectively-global installs)
+        const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+        if (!effectivelyGlobal) this.lockManager.remove(name);
+        // Remove from skills.json (project mode only, skip for effectively-global installs)
+        if (!effectivelyGlobal && this.config.exists()) this.config.removeSkill(name);
         const successCount = Array.from(results.values()).filter((r)=>r).length;
         logger_logger.success(`Uninstalled ${name} from ${successCount} agent(s)`);
         return results;
@@ -7609,12 +7735,19 @@ const DEFAULT_INSTALL_DIR = '.skills';
 // ============================================================================
 /**
  * Resolve installation scope (global vs project)
- */ async function resolveInstallScope(ctx) {
+ */ async function resolveInstallScope(ctx, targetAgents) {
     const { options, isReinstallAll, skipConfirm } = ctx;
     // Explicit --global flag
     if (void 0 !== options.global) return options.global;
-    // Skip prompt for reinstall-all (always project scope)
+    // Skip prompt for reinstall-all (always project scope).
+    // Must be checked before the claude-cowork-3p override to avoid
+    // "Cannot install all skills globally" when 3p is the only detected agent.
     if (isReinstallAll) return false;
+    // claude-cowork-3p always installs globally — skip prompt
+    if (targetAgents.length > 0 && targetAgents.every((a)=>a === claude_3p_installer_CLAUDE_COWORK_3P_AGENT)) {
+        __WEBPACK_EXTERNAL_MODULE__clack_prompts__.log.info('Using global scope (claude-cowork-3p is always global)');
+        return true;
+    }
     // Skip prompt if --yes
     if (skipConfirm) return false;
     // Prompt user
@@ -7644,10 +7777,12 @@ const DEFAULT_INSTALL_DIR = '.skills';
 // ============================================================================
 /**
  * Resolve installation mode (symlink vs copy)
- */ async function resolveInstallMode(ctx) {
+ */ async function resolveInstallMode(ctx, targetAgents) {
     const { options, storedMode, isReinstallAll, skipConfirm } = ctx;
     // Priority 1: CLI --mode option
     if (options.mode) return options.mode;
+    // claude-cowork-3p always uses copy mode — skip prompt
+    if (targetAgents.length > 0 && targetAgents.every((a)=>a === claude_3p_installer_CLAUDE_COWORK_3P_AGENT)) return 'copy';
     // Priority 2: Reinstall all with stored mode
     if (isReinstallAll && storedMode) {
         __WEBPACK_EXTERNAL_MODULE__clack_prompts__.log.info(`Using saved install mode: ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan(storedMode)}`);
@@ -8129,14 +8264,14 @@ const DEFAULT_INSTALL_DIR = '.skills';
             // Step 1: Resolve target agents
             targetAgents = await resolveTargetAgents(ctx, spinner);
             // Step 2: Resolve installation scope
-            installGlobally = await resolveInstallScope(ctx);
+            installGlobally = await resolveInstallScope(ctx, targetAgents);
             // Validate: Cannot install all skills globally
             if (ctx.isReinstallAll && installGlobally) {
                 __WEBPACK_EXTERNAL_MODULE__clack_prompts__.log.error('Cannot install all skills globally. Please specify a skill to install.');
                 process.exit(1);
             }
             // Step 3: Resolve installation mode
-            installMode = await resolveInstallMode(ctx);
+            installMode = await resolveInstallMode(ctx, targetAgents);
         }
         // Step 4: Execute installation
         if (ctx.isReinstallAll) await installAllSkills(ctx, targetAgents, installMode, spinner);
@@ -8154,14 +8289,23 @@ const DEFAULT_INSTALL_DIR = '.skills';
 });
 /**
  * list command - List installed skills
- */ const listCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('list').alias('ls').description('List installed skills').option('-j, --json', 'Output as JSON').option('-g, --global', 'List globally installed skills').action((options)=>{
-    const isGlobal = options.global || false;
+ */ const listCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('list').alias('ls').description('List installed skills').option('-j, --json', 'Output as JSON').option('-g, --global', 'List globally installed skills').option('-a, --agent <agent>', 'List skills installed to a specific agent').action((options)=>{
+    const agentInput = options.agent;
+    if (void 0 !== agentInput && !isValidAgentType(agentInput)) {
+        logger_logger.error(`Invalid agent: ${agentInput}`);
+        process.exit(1);
+    }
+    const agent = agentInput;
+    // claude-cowork-3p is always global
+    const isGlobal = options.global || agent === claude_3p_installer_CLAUDE_COWORK_3P_AGENT;
     const skillManager = new SkillManager(void 0, {
         global: isGlobal
     });
-    const skills = skillManager.list();
+    const skills = skillManager.list(agent ? {
+        agent
+    } : void 0);
     if (0 === skills.length) {
-        const location = isGlobal ? 'globally' : 'in this project';
+        const location = agent ? `for ${getAgentConfig(agent).displayName}` : isGlobal ? 'globally' : 'in this project';
         logger_logger.info(`No skills installed ${location}`);
         return;
     }
@@ -8169,7 +8313,7 @@ const DEFAULT_INSTALL_DIR = '.skills';
         console.log(JSON.stringify(skills, null, 2));
         return;
     }
-    const scopeLabel = isGlobal ? 'global' : 'project';
+    const scopeLabel = agent ? getAgentConfig(agent).displayName : isGlobal ? 'global' : 'project';
     logger_logger.log(`Installed Skills (${scopeLabel}):`);
     logger_logger.newline();
     const headers = [

package/dist/core/registry-client.d.ts

@@ -110,6 +110,17 @@ export declare class RegistryClient {
      * @returns Base URL for API calls, e.g., 'https://example.com/api'
      */
     private getApiBase;
+    /**
+     * Wrap `fetch()` to convert undici's generic `TypeError: fetch failed`
+     * (raised on DNS / TCP / TLS / connect-timeout errors) into a
+     * {@link RegistryError} that surfaces the underlying `cause` code and
+     * the (sanitized) URL. Without this, users only see `fetch failed`,
+     * which is not actionable for support triage.
+     *
+     * HTTP-level errors (non-2xx responses) are NOT touched here — call sites
+     * still handle them as before.
+     */
+    private safeFetch;
     /**
      * Get authorization headers
      */

package/dist/core/registry-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry-client.d.ts","sourceRoot":"","sources":["../../src/core/registry-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry-client.d.ts","sourceRoot":"","sources":["../../src/core/registry-client.ts"],"names":[],"mappings":"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"}

package/dist/core/skill-manager.d.ts

@@ -41,6 +41,14 @@ export declare class SkillManager {
      * Check if in global mode
      */
     isGlobalMode(): boolean;
+    /**
+     * Determine if the installation is effectively global.
+     *
+     * Claude Cowork 3P always installs to a global app-managed directory regardless
+     * of the isGlobal flag. When all target agents are claude-cowork-3p, the
+     * installation should be treated as global (skip skills.json/skills.lock writes).
+     */
+    private isEffectivelyGlobal;
     /**
      * Get project root directory
      */
@@ -154,9 +162,16 @@ export declare class SkillManager {
     /**
      * List installed skills
      *
-     * Checks both canonical (.agents/skills/) and legacy (.skills/) locations.
+     * When `agent` is specified, lists skills installed to that specific agent.
+     * Otherwise checks both canonical (.agents/skills/) and legacy (.skills/) locations.
+     */
+    list(options?: {
+        agent?: AgentType;
+    }): InstalledSkill[];
+    /**
+     * List skills installed to a specific agent
      */
-    list(): InstalledSkill[];
+    private listByAgent;
     /**
      * Detect which agents have a skill installed (symlink or copy)
      *

package/dist/core/skill-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/core/skill-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/core/skill-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAIf,MAAM,mBAAmB,CAAC;AAoB3B,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAU;gBAEd,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAkB/D;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKrC;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;OAKG;IACH,aAAa,IAAI,MAAM;IAOvB;;;;;;OAMG;IACH,qBAAqB,IAAI,MAAM;IAM/B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA0BlC;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAQjF;;OAEG;YACW,cAAc;IAwF5B;;OAEG;YACW,eAAe;IAwF7B;;OAEG;IACG,UAAU,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAsBzE;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IA2BhC;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAY7D;;OAEG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAmEtD;;;;;;;;;OASG;YACW,kBAAkB;IA8BhC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAWpC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;OAGG;YACW,gBAAgB;IAS9B;;;;;OAKG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,GAAG,cAAc,EAAE;IAiFvD;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBnB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAwBjC;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAgBtD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG;QACrB,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;QACjC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;KAC5B;IAQD;;OAEG;IACG,aAAa,IAAI,OAAO,CAC5B,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC,CACH;IAmED;;;;;;;;;;OAUG;IACG,iBAAiB,CACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC;IA6CjF;;;;;;OAMG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,SAAS,EAAE,EACzB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC;QACT,KAAK,EAAE,cAAc,CAAC;QACtB,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;KACxC,CAAC;IAYF;;;;;;;;OAQG;IACG,qBAAqB,CACzB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,SAAS,EAAE,EACzB,OAAO,GAAE,cAAc,GAAG;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GACpD,OAAO,CACN;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,mBAAmB,EAAE,CAAA;KAAE,GACjD;QACE,QAAQ,EAAE,KAAK,CAAC;QAChB,SAAS,EAAE,KAAK,CAAC;YACf,KAAK,EAAE,cAAc,CAAC;YACtB,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;SACxC,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClD,CACJ;IA0HD;;OAEG;YACW,sBAAsB;IAiGpC;;OAEG;YACW,uBAAuB;IAiGrC;;;;;;;OAOG;YACW,2BAA2B;IAqLzC;;;;;;;;OAQG;YACW,uBAAuB;IA4ErC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,0BAA0B;IAyBlC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;OAKG;YACW,wBAAwB;IA2FtC;;;;;;;OAOG;IACG,sBAAsB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAWpD;;OAEG;IACH,qBAAqB,IAAI,WAAW;IAQpC;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IAenF;;OAEG;IACH,gBAAgB,IAAI,SAAS,EAAE;IAI/B;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC;CA0BtF;AAED,eAAe,YAAY,CAAC"}

package/dist/index.js

@@ -3804,6 +3804,65 @@ const SNIPPET_MAX_LENGTH = 120;
     }
 }
 // ============================================================================
+// Internal helpers
+// ============================================================================
+/**
+ * Extract a human-readable reason from an error thrown by `fetch()`.
+ *
+ * Node's undici throws a generic `TypeError: fetch failed` and stashes the
+ * real reason in `error.cause`. The chain can be deeper than one level —
+ * e.g. through a corporate proxy:
+ *   TypeError: fetch failed
+ *     → DOMException { message: 'Request was cancelled' }
+ *         → RequestAbortedError { code: 'UND_ERR_ABORTED', message: 'aborted' }
+ *
+ * Walk the `cause` chain and prefer the deepest entry that carries a `code`,
+ * since that's the actionable bit for triage. Falls back to the deepest
+ * available `message`, then to the outermost error's message.
+ *
+ * Produces strings like `UND_ERR_CONNECT_TIMEOUT: Connect Timeout Error`.
+ */ function formatFetchCause(err) {
+    // Cap traversal depth to defend against pathological self-referential chains.
+    const MAX_DEPTH = 8;
+    let bestCode;
+    let bestMessage;
+    let fallbackMessage;
+    const seen = new Set();
+    let current = err;
+    for(let depth = 0; depth < MAX_DEPTH && null != current; depth++){
+        if (seen.has(current)) break;
+        seen.add(current);
+        if ('object' != typeof current) break;
+        const node = current;
+        if ('string' == typeof node.code && node.code) {
+            // Prefer the deepest code, so keep overwriting as we descend.
+            bestCode = node.code;
+            if ('string' == typeof node.message && node.message) bestMessage = node.message;
+        } else if ('string' == typeof node.message && node.message && !fallbackMessage) // Remember the first non-empty message in case no code is ever found.
+        // Skip undici's generic outer wrapper to avoid surfacing "fetch failed".
+        {
+            if ('fetch failed' !== node.message) fallbackMessage = node.message;
+        }
+        current = node.cause;
+    }
+    if (bestCode && bestMessage) return `${bestCode}: ${bestMessage}`;
+    if (bestCode) return bestCode;
+    if (fallbackMessage) return fallbackMessage;
+    return err?.message || String(err);
+}
+/**
+ * Render a URL for inclusion in error messages without leaking the query string.
+ * Signed download URLs put the signature in the query, so we strip it.
+ * Returns `<origin><pathname>`, or `<unknown url>` if parsing fails.
+ */ function describeUrl(rawUrl) {
+    try {
+        const u = new URL(rawUrl);
+        return `${u.origin}${u.pathname}`;
+    } catch  {
+        return '<unknown url>';
+    }
+}
+// ============================================================================
 // RegistryClient Class
 // ============================================================================
 class RegistryClient {
@@ -3822,6 +3881,22 @@ class RegistryClient {
         return `${registry}/api`;
     }
     /**
+   * Wrap `fetch()` to convert undici's generic `TypeError: fetch failed`
+   * (raised on DNS / TCP / TLS / connect-timeout errors) into a
+   * {@link RegistryError} that surfaces the underlying `cause` code and
+   * the (sanitized) URL. Without this, users only see `fetch failed`,
+   * which is not actionable for support triage.
+   *
+   * HTTP-level errors (non-2xx responses) are NOT touched here — call sites
+   * still handle them as before.
+   */ async safeFetch(url, init) {
+        try {
+            return await fetch(url, init);
+        } catch (err) {
+            throw new RegistryError(`Network error contacting ${describeUrl(url)}: ${formatFetchCause(err)}`);
+        }
+    }
+    /**
    * Get authorization headers
    */ getAuthHeaders() {
         const headers = {
@@ -3835,7 +3910,7 @@ class RegistryClient {
    * Get current user info (whoami)
    */ async whoami() {
         const url = `${this.getApiBase()}/skill-auth/me`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3853,7 +3928,7 @@ class RegistryClient {
    * @throws RegistryError if authentication fails
    */ async loginCli() {
         const url = `${this.getApiBase()}/skill-auth/login-cli`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'POST',
             headers: this.getAuthHeaders()
         });
@@ -3909,7 +3984,7 @@ class RegistryClient {
    * @throws RegistryError if skill not found or request failed
    */ async getSkillInfo(skillName) {
         const url = `${this.getApiBase()}/skills/${encodeURIComponent(skillName)}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3944,7 +4019,7 @@ class RegistryClient {
         if (void 0 !== options.limit) params.set('limit', String(options.limit));
         if (void 0 !== options.offset) params.set('offset', String(options.offset));
         const url = `${this.getApiBase()}/skills?${params.toString()}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -3978,7 +4053,7 @@ class RegistryClient {
         if (/^\d+\.\d+\.\d+/.test(version)) return version;
         // Otherwise treat it as a tag and query dist-tags
         const url = `${this.getApiBase()}/skills/${encodeURIComponent(skillName)}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -4016,7 +4091,7 @@ class RegistryClient {
         // Use redirect: 'manual' to capture x-integrity header from 302 responses.
         // The registry returns a 302 redirect to OSS with the integrity header,
         // which would be lost if fetch auto-follows the redirect.
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders(),
             redirect: 'manual'
@@ -4026,7 +4101,7 @@ class RegistryClient {
             const integrity = response.headers.get('x-integrity') || '';
             const location = response.headers.get('location');
             if (!location) throw new RegistryError('Missing redirect location in download response', response.status);
-            const downloadResponse = await fetch(location);
+            const downloadResponse = await this.safeFetch(location);
             if (!downloadResponse.ok) throw new RegistryError(`Download from storage failed: ${downloadResponse.status}`, downloadResponse.status);
             const arrayBuffer = await downloadResponse.arrayBuffer();
             const tarball = Buffer.from(arrayBuffer);
@@ -4126,7 +4201,7 @@ class RegistryClient {
         });
         formData.append('tarball', tarballBlob, `${skillName.replace('/', '-')}.tgz`);
         // Send request
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'POST',
             headers: this.getAuthHeaders(),
             body: formData
@@ -4149,7 +4224,7 @@ class RegistryClient {
             path: groupPath
         });
         const url = `${this.getApiBase()}/skill-groups/resolve?${params.toString()}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -4172,7 +4247,7 @@ class RegistryClient {
         if (options.flat) params.set('flat', 'true');
         const qs = params.toString();
         const url = `${this.getApiBase()}/skill-groups${qs ? `?${qs}` : ''}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -4190,7 +4265,7 @@ class RegistryClient {
    * @returns Created group
    */ async createGroup(input) {
         const url = `${this.getApiBase()}/skill-groups`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'POST',
             headers: {
                 ...this.getAuthHeaders(),
@@ -4215,7 +4290,7 @@ class RegistryClient {
         const params = dryRun ? '?dry_run=true' : '';
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}${params}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'DELETE',
             headers: this.getAuthHeaders()
         });
@@ -4234,7 +4309,7 @@ class RegistryClient {
    */ async listGroupMembers(groupId) {
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}/members`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'GET',
             headers: this.getAuthHeaders()
         });
@@ -4254,7 +4329,7 @@ class RegistryClient {
    */ async addGroupMembers(groupId, userIds, role = 'developer') {
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}/members`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'POST',
             headers: {
                 ...this.getAuthHeaders(),
@@ -4281,7 +4356,7 @@ class RegistryClient {
         });
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}/members?${params.toString()}`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'DELETE',
             headers: this.getAuthHeaders()
         });
@@ -4299,7 +4374,7 @@ class RegistryClient {
    */ async updateGroupMemberRole(groupId, userId, role) {
         const encodedGroupId = encodeURIComponent(groupId);
         const url = `${this.getApiBase()}/skill-groups/${encodedGroupId}/members`;
-        const response = await fetch(url, {
+        const response = await this.safeFetch(url, {
             method: 'PATCH',
             headers: {
                 ...this.getAuthHeaders(),
@@ -4698,6 +4773,16 @@ class RegistryResolver {
         return this.isGlobal;
     }
     /**
+   * Determine if the installation is effectively global.
+   *
+   * Claude Cowork 3P always installs to a global app-managed directory regardless
+   * of the isGlobal flag. When all target agents are claude-cowork-3p, the
+   * installation should be treated as global (skip skills.json/skills.lock writes).
+   */ isEffectivelyGlobal(targetAgents) {
+        if (this.isGlobal) return true;
+        return targetAgents.length > 0 && targetAgents.every((a)=>a === CLAUDE_COWORK_3P_AGENT);
+    }
+    /**
    * Get project root directory
    */ getProjectRoot() {
         return this.projectRoot;
@@ -5107,8 +5192,10 @@ class RegistryResolver {
     /**
    * List installed skills
    *
-   * Checks both canonical (.agents/skills/) and legacy (.skills/) locations.
-   */ list() {
+   * When `agent` is specified, lists skills installed to that specific agent.
+   * Otherwise checks both canonical (.agents/skills/) and legacy (.skills/) locations.
+   */ list(options) {
+        if (options?.agent) return this.listByAgent(options.agent);
         const skills = [];
         const seenNames = new Set();
         // Check canonical location first (.agents/skills/)
@@ -5142,6 +5229,38 @@ class RegistryResolver {
                 seenNames.add(name);
             }
         }
+        // In global mode, also include claude-cowork-3p skills (always global)
+        if (this.isGlobal) try {
+            for (const name of listClaude3pSkills()){
+                if (seenNames.has(name)) continue;
+                const skillPath = getClaude3pSkillPath(name);
+                const skill = this.getInstalledSkillFromPath(name, skillPath);
+                if (skill) {
+                    skills.push(skill);
+                    seenNames.add(name);
+                }
+            }
+        } catch  {
+        // Claude Cowork 3P not configured or accessible — skip silently
+        }
+        return skills;
+    }
+    /**
+   * List skills installed to a specific agent
+   */ listByAgent(agent) {
+        const installer = new Installer({
+            cwd: this.projectRoot,
+            global: this.isGlobal
+        });
+        const skillNames = installer.listInstalledSkills(agent);
+        const skills = [];
+        for (const name of skillNames)try {
+            const skillPath = installer.getAgentSkillPath(name, agent);
+            const skill = this.getInstalledSkillFromPath(name, skillPath);
+            if (skill) skills.push(skill);
+        } catch  {
+        // Skip skills whose paths cannot be resolved (e.g. claude-3p not configured)
+        }
         return skills;
     }
     /**
@@ -5395,14 +5514,15 @@ class RegistryResolver {
             const results = await installer.installToAgents(skillInfo.dirPath, skillInfo.name, targetAgents, {
                 mode: mode
             });
-            if (!this.isGlobal) this.lockManager.lockSkill(skillInfo.name, {
+            const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+            if (!effectivelyGlobal) this.lockManager.lockSkill(skillInfo.name, {
                 source: skillSource,
                 version: semanticVersion,
                 ref: gitRef,
                 resolved: repoUrl,
                 commit: cacheResult.commit
             });
-            if (!this.isGlobal && save) {
+            if (!effectivelyGlobal && save) {
                 this.config.ensureExists();
                 this.config.addSkill(skillInfo.name, `${baseRefForSave}#${skillInfo.name}`);
             }
@@ -5460,8 +5580,9 @@ class RegistryResolver {
         const results = await installer.installToAgents(sourcePath, skillName, targetAgents, {
             mode: mode
         });
-        // Update lock file (project mode only)
-        if (!this.isGlobal) {
+        // Update lock file (project mode only, skip for effectively-global installs)
+        const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+        if (!effectivelyGlobal) {
             const lockSource = registryContext?.lockSource ?? `${parsed.registry}:${parsed.owner}/${parsed.repo}${parsed.subPath ? `/${parsed.subPath}` : ''}`;
             this.lockManager.lockSkill(skillName, {
                 source: lockSource,
@@ -5472,8 +5593,8 @@ class RegistryResolver {
                 registry: registryContext?.registryUrl
             });
         }
-        // Update skills.json (project mode only)
-        if (!this.isGlobal && save) {
+        // Update skills.json (project mode only, skip for effectively-global installs)
+        if (!effectivelyGlobal && save) {
             this.config.ensureExists();
             const configRef = registryContext?.configRef ?? this.config.normalizeSkillRef(ref);
             this.config.addSkill(skillName, configRef);
@@ -5531,8 +5652,9 @@ class RegistryResolver {
         const results = await installer.installToAgents(sourcePath, skillName, targetAgents, {
             mode: mode
         });
-        // Update lock file (project mode only)
-        if (!this.isGlobal) {
+        // Update lock file (project mode only, skip for effectively-global installs)
+        const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+        if (!effectivelyGlobal) {
             const lockSource = registryContext?.lockSource ?? `http:${httpInfo.host}/${skillName}`;
             this.lockManager.lockSkill(skillName, {
                 source: lockSource,
@@ -5543,8 +5665,8 @@ class RegistryResolver {
                 registry: registryContext?.registryUrl
             });
         }
-        // Update skills.json (project mode only)
-        if (!this.isGlobal && save) {
+        // Update skills.json (project mode only, skip for effectively-global installs)
+        if (!effectivelyGlobal && save) {
             this.config.ensureExists();
             const configRef = registryContext?.configRef ?? ref;
             this.config.addSkill(skillName, configRef);
@@ -5664,8 +5786,9 @@ class RegistryResolver {
             const results = await installer.installToAgents(extractedPath, shortName, targetAgents, {
                 mode: mode
             });
-            // 7. Update lock file (project mode only)
-            if (!this.isGlobal) this.lockManager.lockSkill(shortName, {
+            // 7. Update lock file (project mode only, skip for effectively-global installs)
+            const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+            if (!effectivelyGlobal) this.lockManager.lockSkill(shortName, {
                 source: `registry:${resolvedParsed.fullName}`,
                 version,
                 ref: version,
@@ -5673,8 +5796,8 @@ class RegistryResolver {
                 commit: resolved.integrity,
                 registry: resolvedRegistryUrl
             });
-            // 8. Update skills.json (project mode only)
-            if (!this.isGlobal && save) {
+            // 8. Update skills.json (project mode only, skip for effectively-global installs)
+            if (!effectivelyGlobal && save) {
                 this.config.ensureExists();
                 // Save with full name for registry skills
                 this.config.addSkill(shortName, ref);
@@ -5740,7 +5863,8 @@ class RegistryResolver {
             registryContext
         };
         // Save custom registry to skills.json.registries (for reinstall without lock file)
-        if (!this.isGlobal && options.registry) {
+        const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+        if (!effectivelyGlobal && options.registry) {
             const registryName = this.deriveRegistryName(options.registry);
             if (registryName) {
                 this.config.ensureExists();
@@ -5843,8 +5967,9 @@ class RegistryResolver {
             const metadata = this.getSkillMetadataFromDir(extractedPath);
             const skillName = metadata?.name ?? shortName;
             const semanticVersion = metadata?.version ?? version;
-            // Update lock file (project mode only)
-            if (!this.isGlobal) this.lockManager.lockSkill(skillName, {
+            // Update lock file (project mode only, skip for effectively-global installs)
+            const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+            if (!effectivelyGlobal) this.lockManager.lockSkill(skillName, {
                 source: `registry:${parsed.fullName}`,
                 version: semanticVersion,
                 ref: version,
@@ -5852,8 +5977,8 @@ class RegistryResolver {
                 commit: '',
                 registry: registryUrl
             });
-            // Update skills.json (project mode only)
-            if (!this.isGlobal && save) {
+            // Update skills.json (project mode only, skip for effectively-global installs)
+            if (!effectivelyGlobal && save) {
                 this.config.ensureExists();
                 this.config.addSkill(skillName, parsed.fullName);
                 // Save custom registry to skills.json.registries (for reinstall without lock file)
@@ -5927,10 +6052,11 @@ class RegistryResolver {
             installDir: defaults.installDir
         });
         const results = installer.uninstallFromAgents(name, targetAgents);
-        // Remove from lock file (project mode only)
-        if (!this.isGlobal) this.lockManager.remove(name);
-        // Remove from skills.json (project mode only)
-        if (!this.isGlobal && this.config.exists()) this.config.removeSkill(name);
+        // Remove from lock file (project mode only, skip for effectively-global installs)
+        const effectivelyGlobal = this.isEffectivelyGlobal(targetAgents);
+        if (!effectivelyGlobal) this.lockManager.remove(name);
+        // Remove from skills.json (project mode only, skip for effectively-global installs)
+        if (!effectivelyGlobal && this.config.exists()) this.config.removeSkill(name);
         const successCount = Array.from(results.values()).filter((r)=>r).length;
         logger_logger.success(`Uninstalled ${name} from ${successCount} agent(s)`);
         return results;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reskill",
-  "version": "1.21.0",
+  "version": "1.22.1",
   "description": "AI Skills Package Manager - Git-based skills management for AI agents",
   "type": "module",
   "main": "./dist/index.js",