reskill 1.18.1 → 1.19.0

package/README.md

@@ -65,22 +65,22 @@ npx reskill@latest <command>  # Or use npx directly
 
 ### Common Options
 
-| Option                    | Commands                                      | Description                                                   |
-| ------------------------- | --------------------------------------------- | ------------------------------------------------------------- |
-| `--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`)        |
-| `--mode <mode>`           | `install`                                     | Installation mode: `symlink` (default) or `copy`             |
-| `--all`                   | `install`                                     | Install to all agents                                         |
-| `-y, --yes`               | `install`, `uninstall`, `publish`             | Skip confirmation prompts                                     |
-| `-f, --force`             | `install`                                     | Force reinstall even if already installed                     |
-| `-s, --skill <names...>`  | `install`                                     | Select specific skill(s) by name from a multi-skill repo     |
-| `--list`                  | `install`                                     | List available skills in the repository without installing    |
-| `-t, --token <token>`     | `install`                                     | Auth token for registry API requests (for CI/CD)             |
-| `-r, --registry <url>`    | `install`, `group`, `publish`                 | Registry URL override for registry-enabled commands           |
-| `-j, --json`              | `list`, `info`, `outdated`, `doctor`, `group` | Output as JSON                                                |
-| `-l, --limit <n>`         | `find`                                        | Maximum number of search results                              |
-| `--skip-network`          | `doctor`                                      | Skip network connectivity checks                              |
+| Option                    | Commands                                                      | Description                                                   |
+| ------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- |
+| `--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`)         |
+| `--mode <mode>`           | `install`                                                     | Installation mode: `symlink` (default) or `copy`              |
+| `--all`                   | `install`                                                     | Install to all agents                                          |
+| `-y, --yes`               | `install`, `uninstall`, `publish`                             | Skip confirmation prompts                                      |
+| `-f, --force`             | `install`                                                     | Force reinstall even if already installed                      |
+| `-s, --skill <names...>`  | `install`                                                     | Select specific skill(s) by name from a multi-skill repo      |
+| `--list`                  | `install`                                                     | List available skills in the repository without installing     |
+| `-t, --token <token>`     | `install`, `find`, `group`, `publish`, `login`                | Auth token for registry API requests (for CI/CD)               |
+| `-r, --registry <url>`    | `install`, `find`, `group`, `publish`, `login`, `logout`, `whoami` | Registry URL override for registry-enabled commands       |
+| `-j, --json`              | `list`, `info`, `outdated`, `doctor`, `group`, `find`         | Output as JSON                                                 |
+| `-l, --limit <n>`         | `find`                                                        | Maximum number of search results                               |
+| `--skip-network`          | `doctor`                                                      | Skip network connectivity checks                              |
 
 Run `reskill <command> --help` for complete options and detailed usage.
 
@@ -222,14 +222,25 @@ git config --global url."https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.company.
 
 Skills are installed to `.skills/` by default and can be integrated with any agent:
 
-| Agent          | Path                                  |
-| -------------- | ------------------------------------- |
-| Cursor         | `.cursor/rules/` or `.cursor/skills/` |
-| Claude Code    | `.claude/skills/`                     |
-| Codex          | `.codex/skills/`                      |
-| Windsurf       | `.windsurf/skills/`                   |
-| GitHub Copilot | `.github/skills/`                     |
-| OpenCode       | `.opencode/skills/`                   |
+| Agent          | Path               |
+| -------------- | ------------------ |
+| Amp            | `.agents/skills`   |
+| Antigravity    | `.agent/skills`    |
+| Claude Code    | `.claude/skills`   |
+| Clawdbot       | `skills`           |
+| Codex          | `.codex/skills`    |
+| Cursor         | `.cursor/skills`   |
+| Droid          | `.factory/skills`  |
+| Gemini CLI     | `.gemini/skills`   |
+| GitHub Copilot | `.github/skills`   |
+| Goose          | `.goose/skills`    |
+| Kilo Code      | `.kilocode/skills` |
+| Kiro CLI       | `.kiro/skills`     |
+| Neovate        | `.neovate/skills`  |
+| OpenCode       | `.opencode/skills` |
+| Roo Code       | `.roo/skills`      |
+| Trae           | `.trae/skills`     |
+| Windsurf       | `.windsurf/skills` |
 
 ## Publishing Skills
 

package/README.zh-CN.md

@@ -65,22 +65,22 @@ npx reskill@latest <command>  # 或直接使用 npx
 
 ### 常用选项
 
