reskill 0.11.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/dist/cli/commands/index.d.ts +3 -3
  2. package/dist/cli/commands/index.d.ts.map +1 -1
  3. package/dist/cli/commands/info.d.ts +1 -1
  4. package/dist/cli/commands/init.d.ts +1 -1
  5. package/dist/cli/commands/install.d.ts +11 -11
  6. package/dist/cli/commands/install.d.ts.map +1 -1
  7. package/dist/cli/commands/list.d.ts +1 -1
  8. package/dist/cli/commands/list.d.ts.map +1 -1
  9. package/dist/cli/commands/outdated.d.ts +1 -1
  10. package/dist/cli/commands/outdated.d.ts.map +1 -1
  11. package/dist/cli/commands/uninstall.d.ts +1 -1
  12. package/dist/cli/commands/update.d.ts +1 -1
  13. package/dist/cli/index.js +668 -634
  14. package/dist/core/agent-registry.d.ts +16 -16
  15. package/dist/core/agent-registry.d.ts.map +1 -1
  16. package/dist/core/cache-manager.d.ts +17 -17
  17. package/dist/core/cache-manager.d.ts.map +1 -1
  18. package/dist/core/config-loader.d.ts +18 -18
  19. package/dist/core/config-loader.d.ts.map +1 -1
  20. package/dist/core/git-resolver.d.ts +23 -23
  21. package/dist/core/git-resolver.d.ts.map +1 -1
  22. package/dist/core/index.d.ts +8 -8
  23. package/dist/core/index.d.ts.map +1 -1
  24. package/dist/core/installer.d.ts +30 -30
  25. package/dist/core/installer.d.ts.map +1 -1
  26. package/dist/core/lock-manager.d.ts +17 -17
  27. package/dist/core/lock-manager.d.ts.map +1 -1
  28. package/dist/core/skill-manager.d.ts +57 -39
  29. package/dist/core/skill-manager.d.ts.map +1 -1
  30. package/dist/core/skill-parser.d.ts +43 -43
  31. package/dist/core/skill-parser.d.ts.map +1 -1
  32. package/dist/index.d.ts +3 -3
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js +615 -581
  35. package/dist/types/index.d.ts +84 -84
  36. package/dist/types/index.d.ts.map +1 -1
  37. package/dist/utils/fs.d.ts +7 -7
  38. package/dist/utils/fs.d.ts.map +1 -1
  39. package/package.json +18 -12
@@ -1,23 +1,23 @@
1
1
  import type { InstalledSkill, InstallOptions } from '../types/index.js';
2
- import { LockManager } from './lock-manager.js';
3
- import { type InstallResult, type InstallMode } from './installer.js';
4
2
  import { type AgentType } from './agent-registry.js';
3
+ import { type InstallMode, type InstallResult } from './installer.js';
4
+ import { LockManager } from './lock-manager.js';
5
5
  /**
6
- * SkillManager 配置选项
6
+ * SkillManager configuration options
7
7
  */
8
8
  export interface SkillManagerOptions {
9
- /** 全局模式,安装到 ~/.claude/skills */
9
+ /** Global mode, install to ~/.claude/skills */
10
10
  global?: boolean;
11
11
  }
12
12
  /**
13
- * SkillManager - 核心 Skill 管理类
13
+ * SkillManager - Core Skill management class
14
14
  *
15
- * 整合 GitResolver, CacheManager, ConfigLoader, LockManager
16
- * 提供完整的 skill 安装、更新、卸载功能
15
+ * Integrates GitResolver, CacheManager, ConfigLoader, LockManager
16
+ * Provides complete skill installation, update, and uninstall functionality
17
17
  *
18
- * 安装目录:
19
- * - 项目模式 (默认): .skills/ skills.json 中配置的目录
20
- * - 全局模式 (-g): ~/.claude/skills/
18
+ * Installation directories:
19
+ * - Project mode (default): .skills/ or directory configured in skills.json
20
+ * - Global mode (-g): ~/.claude/skills/
21
21
  */
