reskill 1.13.0 → 1.15.0

package/README.md

@@ -117,7 +117,7 @@ npx reskill@latest install github:user/skill1 github:user/skill2@v1.0.0
 
 ### Monorepo Support
 
-For repositories containing multiple skills (monorepo), specify the path to the skill directory:
+For repositories containing multiple skills (monorepo), you can install a specific skill by path or install all skills from a parent directory:
 
 ```bash
 # Shorthand format with subpath
@@ -130,9 +130,12 @@ npx reskill@latest install git@gitlab.company.com:team/skills.git/backend/apis@v
 
 # GitHub web URL automatically extracts subpath
 npx reskill@latest install https://github.com/org/monorepo/tree/main/skills/planning
+
+# Point to a parent directory — auto-detects and installs all child skills
+npx reskill@latest install https://github.com/org/monorepo/tree/main/skills
 ```
 
-**Requirements**: The specified directory must contain a valid `SKILL.md` file following the [Agent Skills Specification](https://agentskills.io).
+When the target directory has no root `SKILL.md` but contains subdirectories with `SKILL.md` files, reskill automatically discovers and installs all child skills. Each skill is saved separately in `skills.json`.
 
 ### HTTP/OSS URL Support
 

package/README.zh-CN.md

@@ -117,7 +117,7 @@ npx reskill@latest install github:user/skill1 github:user/skill2@v1.0.0
 
 ### Monorepo 支持
 
-对于包含多个技能的仓库（monorepo），可以指定技能目录的路径：
+对于包含多个技能的仓库（monorepo），可以指定技能目录的路径安装单个技能，也可以指向父目录一键安装所有技能：
 
 ```bash
 # 简写格式带子路径
@@ -130,9 +130,12 @@ npx reskill@latest install git@gitlab.company.com:team/skills.git/backend/apis@v
 
 # GitHub 网页 URL 自动提取子路径
 npx reskill@latest install https://github.com/org/monorepo/tree/main/skills/planning
+
+# 指向父目录 — 自动发现并安装所有子技能
+npx reskill@latest install https://github.com/org/monorepo/tree/main/skills
 ```
 
-**要求**：指定的目录必须包含符合 [Agent Skills 规范](https://agentskills.io) 的有效 `SKILL.md` 文件。
+当目标目录没有根 `SKILL.md` 但包含带有 `SKILL.md` 的子目录时，reskill 会自动发现并安装所有子技能。每个技能会分别保存到 `skills.json` 中。
 
 ### HTTP/OSS URL 支持
 

package/dist/cli/commands/doctor.d.ts

@@ -49,6 +49,21 @@ export declare function checkGitVersion(): CheckResult;
  * Check Git authentication
  */
 export declare function checkGitAuth(): CheckResult;
+/**
+ * Check registry authentication status
+ *
+ * Verifies actual token availability, not just file existence.
+ * Uses AuthManager.getToken() which checks RESKILL_TOKEN env first,
+ * then reads ~/.reskillrc for the configured registry.
+ */
+export declare function checkAuthStatus(): CheckResult;
+/**
+ * Check environment variables used by reskill
+ *
+ * Security: Only report variable names, never values.
+ * RESKILL_TOKEN contains a secret and must not be displayed.
+ */
+export declare function checkEnvVars(): CheckResult;
 /**
  * Check cache directory
  */
@@ -65,6 +80,14 @@ export declare function checkRegistryConflicts(cwd: string): CheckResult[];
  * Check for dangerous installDir configuration
  */
 export declare function checkInstallDir(cwd: string): CheckResult | null;
+/**
+ * Check for invalid installMode configuration
+ */
+export declare function checkInstallMode(cwd: string): CheckResult | null;
+/**
+ * Check for invalid publishRegistry configuration
+ */
+export declare function checkPublishRegistry(cwd: string): CheckResult | null;
 /**
  * Check for invalid targetAgents configuration
  */
@@ -95,6 +118,17 @@ export interface SkillIssue {
  * Only checks for SKILL.md since that's the sole source of metadata
  */
 export declare function checkInstalledSkills(cwd: string): CheckResult[];
+/**
+ * Check detected agents
+ */
+export declare function checkDetectedAgents(): Promise<CheckResult>;
+/**
+ * Get custom registry URLs for network checks
+ *
+ * Reads registries from skills.json and publishRegistry,
+ * excluding built-in github.com/gitlab.com and deduplicating.
+ */
+export declare function getCustomRegistryUrls(cwd: string): string[];
 /**
  * Check network connectivity
  */

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CASzD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,CAAC,CAuBtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAmB9C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAqB7C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,WAAW,CAiD1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,WAAW,CAmB3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CA4BxD;AAwCD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CA2BjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAwC/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CA2B5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAoDzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAkEhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAsExD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;CAC5B;AAmBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CA2E/D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoCrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAUrD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA4CzB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,SAgDtB,CAAC;AAEL,eAAe,aAAa,CAAC"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"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"}

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;AA6yBpC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,SA8GvB,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;AAs5BpC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,SA8GvB,CAAC;AAEL,eAAe,cAAc,CAAC"}

package/dist/cli/index.js

@@ -4338,6 +4338,54 @@ class RegistryResolver {
     // Multi-Agent installation methods
     // ============================================================================
     /**
+   * Detect whether a ref points to a single skill or a multi-skill directory.
+   *
+   * Returns `{ type: 'single' }` when the cached root contains a SKILL.md (or
+   * when the source is registry/HTTP — those are always single-skill).
+   * Returns `{ type: 'multi', skills }` when the root has **no** SKILL.md but
+   * `discoverSkillsInDir()` finds child skills underneath.
+   *
+   * The method caches the repo as a side-effect so that the subsequent
+   * `installToAgents` / `installSkillsFromRepo` call hits the cache.
+   */ async detectSkillsInRef(ref) {
+        // Only Git refs can be multi-skill directories
+        if (this.isRegistrySource(ref) || this.isHttpSource(ref)) return {
+            type: 'single'
+        };
+        const resolved = await this.resolver.resolve(ref);
+        const { parsed } = resolved;
+        const gitRef = resolved.ref;
+        // Ensure the repo is cached (result unused — we only need the side-effect)
+        if (!await this.cache.get(parsed, gitRef)) await this.cache.cache(resolved.repoUrl, parsed, gitRef, gitRef);
+        const cachePath = this.cache.getCachePath(parsed, gitRef);
+        // When parsed.skillName is set (ref has #fragment), resolve to the
+        // specific skill subdirectory so we check the right SKILL.md.
+        const sourcePath = this.resolveSourcePath(cachePath, parsed);
+        const metadata = this.getSkillMetadataFromDir(sourcePath);
+        if (metadata) return {
+            type: 'single'
+        };
+        // No SKILL.md at root — check for child skills.
+        // cachePath is correct here (not sourcePath) for two reasons:
+        // 1. When parsed.skillName is set, resolveSourcePath() either returns a
+        //    subdirectory (→ metadata found → already returned 'single' above) or
+        //    throws (skill not found). So we never reach this line with
+        //    sourcePath ≠ cachePath.
+        // 2. When parsed.subPath is set, CacheManager.cache() already copies only
+        //    the subPath subdirectory into cachePath, so discovery is scoped to
+        //    the intended directory automatically.
+        const discovered = discoverSkillsInDir(cachePath);
+        if (discovered.length > 0) return {
+            type: 'multi',
+            skills: discovered
+        };
+        // No skills found at all. Return 'single' so the caller proceeds to
+        // installToAgents, which will produce a clear error ("no SKILL.md found").
+        return {
+            type: 'single'
+        };
+    }
+    /**
    * Install skill to multiple agents
    *
    * @param ref - Skill reference (e.g., github:user/repo@v1.0.0 or HTTP URL)
@@ -5189,6 +5237,133 @@ class RegistryResolver {
     }
     return false;
 }
+/**
+ * AuthManager - Handle authentication token management
+ *
+ * Manages tokens for registry authentication.
+ * Tokens are stored in ~/.reskillrc or via RESKILL_TOKEN environment variable.
+ */ // ============================================================================
+// Constants
+// ============================================================================
+const CONFIG_FILE_NAME = '.reskillrc';
+// ============================================================================
+// AuthManager Class
+// ============================================================================
+class AuthManager {
+    configPath;
+    constructor(){
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        this.configPath = __WEBPACK_EXTERNAL_MODULE_node_path__.join(home, CONFIG_FILE_NAME);
+    }
+    /**
+   * Get the default registry URL from environment variable
+   *
+   * Returns undefined if no registry is configured - there is no hardcoded default
+   * to prevent accidental publishing to unintended registries.
+   */ getDefaultRegistry() {
+        return process.env.RESKILL_REGISTRY;
+    }
+    /**
+   * Get path to config file
+   */ getConfigPath() {
+        return this.configPath;
+    }
+    /**
+   * Get token for a registry
+   *
+   * Priority:
+   * 1. RESKILL_TOKEN environment variable
+   * 2. Token from ~/.reskillrc for the specified registry
+   */ getToken(registry) {
+        // Check environment variable first
+        const envToken = process.env.RESKILL_TOKEN;
+        if (envToken) return envToken;
+        // Read from config file
+        const config = this.readConfig();
+        if (!config?.registries) return;
+        const targetRegistry = registry || this.getDefaultRegistry();
+        if (!targetRegistry) return;
+        const auth = config.registries[targetRegistry];
+        return auth?.token;
+    }
+    /**
+   * Check if token exists for a registry
+   */ hasToken(registry) {
+        return void 0 !== this.getToken(registry);
+    }
+    /**
+   * Get email for a registry
+   */ getEmail(registry) {
+        const config = this.readConfig();
+        if (!config?.registries) return;
+        const targetRegistry = registry || this.getDefaultRegistry();
+        if (!targetRegistry) return;
+        const auth = config.registries[targetRegistry];
+        return auth?.email;
+    }
+    /**
+   * Get handle for a registry
+   */ getHandle(registry) {
+        const config = this.readConfig();
+        if (!config?.registries) return;
+        const targetRegistry = registry || this.getDefaultRegistry();
+        if (!targetRegistry) return;
+        const auth = config.registries[targetRegistry];
+        return auth?.handle;
+    }
+    /**
+   * Set token for a registry
+   *
+   * Note: When no registry is specified and RESKILL_REGISTRY env var is not set,
+   * this method will throw an error. The calling code should ensure a registry
+   * is always provided (either explicitly or via environment variable).
+   */ setToken(token, registry, email, handle) {
+        const config = this.readConfig() || {};
+        const targetRegistry = registry || this.getDefaultRegistry();
+        if (!targetRegistry) throw new Error('No registry specified. Set RESKILL_REGISTRY environment variable or provide registry explicitly.');
+        if (!config.registries) config.registries = {};
+        config.registries[targetRegistry] = {
+            token,
+            ...email && {
+                email
+            },
+            ...handle && {
+                handle
+            }
+        };
+        this.writeConfig(config);
+    }
+    /**
+   * Remove token for a registry
+   */ removeToken(registry) {
+        const config = this.readConfig();
+        if (!config?.registries) return;
+        const targetRegistry = registry || this.getDefaultRegistry();
+        if (!targetRegistry) return;
+        delete config.registries[targetRegistry];
+        this.writeConfig(config);
+    }
+    /**
+   * Read config file
+   */ readConfig() {
+        try {
+            if (!external_node_fs_.existsSync(this.configPath)) return null;
+            const content = external_node_fs_.readFileSync(this.configPath, 'utf-8');
+            if (!content.trim()) return null;
+            return JSON.parse(content);
+        } catch  {
+            return null;
+        }
+    }
+    /**
+   * Write config file
+   */ writeConfig(config) {
+        const content = JSON.stringify(config, null, 2);
+        external_node_fs_.writeFileSync(this.configPath, content, {
+            mode: 384
+        });
+    }
+}
 /**
  * Get status icon
  */ function getStatusIcon(status) {
@@ -5396,6 +5571,73 @@ class RegistryResolver {
         hint: 'For private repos, add SSH key: ssh-keygen -t ed25519'
     };
 }
+/**
+ * Valid install modes
+ *
+ * Must stay in sync with InstallMode type from installer.ts ('symlink' | 'copy').
+ * TypeScript literal union types are erased at runtime, so we maintain this list manually.
+ */ const VALID_INSTALL_MODES = [
+    'symlink',
+    'copy'
+];
+/**
+ * Check registry authentication status
+ *
+ * Verifies actual token availability, not just file existence.
+ * Uses AuthManager.getToken() which checks RESKILL_TOKEN env first,
+ * then reads ~/.reskillrc for the configured registry.
+ */ function checkAuthStatus() {
+    const hasEnvToken = !!process.env.RESKILL_TOKEN;
+    if (hasEnvToken) return {
+        name: 'Registry auth',
+        status: 'ok',
+        message: 'RESKILL_TOKEN set'
+    };
+    // Check if ~/.reskillrc has any valid tokens
+    const authManager = new AuthManager();
+    const configPath = authManager.getConfigPath();
+    if (!(0, external_node_fs_.existsSync)(configPath)) return {
+        name: 'Registry auth',
+        status: 'warn',
+        message: 'no token configured',
+        hint: 'Run: reskill login (needed for publish and private skills)'
+    };
+    // File exists — check if it actually contains a token for any registry
+    const hasToken = authManager.hasToken();
+    if (hasToken) return {
+        name: 'Registry auth',
+        status: 'ok',
+        message: 'token configured via ~/.reskillrc'
+    };
+    return {
+        name: 'Registry auth',
+        status: 'warn',
+        message: '~/.reskillrc exists but no token found for current registry',
+        hint: 'Run: reskill login (needed for publish and private skills)'
+    };
+}
+/**
+ * Check environment variables used by reskill
+ *
+ * Security: Only report variable names, never values.
+ * RESKILL_TOKEN contains a secret and must not be displayed.
+ */ function checkEnvVars() {
+    // Only collect names, never values (RESKILL_TOKEN is a secret)
+    const vars = [];
+    if (process.env.RESKILL_TOKEN) vars.push('RESKILL_TOKEN');
+    if (process.env.RESKILL_REGISTRY) vars.push('RESKILL_REGISTRY');
+    if (process.env.RESKILL_CACHE_DIR) vars.push('RESKILL_CACHE_DIR');
+    if (0 === vars.length) return {
+        name: 'Environment vars',
+        status: 'ok',
+        message: 'none set'
+    };
+    return {
+        name: 'Environment vars',
+        status: 'ok',
+        message: `${vars.join(', ')} set`
+    };
+}
 /**
  * Check cache directory
  */ function checkCacheDir() {
@@ -5487,12 +5729,21 @@ class RegistryResolver {
     try {
         const config = configLoader.load();
         const registries = config.registries || {};
-        for (const name of Object.keys(registries))if (RESERVED_REGISTRIES.includes(name.toLowerCase())) results.push({
-            name: 'Registry conflict',
-            status: 'warn',
-            message: `"${name}" overrides built-in registry`,
-            hint: 'Consider using a different name for custom registries'
-        });
+        for (const [name, url] of Object.entries(registries)){
+            if (RESERVED_REGISTRIES.includes(name.toLowerCase())) results.push({
+                name: 'Registry conflict',
+                status: 'warn',
+                message: `"${name}" overrides built-in registry`,
+                hint: 'Consider using a different name for custom registries'
+            });
+            // Validate URL format
+            if ('string' == typeof url && !/^https?:\/\//.test(url)) results.push({
+                name: 'Invalid registry URL',
+                status: 'error',
+                message: `"${name}": "${url}" is not a valid URL`,
+                hint: 'Registry URLs must start with http:// or https://'
+            });
+        }
     } catch  {
     // Ignore parse errors, handled by checkSkillsJson
     }
@@ -5527,6 +5778,46 @@ class RegistryResolver {
     }
     return null;
 }
+/**
+ * Check for invalid installMode configuration
+ */ function checkInstallMode(cwd) {
+    const configLoader = new ConfigLoader(cwd);
+    if (!configLoader.exists()) return null;
+    try {
+        const defaults = configLoader.getDefaults();
+        const installMode = defaults.installMode;
+        if (!installMode) return null;
+        if (!VALID_INSTALL_MODES.includes(installMode)) return {
+            name: 'Invalid installMode',
+            status: 'error',
+            message: `"${installMode}" is not a valid install mode`,
+            hint: 'Valid values: symlink, copy'
+        };
+    } catch  {
+    // Ignore parse errors
+    }
+    return null;
+}
+/**
+ * Check for invalid publishRegistry configuration
+ */ function checkPublishRegistry(cwd) {
+    const configLoader = new ConfigLoader(cwd);
+    if (!configLoader.exists()) return null;
+    try {
+        const defaults = configLoader.getDefaults();
+        const publishRegistry = defaults.publishRegistry;
+        if (!publishRegistry) return null;
+        if (!/^https?:\/\//.test(publishRegistry)) return {
+            name: 'Invalid publishRegistry',
+            status: 'warn',
+            message: `"${publishRegistry}" is not a valid URL`,
+            hint: 'publishRegistry must start with http:// or https://'
+        };
+    } catch  {
+    // Ignore parse errors
+    }
+    return null;
+}
 /**
  * Check for invalid targetAgents configuration
  */ function checkTargetAgents(cwd) {
@@ -5663,6 +5954,15 @@ class RegistryResolver {
             hint: 'Run: reskill install'
         };
     }
+    // Check lockfile version compatibility before sync check
+    // If version is unsupported, sync results would be meaningless
+    const lockData = lockManager.load();
+    if (lockData.lockfileVersion !== LOCKFILE_VERSION) return {
+        name: 'skills.lock',
+        status: 'warn',
+        message: `unsupported lockfile version: ${lockData.lockfileVersion}`,
+        hint: 'Run: reskill install to regenerate'
+    };
     // Check if lock is in sync with config
     const configSkills = configLoader.getSkills();
     const lockedSkills = lockManager.getAll();
@@ -5773,6 +6073,66 @@ class RegistryResolver {
     }
     return results;
 }
+/**
+ * Check detected agents
+ */ async function checkDetectedAgents() {
+    try {
+        const installed = await detectInstalledAgents();
+        if (0 === installed.length) return {
+            name: 'Detected agents',
+            status: 'ok',
+            message: 'none detected'
+        };
+        return {
+            name: 'Detected agents',
+            status: 'ok',
+            message: `${installed.length} detected: ${installed.join(', ')}`
+        };
+    } catch  {
+        return {
+            name: 'Detected agents',
+            status: 'warn',
+            message: 'detection failed'
+        };
+    }
+}
+/**
+ * Normalize a URL to its origin for comparison.
+ * Handles trailing slashes and case differences (e.g., GITHUB.COM → github.com).
+ */ function normalizeUrlOrigin(url) {
+    try {
+        return new URL(url).origin;
+    } catch  {
+        return url;
+    }
+}
+/**
+ * Get custom registry URLs for network checks
+ *
+ * Reads registries from skills.json and publishRegistry,
+ * excluding built-in github.com/gitlab.com and deduplicating.
+ */ function getCustomRegistryUrls(cwd) {
+    const urls = new Set();
+    const builtinOrigins = new Set(Object.values(DEFAULT_REGISTRIES).map((u)=>normalizeUrlOrigin(u)));
+    try {
+        const configLoader = new ConfigLoader(cwd);
+        if (!configLoader.exists()) return [];
+        // Collect custom registry URLs
+        const config = configLoader.load();
+        const registries = config.registries || {};
+        for (const url of Object.values(registries))if ('string' == typeof url && /^https?:\/\//.test(url) && !builtinOrigins.has(normalizeUrlOrigin(url))) urls.add(url);
+        // Collect publishRegistry
+        const defaults = configLoader.getDefaults();
+        if (defaults.publishRegistry && /^https?:\/\//.test(defaults.publishRegistry)) {
+            if (!builtinOrigins.has(normalizeUrlOrigin(defaults.publishRegistry))) urls.add(defaults.publishRegistry);
+        }
+    } catch  {
+    // Ignore errors
+    }
+    return [
+        ...urls
+    ];
+}
 /**
  * Check network connectivity
  */ async function checkNetwork(host) {
@@ -5819,23 +6179,32 @@ class RegistryResolver {
  */ async function runDoctorChecks(options) {
     const { cwd, packageName, packageVersion, skipNetwork, skipConfigChecks } = options;
     const results = [];
-    // Version checks
+    // Environment checks
     results.push(await checkReskillVersion(packageVersion, packageName));
     results.push(checkNodeVersion());
     results.push(checkGitVersion());
     results.push(checkGitAuth());
+    results.push(checkAuthStatus());
+    results.push(checkEnvVars());
     // Directory checks
     results.push(checkCacheDir());
     results.push(checkSkillsJson(cwd));
     results.push(checkSkillsLock(cwd));
     results.push(...checkInstalledSkills(cwd));
+    results.push(await checkDetectedAgents());
     // Deep config checks (can be skipped for faster checks)
     if (!skipConfigChecks) {
-        // Registry conflicts
+        // Registry conflicts + URL validation
         results.push(...checkRegistryConflicts(cwd));
         // installDir validation
         const installDirCheck = checkInstallDir(cwd);
         if (installDirCheck) results.push(installDirCheck);
+        // installMode validation
+        const installModeCheck = checkInstallMode(cwd);
+        if (installModeCheck) results.push(installModeCheck);
+        // publishRegistry validation
+        const publishRegistryCheck = checkPublishRegistry(cwd);
+        if (publishRegistryCheck) results.push(publishRegistryCheck);
         // targetAgents validation
         results.push(...checkTargetAgents(cwd));
         // Skill reference format validation
@@ -5847,6 +6216,9 @@ class RegistryResolver {
     if (!skipNetwork) {
         results.push(await checkNetwork('https://github.com'));
         results.push(await checkNetwork('https://gitlab.com'));
+        // Custom registry connectivity
+        const customUrls = getCustomRegistryUrls(cwd);
+        for (const url of customUrls)results.push(await checkNetwork(url));
     }
     return results;
 }
@@ -6143,133 +6515,6 @@ const DEFAULT_INSTALL_DIR = '.skills';
     // Display summary (use options.installDir directly since we just set it)
     displayConfigSummary(options.installDir);
 });
-/**
- * AuthManager - Handle authentication token management
- *
- * Manages tokens for registry authentication.
- * Tokens are stored in ~/.reskillrc or via RESKILL_TOKEN environment variable.
- */ // ============================================================================
-// Constants
-// ============================================================================
-const CONFIG_FILE_NAME = '.reskillrc';
-// ============================================================================
-// AuthManager Class
-// ============================================================================
-class AuthManager {
-    configPath;
-    constructor(){
-        const home = process.env.HOME || process.env.USERPROFILE || '';
-        this.configPath = __WEBPACK_EXTERNAL_MODULE_node_path__.join(home, CONFIG_FILE_NAME);
-    }
-    /**
-   * Get the default registry URL from environment variable
-   *
-   * Returns undefined if no registry is configured - there is no hardcoded default
-   * to prevent accidental publishing to unintended registries.
-   */ getDefaultRegistry() {
-        return process.env.RESKILL_REGISTRY;
-    }
-    /**
-   * Get path to config file
-   */ getConfigPath() {
-        return this.configPath;
-    }
-    /**
-   * Get token for a registry
-   *
-   * Priority:
-   * 1. RESKILL_TOKEN environment variable
-   * 2. Token from ~/.reskillrc for the specified registry
-   */ getToken(registry) {
-        // Check environment variable first
-        const envToken = process.env.RESKILL_TOKEN;
-        if (envToken) return envToken;
-        // Read from config file
-        const config = this.readConfig();
-        if (!config?.registries) return;
-        const targetRegistry = registry || this.getDefaultRegistry();
-        if (!targetRegistry) return;
-        const auth = config.registries[targetRegistry];
-        return auth?.token;
-    }
-    /**
-   * Check if token exists for a registry
-   */ hasToken(registry) {
-        return void 0 !== this.getToken(registry);
-    }
-    /**
-   * Get email for a registry
-   */ getEmail(registry) {
-        const config = this.readConfig();
-        if (!config?.registries) return;
-        const targetRegistry = registry || this.getDefaultRegistry();
-        if (!targetRegistry) return;
-        const auth = config.registries[targetRegistry];
-        return auth?.email;
-    }
-    /**
-   * Get handle for a registry
-   */ getHandle(registry) {
-        const config = this.readConfig();
-        if (!config?.registries) return;
-        const targetRegistry = registry || this.getDefaultRegistry();
-        if (!targetRegistry) return;
-        const auth = config.registries[targetRegistry];
-        return auth?.handle;
-    }
-    /**
-   * Set token for a registry
-   *
-   * Note: When no registry is specified and RESKILL_REGISTRY env var is not set,
-   * this method will throw an error. The calling code should ensure a registry
-   * is always provided (either explicitly or via environment variable).
-   */ setToken(token, registry, email, handle) {
-        const config = this.readConfig() || {};
-        const targetRegistry = registry || this.getDefaultRegistry();
-        if (!targetRegistry) throw new Error('No registry specified. Set RESKILL_REGISTRY environment variable or provide registry explicitly.');
-        if (!config.registries) config.registries = {};
-        config.registries[targetRegistry] = {
-            token,
-            ...email && {
-                email
-            },
-            ...handle && {
-                handle
-            }
-        };
-        this.writeConfig(config);
-    }
-    /**
-   * Remove token for a registry
-   */ removeToken(registry) {
-        const config = this.readConfig();
-        if (!config?.registries) return;
-        const targetRegistry = registry || this.getDefaultRegistry();
-        if (!targetRegistry) return;
-        delete config.registries[targetRegistry];
-        this.writeConfig(config);
-    }
-    /**
-   * Read config file
-   */ readConfig() {
-        try {
-            if (!external_node_fs_.existsSync(this.configPath)) return null;
-            const content = external_node_fs_.readFileSync(this.configPath, 'utf-8');
-            if (!content.trim()) return null;
-            return JSON.parse(content);
-        } catch  {
-            return null;
-        }
-    }
-    /**
-   * Write config file
-   */ writeConfig(config) {
-        const content = JSON.stringify(config, null, 2);
-        external_node_fs_.writeFileSync(this.configPath, content, {
-            mode: 384
-        });
-    }
-}
 // ============================================================================
 // Utility Functions
 // ============================================================================
@@ -6540,6 +6785,18 @@ class AuthManager {
     const { skills, options, configLoader, skipConfirm } = ctx;
     const skill = skills[0];
     const cwd = process.cwd();
+    const skillManager = new SkillManager(void 0, {
+        global: installGlobally
+    });
+    // Detect whether the ref points to a multi-skill directory
+    spinner.start('Resolving skill...');
+    const detection = await skillManager.detectSkillsInRef(skill);
+    spinner.stop('Resolved');
+    if ('multi' === detection.type) {
+        await installAutoDetectedMultiSkill(skill, detection.skills, ctx, skillManager, targetAgents, installGlobally, installMode, spinner);
+        return;
+    }
+    // --- Single skill path (existing behaviour) ---
     // Show installation summary
     const summaryLines = [
         __WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan(skill),
@@ -6559,9 +6816,6 @@ class AuthManager {
     }
     // Execute installation
     spinner.start(`Installing ${skill}...`);
-    const skillManager = new SkillManager(void 0, {
-        global: installGlobally
-    });
     const { skill: installed, results } = await skillManager.installToAgents(skill, targetAgents, {
         force: options.force,
         save: false !== options.save && !installGlobally,
@@ -6583,6 +6837,67 @@ class AuthManager {
         });
     }
 }
+/**
+ * Handle auto-detected multi-skill directory: show summary, confirm, install all.
+ *
+ * Called when `detectSkillsInRef` discovers that the ref points to a parent
+ * directory (no SKILL.md at root) containing multiple child skills.
+ */ async function installAutoDetectedMultiSkill(ref, discoveredSkills, ctx, skillManager, targetAgents, installGlobally, installMode, spinner) {
+    const { options, configLoader, skipConfirm } = ctx;
+    const skillNames = discoveredSkills.map((s)=>s.name);
+    // Show discovered skills
+    __WEBPACK_EXTERNAL_MODULE__clack_prompts__.log.step(__WEBPACK_EXTERNAL_MODULE_chalk__["default"].bold(`Found ${discoveredSkills.length} skill(s)`));
+    for (const s of discoveredSkills)__WEBPACK_EXTERNAL_MODULE__clack_prompts__.log.message(`  ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan(s.name)}${s.description ? `  ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim(s.description)}` : ''}`);
+    __WEBPACK_EXTERNAL_MODULE__clack_prompts__.log.message('');
+    // Show installation summary
+    const summaryLines = [
+        __WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan(ref),
+        `  ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim('→')} ${formatAgentNames(targetAgents)}`,
+        `  ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim('Skills:')} ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].cyan(skillNames.join(', '))}`,
+        `  ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim('Scope:')} ${installGlobally ? 'Global' : 'Project'}${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim(', Mode:')} ${installMode}`
+    ];
+    __WEBPACK_EXTERNAL_MODULE__clack_prompts__.note(summaryLines.join('\n'), 'Multi-Skill Install');
+    // Confirm
+    if (!skipConfirm) {
+        const confirmed = await __WEBPACK_EXTERNAL_MODULE__clack_prompts__.confirm({
+            message: 'Install all discovered skills?'
+        });
+        if (__WEBPACK_EXTERNAL_MODULE__clack_prompts__.isCancel(confirmed) || !confirmed) {
+            __WEBPACK_EXTERNAL_MODULE__clack_prompts__.cancel('Installation cancelled');
+            process.exit(0);
+        }
+    }
+    // Install all discovered skills (empty skillNames = install all)
+    spinner.start('Installing skills...');
+    const result = await skillManager.installSkillsFromRepo(ref, [], targetAgents, {
+        force: options.force,
+        save: false !== options.save && !installGlobally,
+        mode: installMode,
+        registry: options.registry,
+        token: options.token
+    });
+    spinner.stop('Installation complete');
+    if (result.listOnly) return;
+    const { installed, skipped } = result;
+    // Display results
+    if (0 === installed.length && skipped.length > 0) {
+        const skipLines = skipped.map((s)=>`  ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim('–')} ${s.name}: ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim(s.reason)}`);
+        __WEBPACK_EXTERNAL_MODULE__clack_prompts__.note(skipLines.join('\n'), __WEBPACK_EXTERNAL_MODULE_chalk__["default"].yellow('All skills were already installed'));
+        __WEBPACK_EXTERNAL_MODULE__clack_prompts__.log.info('Use --force to reinstall.');
+        return;
+    }
+    const resultLines = installed.map((r)=>`  ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].green('✓')} ${r.skill.name}@${r.skill.version}`);
+    if (skipped.length > 0) for (const s of skipped)resultLines.push(`  ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim('–')} ${s.name}: ${__WEBPACK_EXTERNAL_MODULE_chalk__["default"].dim(s.reason)}`);
+    __WEBPACK_EXTERNAL_MODULE__clack_prompts__.note(resultLines.join('\n'), __WEBPACK_EXTERNAL_MODULE_chalk__["default"].green(`Installed ${installed.length} skill(s)`));
+    // Save installation defaults
+    if (!installGlobally && installed.length > 0 && configLoader.exists()) {
+        configLoader.reload();
+        configLoader.updateDefaults({
+            targetAgents,
+            installMode
+        });
+    }
+}
 /**
  * Multi-skill path: list or install selected skills from a single repo (--skill / --list)
  */ async function installMultiSkillFromRepo(ref, skillNames, listOnly, ctx, targetAgents, installGlobally, installMode, spinner) {

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

@@ -1,4 +1,8 @@
 import type { LockedSkill, SkillsLock } from '../types/index.js';
+/**
+ * Current lockfile version
+ */
+export declare const LOCKFILE_VERSION = 1;
 /**
  * LockManager - Manage skills.lock file
  *

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

@@ -1 +1 @@
-{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/core/lock-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQjE;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,IAAI,UAAU;IAsBlB;;OAEG;IACH,MAAM,IAAI,UAAU;IAKpB;;OAEG;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IASnC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAK1C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAM3C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,WAAW;IAmBd;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAKrC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAQtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,MAAM,IAAI,IAAI;CAOf;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/core/lock-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGjE;;GAEG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,WAAW,CAAC,EAAE,MAAM;IAKhC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,IAAI,IAAI,UAAU;IAsBlB;;OAEG;IACH,MAAM,IAAI,UAAU;IAKpB;;OAEG;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI;IASnC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAK1C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAM3C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU7B;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,WAAW;IAmBd;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAKrC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAQtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,MAAM,IAAI,IAAI;CAOf;AAED,eAAe,WAAW,CAAC"}

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

@@ -180,6 +180,23 @@ export declare class SkillManager {
         latest: string;
         updateAvailable: boolean;
     }>>;
+    /**
+     * Detect whether a ref points to a single skill or a multi-skill directory.
+     *
+     * Returns `{ type: 'single' }` when the cached root contains a SKILL.md (or
+     * when the source is registry/HTTP — those are always single-skill).
+     * Returns `{ type: 'multi', skills }` when the root has **no** SKILL.md but
+     * `discoverSkillsInDir()` finds child skills underneath.
+     *
+     * The method caches the repo as a side-effect so that the subsequent
+     * `installToAgents` / `installSkillsFromRepo` call hits the cache.
+     */
+    detectSkillsInRef(ref: string): Promise<{
+        type: 'single';
+    } | {
+        type: 'multi';
+        skills: ParsedSkillWithPath[];
+    }>;
     /**
      * Install skill to multiple agents
      *

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":"AACA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAIf,MAAM,mBAAmB,CAAC;AAmB3B,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,qBAAqB,CAAC;AAK7B,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;CAClB;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;IAc/D;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;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;IA2BhC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;OAGG;YACW,gBAAgB;IAS9B;;;;OAIG;IACH,IAAI,IAAI,cAAc,EAAE;IA0DxB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;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;;;;;;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;IAyHD;;OAEG;YACW,sBAAsB;IAgGpC;;OAEG;YACW,uBAAuB;IAgGrC;;;;;;;OAOG;YACW,2BAA2B;IA6KzC;;;;;;;;OAQG;YACW,uBAAuB;IA2ErC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,0BAA0B;IAyBlC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;OAKG;YACW,wBAAwB;IAwFtC;;;;;;;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;CAyBtF;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/core/skill-manager.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4333,6 +4333,54 @@ class RegistryResolver {
     // Multi-Agent installation methods
     // ============================================================================
     /**
+   * Detect whether a ref points to a single skill or a multi-skill directory.
+   *
+   * Returns `{ type: 'single' }` when the cached root contains a SKILL.md (or
+   * when the source is registry/HTTP — those are always single-skill).
+   * Returns `{ type: 'multi', skills }` when the root has **no** SKILL.md but
+   * `discoverSkillsInDir()` finds child skills underneath.
+   *
+   * The method caches the repo as a side-effect so that the subsequent
+   * `installToAgents` / `installSkillsFromRepo` call hits the cache.
+   */ async detectSkillsInRef(ref) {
+        // Only Git refs can be multi-skill directories
+        if (this.isRegistrySource(ref) || this.isHttpSource(ref)) return {
+            type: 'single'
+        };
+        const resolved = await this.resolver.resolve(ref);
+        const { parsed } = resolved;
+        const gitRef = resolved.ref;
+        // Ensure the repo is cached (result unused — we only need the side-effect)
+        if (!await this.cache.get(parsed, gitRef)) await this.cache.cache(resolved.repoUrl, parsed, gitRef, gitRef);
+        const cachePath = this.cache.getCachePath(parsed, gitRef);
+        // When parsed.skillName is set (ref has #fragment), resolve to the
+        // specific skill subdirectory so we check the right SKILL.md.
+        const sourcePath = this.resolveSourcePath(cachePath, parsed);
+        const metadata = this.getSkillMetadataFromDir(sourcePath);
+        if (metadata) return {
+            type: 'single'
+        };
+        // No SKILL.md at root — check for child skills.
+        // cachePath is correct here (not sourcePath) for two reasons:
+        // 1. When parsed.skillName is set, resolveSourcePath() either returns a
+        //    subdirectory (→ metadata found → already returned 'single' above) or
+        //    throws (skill not found). So we never reach this line with
+        //    sourcePath ≠ cachePath.
+        // 2. When parsed.subPath is set, CacheManager.cache() already copies only
+        //    the subPath subdirectory into cachePath, so discovery is scoped to
+        //    the intended directory automatically.
+        const discovered = discoverSkillsInDir(cachePath);
+        if (discovered.length > 0) return {
+            type: 'multi',
+            skills: discovered
+        };
+        // No skills found at all. Return 'single' so the caller proceeds to
+        // installToAgents, which will produce a clear error ("no SKILL.md found").
+        return {
+            type: 'single'
+        };
+    }
+    /**
    * Install skill to multiple agents
    *
    * @param ref - Skill reference (e.g., github:user/repo@v1.0.0 or HTTP URL)

package/package.json

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