-| 选项                      | 适用命令                                      | 说明                                         |
-| ------------------------- | --------------------------------------------- | -------------------------------------------- |
-| `--no-save`               | `install`                                     | 安装时不保存到 `skills.json`（用于个人技能） |
-| `-g, --global`            | `install`, `uninstall`, `list`                | 全局安装/管理技能（用户目录）                |
-| `-a, --agent <agents...>` | `install`                                     | 指定目标 Agent（如 `cursor`, `claude-code`） |
-| `--mode <mode>`           | `install`                                     | 安装模式：`symlink`（默认）或 `copy`         |
-| `--all`                   | `install`                                     | 安装到所有 Agent                             |
-| `-y, --yes`               | `install`, `uninstall`, `publish`             | 跳过确认提示                                 |
-| `-f, --force`             | `install`                                     | 强制重新安装                                 |
-| `-s, --skill <names...>`  | `install`                                     | 从多 skill 仓库中选择指定 skill              |
-| `--list`                  | `install`                                     | 列出仓库中可用的 skills（不安装）            |
-| `-t, --token <token>`     | `install`                                     | 认证令牌（用于 CI/CD 访问私有 skill）        |
-| `-r, --registry <url>`    | `install`, `group`, `publish`                 | 覆盖 registry URL（用于 registry 相关命令）  |
-| `-j, --json`              | `list`, `info`, `outdated`, `doctor`, `group` | JSON 格式输出                                |
-| `-l, --limit <n>`         | `find`                                        | 限制搜索结果数量                             |
-| `--skip-network`          | `doctor`                                      | 跳过网络连通性检查                           |
+| 选项                      | 适用命令                                                      | 说明                                         |
+| ------------------------- | ------------------------------------------------------------- | -------------------------------------------- |
+| `--no-save`               | `install`                                                     | 安装时不保存到 `skills.json`（用于个人技能） |
+| `-g, --global`            | `install`, `uninstall`, `list`                                | 全局安装/管理技能（用户目录）                |
+| `-a, --agent <agents...>` | `install`                                                     | 指定目标 Agent（如 `cursor`, `claude-code`） |
+| `--mode <mode>`           | `install`                                                     | 安装模式：`symlink`（默认）或 `copy`         |
+| `--all`                   | `install`                                                     | 安装到所有 Agent                             |
+| `-y, --yes`               | `install`, `uninstall`, `publish`                             | 跳过确认提示                                 |
+| `-f, --force`             | `install`                                                     | 强制重新安装                                 |
+| `-s, --skill <names...>`  | `install`                                                     | 从多 skill 仓库中选择指定 skill              |
+| `--list`                  | `install`                                                     | 列出仓库中可用的 skills（不安装）            |
+| `-t, --token <token>`     | `install`, `find`, `group`, `publish`, `login`                | 认证令牌（用于 CI/CD 访问私有 skill）        |
+| `-r, --registry <url>`    | `install`, `find`, `group`, `publish`, `login`, `logout`, `whoami` | 覆盖 registry URL（用于 registry 相关命令）  |
+| `-j, --json`              | `list`, `info`, `outdated`, `doctor`, `group`, `find`         | JSON 格式输出                                |
+| `-l, --limit <n>`         | `find`                                                        | 限制搜索结果数量                             |
+| `--skip-network`          | `doctor`                                                      | 跳过网络连通性检查                           |
 
 运行 `reskill <command> --help` 查看完整选项和详细用法。
 
@@ -222,14 +222,25 @@ git config --global url."https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.company.
 
 Skills 默认安装到 `.skills/`，可与任何 Agent 集成：
 
-| Agent          | 路径                                  |
-| -------------- | ------------------------------------- |
-| Cursor         | `.cursor/rules/` 或 `.cursor/skills/` |
-| Claude Code    | `.claude/skills/`                     |
-| Codex          | `.codex/skills/`                      |
-| Windsurf       | `.windsurf/skills/`                   |
-| GitHub Copilot | `.github/skills/`                     |
-| OpenCode       | `.opencode/skills/`                   |
+| Agent          | 路径               |
+| -------------- | ------------------ |
+| Amp            | `.agents/skills`   |
+| Antigravity    | `.agent/skills`    |
+| Claude Code    | `.claude/skills`   |
+| Clawdbot       | `skills`           |
+| Codex          | `.codex/skills`    |
+| Cursor         | `.cursor/skills`   |
+| Droid          | `.factory/skills`  |
+| Gemini CLI     | `.gemini/skills`   |
+| GitHub Copilot | `.github/skills`   |
+| Goose          | `.goose/skills`    |
+| Kilo Code      | `.kilocode/skills` |
+| Kiro CLI       | `.kiro/skills`     |
+| Neovate        | `.neovate/skills`  |
+| OpenCode       | `.opencode/skills` |
+| Roo Code       | `.roo/skills`      |
+| Trae           | `.trae/skills`     |
+| Windsurf       | `.windsurf/skills` |
 
 ## 发布 Skills
 

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