22
22
  export declare class SkillManager {
23
23
  private projectRoot;
@@ -28,58 +28,76 @@ export declare class SkillManager {
28
28
  private isGlobal;
29
29
  constructor(projectRoot?: string, options?: SkillManagerOptions);
30
30
  /**
31
- * 是否为全局模式
31
+ * Check if in global mode
32
32
  */
33
33
  isGlobalMode(): boolean;
34
34
  /**
35
- * 获取项目根目录
35
+ * Get project root directory
36
36
  */
37
37
  getProjectRoot(): string;
38
38
  /**
39
- * 获取安装目录
39
+ * Get legacy installation directory (for backward compatibility)
40
40
  *
41
- * - 全局模式: ~/.claude/skills/
42
- * - 项目模式: .skills/ skills.json 中配置的目录
41
+ * - Global mode: ~/.claude/skills/
42
+ * - Project mode: .skills/ or directory configured in skills.json
43
43
  */
44
44
  getInstallDir(): string;
45
45
  /**
46
- * 获取 skill 安装路径
46
+ * Get canonical skills directory
47
+ *
48
+ * This is the primary storage location used by installToAgents().
49
+ * - Project mode: .agents/skills/
50
+ * - Global mode: ~/.agents/skills/
51
+ */
52
+ getCanonicalSkillsDir(): string;
53
+ /**
54
+ * Get skill installation path
55
+ *
56
+ * Checks canonical location first, then falls back to legacy location.
47
57
  */
48
58
  getSkillPath(name: string): string;
49
59
  /**
50
- * 安装 skill
60
+ * Install skill
51
61
  */
52
62
  install(ref: string, options?: InstallOptions): Promise<InstalledSkill>;
53
63
  /**
54
- * 安装所有 skills.json 中的 skills
64
+ * Install all skills from skills.json
55
65
  */
56
66
  installAll(options?: InstallOptions): Promise<InstalledSkill[]>;
57
67
  /**
58
- * 卸载 skill
68
+ * Uninstall skill
59
69
  */
60
70
  uninstall(name: string): boolean;
61
71
  /**
62
- * 更新 skill
72
+ * Update skill
63
73
  */
64
74
  update(name?: string): Promise<InstalledSkill[]>;
65
75
  /**
66
- * 链接本地 skill
76
+ * Link local skill for development
67
77
  */
68
78
  link(localPath: string, name?: string): InstalledSkill;
69
79
  /**
70
- * 取消链接
80
+ * Unlink a linked skill
71
81
  */
72
82
  unlink(name: string): boolean;
73
83
  /**
74
- * 列出已安装的 skills
84
+ * List installed skills
85
+ *
86
+ * Checks both canonical (.agents/skills/) and legacy (.skills/) locations.
75
87
  */
76
88
  list(): InstalledSkill[];
77
89
  /**
78
- * 获取已安装的 skill 信息
90
+ * Get installed skill information from a specific path
91
+ */
92
+ private getInstalledSkillFromPath;
93
+ /**
94
+ * Get installed skill information
95
+ *
96
+ * Checks canonical location first, then legacy location.
79
97
  */
80
98
  getInstalledSkill(name: string): InstalledSkill | null;
81
99
  /**
82
- * 获取 skill 详情
100
+ * Get skill details
83
101
  */
84
102
  getInfo(name: string): {
85
103
  installed: InstalledSkill | null;
@@ -87,7 +105,7 @@ export declare class SkillManager {
87
105
  config: string | undefined;
88
106
  };
89
107
  /**
90
- * 检查过期的 skills
108
+ * Check for outdated skills
91
109
  */
92
110
  checkOutdated(): Promise<Array<{
93
111
  name: string;
@@ -96,42 +114,42 @@ export declare class SkillManager {
96
114
  updateAvailable: boolean;
97
115
  }>>;
98
116
  /**
99
- * 安装 skill 到多个 agents
117
+ * Install skill to multiple agents
100
118
  *
101
- * @param ref - Skill 引用 ( github:user/repo@v1.0.0)
102
- * @param targetAgents - 目标 agents 列表
103
- * @param options - 安装选项
119
+ * @param ref - Skill reference (e.g., github:user/repo@v1.0.0)
120
+ * @param targetAgents - Target agents list
121
+ * @param options - Installation options
104
122
  */
105
123
  installToAgents(ref: string, targetAgents: AgentType[], options?: InstallOptions): Promise<{
106
124
  skill: InstalledSkill;
107
125
  results: Map<AgentType, InstallResult>;
108
126
  }>;
109
127
  /**
110
- * 获取默认的目标 agents
128
+ * Get default target agents
111
129
  *
112
- * 优先级:
113
- * 1. skills.json 中的 defaults.targetAgents
114
- * 2. 自动检测已安装的 agents
115
- * 3. 返回空数组
130
+ * Priority:
131
+ * 1. defaults.targetAgents in skills.json
132
+ * 2. Auto-detect installed agents
133
+ * 3. Return empty array
116
134
  */
117
135
  getDefaultTargetAgents(): Promise<AgentType[]>;
118
136
  /**
119
- * 获取默认安装模式
137
+ * Get default installation mode
120
138
  */
121
139
  getDefaultInstallMode(): InstallMode;
122
140
  /**
123
- * 验证 agent 类型列表
141
+ * Validate agent type list
124
142
  */
125
143
  validateAgentTypes(agentNames: string[]): {
126
144
  valid: AgentType[];
127
145
  invalid: string[];
128
146
  };
129
147
  /**
130
- * 获取所有可用的 agent 类型
148
+ * Get all available agent types
131
149
  */
132
150
  getAllAgentTypes(): AgentType[];
133
151
  /**
134
- * 从指定 agents 卸载 skill
152
+ * Uninstall skill from specified agents
135
153
  */
136
154
  uninstallFromAgents(name: string, targetAgents: AgentType[]): Map<AgentType, boolean>;
137
155
  }
@@ -1 +1 @@
1
- {"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/core/skill-manager.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/core/skill-manager.ts"],"names":[],"mappings":"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"}
@@ -1,106 +1,106 @@
1
1
  /**
2
- * Skill Parser - SKILL.md 解析器
2
+ * Skill Parser - SKILL.md parser
3
3
  *
4
- * 遵循 agentskills.io 规范: https://agentskills.io/specification
4
+ * Following agentskills.io specification: https://agentskills.io/specification
5
5
  *
6
- * SKILL.md 格式要求:
7
- * - YAML frontmatter 包含 name description (必填)
8
- * - name: 最多 64 字符,小写字母、数字、连字符
9
- * - description: 最多 1024 字符
10
- * - 可选字段: license, compatibility, metadata, allowed-tools
6
+ * SKILL.md format requirements:
7
+ * - YAML frontmatter containing name and description (required)
8
+ * - name: max 64 characters, lowercase letters, numbers, hyphens
9
+ * - description: max 1024 characters
10
+ * - Optional fields: license, compatibility, metadata, allowed-tools
11
11
  */
12
12
  /**
13
- * SKILL.md frontmatter 原始数据
13
+ * SKILL.md frontmatter raw data
14
14
  */
15
15
  export interface SkillMdFrontmatter {
16
- /** Skill 名称 (必填) - 小写字母、数字、连字符 */
16
+ /** Skill name (required) - lowercase letters, numbers, hyphens */
17
17
  name: string;
18
- /** Skill 描述 (必填) */
18
+ /** Skill description (required) */
19
19
  description: string;
20
- /** 许可证 */
20
+ /** License */
21
21
  license?: string;
22
- /** 兼容性要求 */
22
+ /** Compatibility requirements */
23
23
  compatibility?: string;
24
- /** 额外元数据 */
24
+ /** Additional metadata */
25
25
  metadata?: Record<string, unknown>;
26
- /** 允许使用的工具列表 (空格分隔) */
26
+ /** List of allowed tools (space separated) */
27
27
  'allowed-tools'?: string;
28
28
  }
29
29
  /**
30
- * 解析后的 Skill 信息
30
+ * Parsed Skill information
31
31
  */
32
32
  export interface ParsedSkill {
33
- /** Skill 名称 */
33
+ /** Skill name */
34
34
  name: string;
35
- /** Skill 描述 */
35
+ /** Skill description */
36
36
  description: string;
37
- /** 许可证 */
37
+ /** License */
38
38
  license?: string;
39
- /** 兼容性要求 */
39
+ /** Compatibility requirements */
40
40
  compatibility?: string;
41
- /** 额外元数据 */
41
+ /** Additional metadata */
42
42
  metadata?: Record<string, unknown>;
43
- /** 允许使用的工具列表 */
43
+ /** List of allowed tools */
44
44
  allowedTools?: string[];
45
- /** Markdown 内容 (不含 frontmatter) */
45
+ /** Markdown content (without frontmatter) */
46
46
  content: string;
47
- /** 原始完整内容 */
47
+ /** Original full content */
48
48
  rawContent: string;
49
49
  }
50
50
  /**
51
- * Skill 验证错误
51
+ * Skill validation error
52
52
  */
53
53
  export declare class SkillValidationError extends Error {
54
54
  field?: string | undefined;
55
55
  constructor(message: string, field?: string | undefined);
56
56
  }
57
57
  /**
58
- * 验证 skill name 格式
58
+ * Validate skill name format
59
59
  *
60
- * 规范要求:
61
- * - 最多 64 字符
62
- * - 只能包含小写字母、数字、连字符
63
- * - 不能以连字符开头或结尾
64
- * - 不能包含连续连字符
60
+ * Specification requirements:
61
+ * - Max 64 characters
62
+ * - Only lowercase letters, numbers, hyphens allowed
63
+ * - Cannot start or end with hyphen
64
+ * - Cannot contain consecutive hyphens
65
65
  */
66
66
  export declare function validateSkillName(name: string): void;
67
67
  /**
68
- * 验证 skill description
68
+ * Validate skill description
69
69
  *
70
- * 规范要求:
71
- * - 最多 1024 字符
72
- * - 不能包含尖括号
70
+ * Specification requirements:
71
+ * - Max 1024 characters
72
+ * - Cannot contain angle brackets
73
73
  */
74
74
  export declare function validateSkillDescription(description: string): void;
75
75
  /**
76
- * 解析 SKILL.md 内容
76
+ * Parse SKILL.md content
77
77
  *
78
- * @param content - SKILL.md 文件内容
79
- * @param options - 解析选项
80
- * @returns 解析后的 skill 信息,如果格式无效则返回 null
81
- * @throws SkillValidationError 如果 strict 模式下验证失败
78
+ * @param content - SKILL.md file content
79
+ * @param options - Parse options
80
+ * @returns Parsed skill info, or null if format is invalid
81
+ * @throws SkillValidationError if validation fails in strict mode
82
82
  */
83
83
  export declare function parseSkillMd(content: string, options?: {
84
84
  strict?: boolean;
85
85
  }): ParsedSkill | null;
86
86
  /**
87
- * 从文件路径解析 SKILL.md
87
+ * Parse SKILL.md from file path
88
88
  */
89
89
  export declare function parseSkillMdFile(filePath: string, options?: {
90
90
  strict?: boolean;
91
91
  }): ParsedSkill | null;
92
92
  /**
93
- * skill 目录解析 SKILL.md
93
+ * Parse SKILL.md from skill directory
94
94
  */
95
95
  export declare function parseSkillFromDir(dirPath: string, options?: {
96
96
  strict?: boolean;
97
97
  }): ParsedSkill | null;
98
98
  /**
99
- * 检查目录是否包含有效的 SKILL.md
99
+ * Check if directory contains valid SKILL.md
100
100
  */
101
101
  export declare function hasValidSkillMd(dirPath: string): boolean;
102
102
  /**
103
- * 生成 SKILL.md 内容
103
+ * Generate SKILL.md content
104
104
  */
105
105
  export declare function generateSkillMd(skill: Omit<ParsedSkill, 'rawContent'>): string;
106
106
  declare const _default: {
@@ -1 +1 @@
1
- {"version":3,"file":"skill-parser.d.ts","sourceRoot":"","sources":["../../src/core/skill-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gBAAgB;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAGpC,KAAK,CAAC,EAAE,MAAM;gBADrB,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA;CAKxB;AAqGD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA+CpD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAqBlE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,WAAW,GAAG,IAAI,CAmDpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,WAAW,GAAG,IAAI,CAUpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,WAAW,GAAG,IAAI,CAGpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAYxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,GACrC,MAAM,CAsBR;;;;;;;;;;AAED,wBAQE"}
1
+ {"version":3,"file":"skill-parser.d.ts","sourceRoot":"","sources":["../../src/core/skill-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAGpC,KAAK,CAAC,EAAE,MAAM;gBADrB,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA;CAKxB;AAqGD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAsCpD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAkBlE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,WAAW,GAAG,IAAI,CAiDpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,WAAW,GAAG,IAAI,CAUpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,WAAW,GAAG,IAAI,CAGpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAYxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG,MAAM,CAsB9E;;;;;;;;;;AAED,wBAQE"}
package/dist/index.d.ts CHANGED
@@ -4,8 +4,8 @@
4
4
  * Git-based skills management for AI agents
5
5
  * Supports 17+ coding agents: Cursor, Claude Code, GitHub Copilot, etc.
6
6
  */
7
- export { GitResolver, CacheManager, ConfigLoader, LockManager, SkillManager, DEFAULT_REGISTRIES, agents, detectInstalledAgents, getAgentConfig, getAllAgentTypes, isValidAgentType, getAgentSkillsDir, Installer, parseSkillMd, parseSkillMdFile, parseSkillFromDir, hasValidSkillMd, validateSkillName, validateSkillDescription, generateSkillMd, SkillValidationError, } from './core/index.js';
8
- export type { SkillsJson, SkillsLock, SkillJson, LockedSkill, ParsedSkillRef, ParsedVersion, VersionType, InstalledSkill, InstallOptions, UpdateOptions, ListOptions, AgentType, AgentConfig, InstallMode, InstallResult, SkillMdFrontmatter, ParsedSkill, } from './types/index.js';
7
+ export { agents, CacheManager, ConfigLoader, DEFAULT_REGISTRIES, detectInstalledAgents, GitResolver, generateSkillMd, getAgentConfig, getAgentSkillsDir, getAllAgentTypes, hasValidSkillMd, Installer, isValidAgentType, LockManager, parseSkillFromDir, parseSkillMd, parseSkillMdFile, SkillManager, SkillValidationError, validateSkillDescription, validateSkillName, } from './core/index.js';
8
+ export type { AgentConfig, AgentType, InstalledSkill, InstallMode, InstallOptions, InstallResult, ListOptions, LockedSkill, ParsedSkill, ParsedSkillRef, ParsedVersion, SkillJson, SkillMdFrontmatter, SkillsJson, SkillsLock, UpdateOptions, VersionType, } from './types/index.js';
9
+ export { getCanonicalSkillPath, getCanonicalSkillsDir, isPathSafe, sanitizeName, shortenPath, } from './utils/fs.js';
9
10
  export { logger } from './utils/index.js';
10
- export { getCanonicalSkillsDir, getCanonicalSkillPath, shortenPath, isPathSafe, sanitizeName, } from './utils/fs.js';
11
11
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,kBAAkB,EAElB,MAAM,EACN,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EAET,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EAEX,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,YAAY,GACb,MAAM,eAAe,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EAEjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,WAAW,EAEX,SAAS,EACT,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}