reskill 1.13.0 → 1.14.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/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)
@@ -6540,6 +6588,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 +6619,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 +6640,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/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":"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"}
+{"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.14.0",
   "description": "AI Skills Package Manager - Git-based skills management for AI agents",
   "type": "module",
   "main": "./dist/index.js",