@@ -1 +1 @@
-{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/group.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgfpC,eAAO,MAAM,YAAY,SAA0D,CAAC;AAqCpF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/group.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0fpC,eAAO,MAAM,YAAY,SAA0D,CAAC;AAyCpF,eAAe,YAAY,CAAC"}

package/dist/cli/index.js

@@ -6717,13 +6717,18 @@ function assertValidGroupPath(path) {
 // ============================================================================
 // Client Factory
 // ============================================================================
-function createClient(registry) {
+function createClient(registry, cliToken) {
+    // --token flag takes highest priority
+    if (cliToken) return new RegistryClient({
+        registry,
+        token: cliToken
+    });
     const authManager = new AuthManager();
     const token = authManager.getToken(registry);
     if (!token) {
         logger_logger.error('Authentication required');
         logger_logger.newline();
-        logger_logger.log("Run 'reskill login' to authenticate.");
+        logger_logger.log("Run 'reskill login' to authenticate, or pass --token <token>.");
         process.exit(1);
     }
     return new RegistryClient({
@@ -6821,7 +6826,7 @@ function displayMemberList(members, groupPath, json) {
 // ============================================================================
 async function listAction(options) {
     const registry = resolveRegistry(options.registry);
-    const client = createClient(registry);
+    const client = createClient(registry, options.token);
     try {
         const groups = await client.listGroups({
             flat: Boolean(options.tree)
@@ -6848,7 +6853,7 @@ async function createAction(name, options) {
     if (options.parent) {
         const normalizedParent = normalizeGroupPath(options.parent);
         assertValidGroupPath(normalizedParent);
-        client = createClient(registry);
+        client = createClient(registry, options.token);
         try {
             const parentGroup = await client.resolveGroup(normalizedParent);
             parentId = parentGroup.id;
@@ -6859,7 +6864,7 @@ async function createAction(name, options) {
         }
     }
     try {
-        const ensuredClient = client ?? createClient(registry);
+        const ensuredClient = client ?? createClient(registry, options.token);
         const group = await ensuredClient.createGroup({
             name,
             slug,
@@ -6884,7 +6889,7 @@ async function infoAction(groupPath, options) {
     const normalized = normalizeGroupPath(groupPath);
     assertValidGroupPath(normalized);
     const registry = resolveRegistry(options.registry);
-    const client = createClient(registry);
+    const client = createClient(registry, options.token);
     try {
         const detail = await client.resolveGroup(normalized);
         displayGroupDetail(detail, options.json || false);
@@ -6900,7 +6905,7 @@ async function deleteAction(groupPath, options) {
     const normalized = normalizeGroupPath(groupPath);
     assertValidGroupPath(normalized);
     const registry = resolveRegistry(options.registry);
-    const client = createClient(registry);
+    const client = createClient(registry, options.token);
     try {
         const detail = await client.resolveGroup(normalized);
         if (options.dryRun) {
@@ -6945,7 +6950,7 @@ async function memberListAction(groupPath, options) {
     const normalized = normalizeGroupPath(groupPath);
     assertValidGroupPath(normalized);
     const registry = resolveRegistry(options.registry);
-    const client = createClient(registry);
+    const client = createClient(registry, options.token);
     try {
         const detail = await client.resolveGroup(normalized);
         const members = await client.listGroupMembers(detail.id);
@@ -6959,7 +6964,7 @@ async function memberAddAction(groupPath, userIds, options) {
     const normalized = normalizeGroupPath(groupPath);
     assertValidGroupPath(normalized);
     const registry = resolveRegistry(options.registry);
-    const client = createClient(registry);
+    const client = createClient(registry, options.token);
     const role = options.role || 'developer';
     if (!validateRole(role)) {
         logger_logger.error(`Invalid role "${role}". Must be one of: ${VALID_ROLES.join(', ')}`);
@@ -6978,7 +6983,7 @@ async function memberRemoveAction(groupPath, userId, options) {
     const normalized = normalizeGroupPath(groupPath);
     assertValidGroupPath(normalized);
     const registry = resolveRegistry(options.registry);
-    const client = createClient(registry);
+    const client = createClient(registry, options.token);
     try {
         const detail = await client.resolveGroup(normalized);
         await client.removeGroupMember(detail.id, userId);
@@ -6992,7 +6997,7 @@ async function memberRoleAction(groupPath, userId, role, options) {
     const normalized = normalizeGroupPath(groupPath);
     assertValidGroupPath(normalized);
     const registry = resolveRegistry(options.registry);
-    const client = createClient(registry);
+    const client = createClient(registry, options.token);
     if (!validateRole(role)) {
         logger_logger.error(`Invalid role "${role}". Must be one of: ${VALID_ROLES.join(', ')}`);
         process.exit(1);
@@ -7010,15 +7015,15 @@ async function memberRoleAction(groupPath, userId, role, options) {
 // Command Definitions
 // ============================================================================
 const memberCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('member').description('Manage group members');
-memberCommand.command('list <path>').description('List members of a group').option('-r, --registry <url>', 'Registry URL').option('-j, --json', 'Output as JSON').action(memberListAction);
-memberCommand.command('add <path> <users...>').description('Add members to a group').option('-r, --registry <url>', 'Registry URL').option('--role <role>', 'Role to assign (owner|maintainer|developer)', 'developer').action(memberAddAction);
-memberCommand.command('remove <path> <user>').description('Remove a member from a group').option('-r, --registry <url>', 'Registry URL').action(memberRemoveAction);
-memberCommand.command('role <path> <user> <role>').description("Change a member's role").option('-r, --registry <url>', 'Registry URL').action(memberRoleAction);
+memberCommand.command('list <path>').description('List members of a group').option('-r, --registry <url>', 'Registry URL').option('-t, --token <token>', 'Auth token for registry API requests (for CI/CD)').option('-j, --json', 'Output as JSON').action(memberListAction);
+memberCommand.command('add <path> <users...>').description('Add members to a group').option('-r, --registry <url>', 'Registry URL').option('-t, --token <token>', 'Auth token for registry API requests (for CI/CD)').option('--role <role>', 'Role to assign (owner|maintainer|developer)', 'developer').action(memberAddAction);
+memberCommand.command('remove <path> <user>').description('Remove a member from a group').option('-r, --registry <url>', 'Registry URL').option('-t, --token <token>', 'Auth token for registry API requests (for CI/CD)').action(memberRemoveAction);
+memberCommand.command('role <path> <user> <role>').description("Change a member's role").option('-r, --registry <url>', 'Registry URL').option('-t, --token <token>', 'Auth token for registry API requests (for CI/CD)').action(memberRoleAction);
 const groupCommand = new __WEBPACK_EXTERNAL_MODULE_commander__.Command('group').description('Manage skill groups');
-groupCommand.command('list').description('List visible groups').option('-r, --registry <url>', 'Registry URL').option('--tree', 'Render groups as a tree (requests flat group list)').option('-j, --json', 'Output as JSON').action(listAction);
-groupCommand.command('create <name>').description('Create a new group').option('-r, --registry <url>', 'Registry URL').option('-d, --description <text>', 'Group description').option('--visibility <level>', 'Visibility: public or private', 'public').option('--parent <path>', 'Parent group path (for sub groups)').option('-j, --json', 'Output as JSON').action(createAction);
-groupCommand.command('info <path>').description('Show group details').option('-r, --registry <url>', 'Registry URL').option('-j, --json', 'Output as JSON').action(infoAction);
-groupCommand.command('delete <path>').description('Delete a group').option('-r, --registry <url>', 'Registry URL').option('-n, --dry-run', 'Preview deletion without executing').option('-y, --yes', 'Skip confirmation').action(deleteAction);
+groupCommand.command('list').description('List visible groups').option('-r, --registry <url>', 'Registry URL').option('-t, --token <token>', 'Auth token for registry API requests (for CI/CD)').option('--tree', 'Render groups as a tree (requests flat group list)').option('-j, --json', 'Output as JSON').action(listAction);
+groupCommand.command('create <name>').description('Create a new group').option('-r, --registry <url>', 'Registry URL').option('-t, --token <token>', 'Auth token for registry API requests (for CI/CD)').option('-d, --description <text>', 'Group description').option('--visibility <level>', 'Visibility: public or private', 'public').option('--parent <path>', 'Parent group path (for sub groups)').option('-j, --json', 'Output as JSON').action(createAction);
+groupCommand.command('info <path>').description('Show group details').option('-r, --registry <url>', 'Registry URL').option('-t, --token <token>', 'Auth token for registry API requests (for CI/CD)').option('-j, --json', 'Output as JSON').action(infoAction);
+groupCommand.command('delete <path>').description('Delete a group').option('-r, --registry <url>', 'Registry URL').option('-t, --token <token>', 'Auth token for registry API requests (for CI/CD)').option('-n, --dry-run', 'Preview deletion without executing').option('-y, --yes', 'Skip confirmation').action(deleteAction);
 groupCommand.addCommand(memberCommand);
 /**
  * info command - Show skill details

package/package.json

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