@amonstack/gitea-mcp 0.2.0 → 0.2.2

package/README.md

@@ -18,7 +18,7 @@ The server communicates over stdio and wraps the [Gitea REST API
 
 ## Installation
 
-### From npm
+### From npm (npmjs.com)
 
 ```bash
 npm install -g @amonstack/gitea-mcp
@@ -30,6 +30,16 @@ Or run directly without global install:
 npx @amonstack/gitea-mcp
 ```
 
+### From GitHub Packages
+
+Each release is also published to GitHub Packages. Route the `@amonstack` scope there
+once, then install:
+
+```bash
+echo "@amonstack:registry=https://npm.pkg.github.com" >> ~/.npmrc
+npm install -g @amonstack/gitea-mcp
+```
+
 ### Build from source
 
 ```bash
@@ -97,17 +107,26 @@ Add to your opencode MCP configuration:
 
 If you built from source, use `node /path/to/gitea-mcp/dist/cli.js` instead.
 
-opencode also loads native **skills** — one per action (find, create, update,
-label, summarize, plan milestones, resolve repo) — that teach the assistant the
-safest workflow for that action, including pre-use checks and pitfalls. Install
-them once:
+opencode and other AI tools can load native **skills** — one per action (find,
+create, update, label, comment, summarize, plan milestones, resolve repo) — that
+teach the assistant the safest workflow for that action, including pre-use checks
+and pitfalls. Install them once with the `init` command, targeting your tool
+(`--tool`, default `opencode`):
 
 ```bash
-gitea-mcp skills install            # global (~/.config/opencode/skills/)
-gitea-mcp skills install --project  # this project (./.opencode/skills/)
+gitea-mcp init                      # opencode (global ~/.config/opencode/skills/)
+gitea-mcp init --tool claude        # Claude Code (~/.claude/skills/)
+gitea-mcp init --tool cursor        # Cursor (~/.cursor/skills/)
+gitea-mcp init --project            # this project (./.<tool>/skills/)
+gitea-mcp init --dir /exact/path    # custom location
 ```
 
-Then restart opencode. See [AI Guidance & Skills](#ai-guidance--skills) below.
+Supported `--tool` values: `amazon-q`, `antigravity`, `auggie`, `claude`,
+`cline`, `codex`, `codebuddy`, `continue`, `costrict`, `crush`, `cursor`,
+`factory`, `gemini`, `github-copilot`, `iflow`, `kilocode`, `opencode`, `qoder`,
+`qwen`, `roocode`, `windsurf`. Paths follow each tool's conventional skills
+directory; use `--dir` for an exact location. Then restart your tool. See
+[AI Guidance & Skills](#ai-guidance--skills) below.
 
 ### Other MCP Clients
 
@@ -185,12 +204,12 @@ through three channels:
   `summarize_issue`, `audit_labels`, `milestone_report`) and on-demand reference
   docs (field reference, label guide, tool cookbook) for clients that surface them.
 
-### opencode skills
+### Action skills
 
-For opencode, the server ships a set of **action-scoped skills** — one per
-workflow, so the assistant loads only the guidance it needs (and never, say,
-delete instructions while creating). Install them with the
-`gitea-mcp skills install` command shown in the opencode section above.
+For opencode and other tools, the server ships a set of **action-scoped skills**
+— one per workflow, so the assistant loads only the guidance it needs (and never,
+say, delete instructions while creating). Install them with the
+`gitea-mcp init --tool <name>` command shown above.
 
 | Skill | Invoke when |
 |-------|-------------|
@@ -199,14 +218,17 @@ delete instructions while creating). Install them with the
 | `gitea-update-issue` | editing fields, closing, clearing assignee/milestone |
 | `gitea-label-issue` | adding / replacing / removing / clearing labels on an issue |
 | `gitea-manage-labels` | creating or editing label definitions |
+| `gitea-comment-issue` | posting a comment that advances an issue's discussion |
 | `gitea-summarize-issue` | reading and summarizing an issue's discussion |
 | `gitea-plan-milestones` | creating / editing / closing milestones |
 | `gitea-resolve-repo` | resolving owner/repo or listing repositories |
 
 Each skill is a short, AI-facing action flow (purpose, when to use, when not to,
-rules, and what to check first). Destructive single-tool actions (delete issue /
-comment / label / milestone) are intentionally left to the tool descriptions so
-they never contaminate a creative workflow.
+rules, and what to check first). The create, comment, and milestone skills also
+embed **body templates** (bug / feature / performance issue, comment, milestone)
+that standardize the format of what the assistant writes. Destructive
+single-tool actions (delete issue / comment / label / milestone) are intentionally
+left to the tool descriptions so they never contaminate a creative workflow.
 
 ## Development
 

package/README.zh-CN.md

@@ -17,7 +17,7 @@ opencode、Cursor 等）后，AI 助手即可通过自然语言在 Gitea 实例
 
 ## 安装
 
-### 从 npm 安装
+### 从 npm（npmjs.com）安装
 
 ```bash
 npm install -g @amonstack/gitea-mcp
@@ -29,6 +29,15 @@ npm install -g @amonstack/gitea-mcp
 npx @amonstack/gitea-mcp
 ```
 
+### 从 GitHub Packages 安装
+
+每个版本也会发布到 GitHub Packages。先把 `@amonstack` 作用域指向它，再安装：
+
+```bash
+echo "@amonstack:registry=https://npm.pkg.github.com" >> ~/.npmrc
+npm install -g @amonstack/gitea-mcp
+```
+
 ### 从源码构建
 
 ```bash
@@ -96,16 +105,24 @@ node dist/cli.js
 
 如果从源码构建，将 `command` 改为 `node /path/to/gitea-mcp/dist/cli.js`。
 
-opencode 还会加载原生**技能（skills）**——按动作拆分（查找、创建、更新、打
-标签、总结、规划里程碑、解析仓库等），教会助手针对该动作的最安全工作流，含
-使用前检查与各类陷阱。一次性安装：
+opencode 及其它 AI 工具可加载原生**技能（skills）**——按动作拆分（查找、创建、
+更新、打标签、评论、总结、规划里程碑、解析仓库等），教会助手针对该动作的最安全
+工作流，含使用前检查与各类陷阱。用 `init` 命令一次性安装，并通过 `--tool` 指定
+目标工具（默认 `opencode`）：
 
 ```bash
-gitea-mcp skills install            # 全局（~/.config/opencode/skills/）
-gitea-mcp skills install --project  # 仅当前项目（./.opencode/skills/）
+gitea-mcp init                      # opencode（全局 ~/.config/opencode/skills/）
+gitea-mcp init --tool claude        # Claude Code（~/.claude/skills/）
+gitea-mcp init --tool cursor        # Cursor（~/.cursor/skills/）
+gitea-mcp init --project            # 仅当前项目（./.<tool>/skills/）
+gitea-mcp init --dir /exact/path    # 自定义路径
 ```
 
-然后重启 opencode。详见下方 [AI 引导与技能](#ai-引导与技能)。
+支持的 `--tool` 取值：`amazon-q`、`antigravity`、`auggie`、`claude`、`cline`、
+`codex`、`codebuddy`、`continue`、`costrict`、`crush`、`cursor`、`factory`、
+`gemini`、`github-copilot`、`iflow`、`kilocode`、`opencode`、`qoder`、`qwen`、
+`roocode`、`windsurf`。路径遵循各工具约定的 skills 目录；如需精确位置请用 `--dir`。
+随后重启对应工具。详见下方 [AI 引导与技能](#ai-引导与技能)。
 
 ### 其他 MCP 客户端
 
@@ -182,11 +199,11 @@ gitea-mcp
   `audit_labels`、`milestone_report`）与按需参考文档（字段参考、标签指南、工具
   食谱），供支持的客户端使用。
 
-### opencode 技能
+### 动作技能
 
-对 opencode，服务端内置了一组**按动作划分的技能**——每个工作流一个，助手只
-加载所需指引（避免例如创建时把删除说明一并带入造成幻觉）。用上面 opencode
-小节展示的 `gitea-mcp skills install` 命令安装。
+对 opencode 及其它工具，服务端内置了一组**按动作划分的技能**——每个工作流一
+个，助手只加载所需指引（避免例如创建时把删除说明一并带入造成幻觉）。用上方展示的
+`gitea-mcp init --tool <name>` 命令安装。
 
 | 技能 | 何时触发 |
 |------|----------|
@@ -195,13 +212,15 @@ gitea-mcp
 | `gitea-update-issue` | 编辑字段、关闭、清空负责人/里程碑 |
 | `gitea-label-issue` | 为 issue 增加 / 替换 / 移除 / 清空标签 |
 | `gitea-manage-labels` | 创建或编辑标签定义 |
+| `gitea-comment-issue` | 在 issue 下发表推动讨论的评论 |
 | `gitea-summarize-issue` | 读取并总结某 issue 的讨论 |
 | `gitea-plan-milestones` | 创建 / 编辑 / 关闭里程碑 |
 | `gitea-resolve-repo` | 解析 owner/repo 或列出仓库 |
 
 每个技能都是面向 AI 的简短动作流程（目的、何时用、何时不用、规则、先检查什么）。
-破坏性的单工具操作（删除 issue / 评论 / 标签 / 里程碑）有意仅保留在工具描述里，
-不会污染创建类工作流。
+创建、评论、里程碑三类技能还内嵌**正文模板**（bug / 新功能 / 性能 issue、评论、
+里程碑），用以规范助手所写内容的格式。破坏性的单工具操作（删除 issue / 评论 /
+标签 / 里程碑）有意仅保留在工具描述里，不会污染创建类工作流。
 
 ## 二次开发
 

package/dist/assets/skills/gitea-comment-issue/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: gitea-comment-issue
+description: Invoke to POST a new comment on a Gitea issue or pull request. The flow confirms the issue exists first, then posts. Do NOT invoke to edit or delete a comment (author/admin only, partly destructive — no skill), read or summarize the thread (gitea-summarize-issue), or create/edit the issue itself (gitea-create-issue / gitea-update-issue).
+---
+
+# gitea-comment-issue
+
+Post one new comment that advances an issue's discussion. Tools: `get_issue`, `create_comment`.
+
+## Prerequisites
+- Resolve `owner`+`repo`: pass explicitly, else `GITEA_DEFAULT_OWNER`/`GITEA_DEFAULT_REPO`, else `resolve_repo` (gitea-resolve-repo). Never guess — wrong values post to the wrong place.
+- `index` = the issue `number` (URL #N → N), never the internal `id`.
+
+## Flow
+1. CONFIRM TARGET: `get_issue({ index })` — verify the issue exists and is the one you mean. Do NOT post blind.
+2. POST: `create_comment({ index, body })`.
+
+## create_comment
+- RULES: `body` required, Markdown. The comment APPENDS to the thread — it never edits or replaces prior content. The response carries the comment `id`; retain it only if a follow-up `update_comment` / `delete_comment` is planned.
+- CHECK FIRST: re-read the latest thread (gitea-summarize-issue) so your comment is not redundant or contradicting a newer message.
+- CHECK AFTER: the comment appears with the returned `id`.
+
+## Body template — standardize what you write into `body`
+A useful comment is contextual, evidence-backed, and proposes a next step. Structure `body` with this template; drop sections that add nothing.
+
+```markdown
+**Context:** <the point you are responding to>
+
+**Finding / proposal:** <what you discovered or suggest>
+
+**Evidence:** <log excerpt, link, reproduction, or metric>
+
+**Suggested next step:** <the concrete action you propose>
+```

package/dist/assets/skills/gitea-create-issue/SKILL.md

@@ -11,7 +11,7 @@ Open one new issue after ruling out a duplicate. Tools: `search_issues`, `create
 - Resolve `owner`+`repo`: pass explicitly, else `GITEA_DEFAULT_OWNER`/`GITEA_DEFAULT_REPO`, else `resolve_repo` (gitea-resolve-repo). Never guess — wrong values create the issue in the wrong repo.
 
 ## Flow
-1. DUPLICATE CHECK (always first): `search_issues({ query: "<title keywords>", type: "issues" })`. If a match exists, comment on it (gitea-summarize-issue, then `create_comment`) instead of creating a duplicate. Do NOT skip this — creation does not de-duplicate.
+1. DUPLICATE CHECK (always first): `search_issues({ query: "<title keywords>", type: "issues" })`. If a match exists, comment on it (gitea-comment-issue) instead of creating a duplicate. Do NOT skip this — creation does not de-duplicate.
 2. CREATE: `create_issue({ title, body?, assignees? })`.
 
 ## create_issue
@@ -19,3 +19,46 @@ Open one new issue after ruling out a duplicate. Tools: `search_issues`, `create
 - Do NOT pass `labels` or `milestone` here: `labels` expect IDs (error-prone) and milestone needs an id. Create WITHOUT them, then attach labels by name via `add_issue_labels` (gitea-label-issue) and set the milestone via `update_issue` (gitea-update-issue).
 - CHECK FIRST: confirm no duplicate (step 1) and that `owner`/`repo` are correct before writing.
 - CHECK AFTER: the returned object's `number` is the new issue index.
+
+## Body templates — standardize what you write into `body`
+Always structure `body` with the template matching the issue type. Ask the user which type if it is not obvious. Drop a section only when it is genuinely empty; never invent data. These are GitHub-OSS conventions adapted for the Markdown body that `create_issue` accepts.
+
+### Bug report
+```markdown
+**Summary:** <one-line description of what is wrong>
+
+**Steps to reproduce**
+1. <step>
+2. <step>
+
+**Expected:** <what should happen>
+**Actual:** <what happens instead>
+
+**Environment**
+- gitea-mcp version:
+- Gitea version:
+- Node / runtime:
+- OS:
+```
+
+### Feature request
+```markdown
+**Motivation:** <the problem or need this addresses>
+
+**Proposal:** <what to add or change>
+
+**Alternatives considered:** <other approaches and why they fall short>
+```
+
+### Performance issue
+```markdown
+**Symptom:** <what is slow, or which metric regressed>
+
+**How to reproduce:** <scenario + data size / load>
+
+**Measurements**
+- Before: <baseline metric>
+- After / target: <current or goal metric>
+
+**Suspected bottleneck:** <where the cost seems to come from>
+```

package/dist/assets/skills/gitea-plan-milestones/SKILL.md

@@ -22,3 +22,20 @@ Create / edit / close milestones. Tools: `list_milestones`, `get_milestone`, `cr
 
 ## get_milestone
 - Read one milestone by `id`: includes `open_issues` / `closed_issues` counts for progress (progress = closed / (open + closed)).
+
+## Description template — standardize what you write into `description`
+Milestones succeed when scope is explicit. When creating or editing, structure `description` with this template; keep it short and drop empty sections.
+
+```markdown
+**Goal:** <the single outcome this milestone delivers>
+
+**Scope**
+- In: <what this milestone covers>
+- Out: <what is explicitly deferred>
+
+**Acceptance criteria**
+- <observable, checkable condition>
+- <observable, checkable condition>
+
+**Owners:** <who is accountable>
+```

package/dist/assets/skills/gitea-summarize-issue/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gitea-summarize-issue
-description: Invoke to READ and SUMMARIZE an issue's discussion — the issue body plus its comment thread. Do NOT invoke to create/edit an issue (gitea-create-issue / gitea-update-issue), post or edit a comment (no skill — single tool), or manage labels/milestones.
+description: Invoke to READ and SUMMARIZE an issue's discussion — the issue body plus its comment thread. Do NOT invoke to create/edit an issue (gitea-create-issue / gitea-update-issue), post a comment (gitea-comment-issue), or manage labels/milestones.
 ---
 
 # gitea-summarize-issue

package/dist/cli.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import { runServer } from "./server.js";
 const argv = process.argv.slice(2);
-if (argv[0] === "skills") {
-    // `gitea-mcp skills ...` manages the bundled opencode skill. It needs no Gitea
-    // credentials, so it is dispatched before the env-var guard below.
-    const { runSkillsCommand } = await import("./skills.js");
-    runSkillsCommand(argv.slice(1)).catch((err) => {
+if (argv[0] === "init") {
+    // `gitea-mcp init [--tool <name>]` installs the bundled skills into a target
+    // AI tool's skills directory. It needs no Gitea credentials, so it is
+    // dispatched before the env-var guard below.
+    const { runInitCommand } = await import("./skills.js");
+    runInitCommand(argv.slice(1)).catch((err) => {
         console.error("Fatal error:", err);
         process.exit(1);
     });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;IACzB,+EAA+E;IAC/E,mEAAmE;IACnE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACzD,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5C,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;KAAM,CAAC;IACN,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAEnD,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACjE,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;IACvB,6EAA6E;IAC7E,sEAAsE;IACtE,6CAA6C;IAC7C,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACvD,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACnD,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;KAAM,CAAC;IACN,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACtC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAEnD,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC1E,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { createServer, runServer } from "./server.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createServer, runServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/skills.d.ts

@@ -1,24 +1,44 @@
-export interface InstallOptions {
+export interface InitOptions {
+    tool: string;
     project: boolean;
     dir?: string;
 }
+/** A supported target tool and where its skills live. */
+export interface ToolTarget {
+    /** Human-readable label. */
+    label: string;
+    /** Absolute global skills directory for this tool (lazy — evaluated at resolve time). */
+    globalSkillsDir: () => string;
+    /** Project-relative skills directory for this tool (relative to cwd). */
+    projectSkillsDir: string;
+}
+export declare const TOOL_REGISTRY: Record<string, ToolTarget>;
+/** Sorted list of supported tool names (for help and error messages). */
+export declare function supportedTools(): string[];
+/** Look up a tool, throwing a helpful error listing every supported tool. */
+export declare function resolveTool(name: string): ToolTarget;
 /** Absolute path to the directory of bundled skills shipped inside dist/. */
 export declare function bundledSkillsDir(): string;
 /**
  * Skills root to install into. Each bundled skill (a subdirectory containing a
  * SKILL.md) is copied to `<root>/<skill-name>/`. Precedence: explicit --dir >
- * --project (./.opencode/skills) > global opencode skills dir.
+ * --project (./.<tool>/skills) > the tool's global skills dir.
+ */
+export declare function resolveInstallDir(opts: InitOptions): string;
+/** Parse `gitea-mcp init [flags]`. Throws on unknown flags or missing values. */
+export declare function parseInitArgs(argv: string[]): InitOptions;
+/**
+ * Copy every skill (each subdirectory of `srcDir` containing a SKILL.md) into
+ * `<destRoot>/<skill-name>/`, recursing into nested folders. Returns the names
+ * of the skills installed. Throws if `srcDir` cannot be read or holds no skill.
+ * Extracted from `runInitCommand` so the copy loop (and its error branches) can
+ * be exercised against a crafted temp tree without mocking the filesystem.
  */
-export declare function resolveInstallDir(opts: InstallOptions): string;
-/** Parse `gitea-mcp skills <command> [flags]`. Throws on unknown flags or missing --dir value. */
-export declare function parseInstallArgs(argv: string[]): {
-    command: string | undefined;
-    opts: InstallOptions;
-};
+export declare function installSkills(srcDir: string, destRoot: string): Promise<string[]>;
 /**
- * Implements `gitea-mcp skills install`: copies every bundled opencode skill
- * (each subdirectory of dist/assets/skills containing a SKILL.md) into the
- * opencode skills directory so opencode loads them on next start. Does NOT need
+ * Implements `gitea-mcp init`: copies every bundled skill (each subdirectory of
+ * dist/assets/skills containing a SKILL.md) into the target tool's skills
+ * directory so the tool loads them on next start. Does NOT need
  * GITEA_BASE_URL / GITEA_TOKEN.
  */
-export declare function runSkillsCommand(argv: string[]): Promise<void>;
+export declare function runInitCommand(argv: string[]): Promise<void>;

package/dist/skills.js

@@ -4,9 +4,64 @@ import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
 const BUNDLED_SKILLS_REL = ["assets", "skills"];
 const SKILL_FILENAME = "SKILL.md";
-const USAGE = `Usage: gitea-mcp skills install [--project] [--dir <path>]
-  --project    install into ./.opencode/skills/ (this project) instead of global
-  --dir <path> install into this exact directory (treated as the skills root)`;
+const DEFAULT_TOOL = "opencode";
+const USAGE = `Usage: gitea-mcp init [--tool <name>] [--project] [--dir <path>]
+  --tool <name>  target AI tool (default: ${DEFAULT_TOOL})
+  --project      install into ./.<tool>/skills/ instead of the tool's global skills dir
+  --dir <path>   install into this exact directory (overrides --tool and --project)
+Supported tools:
+  amazon-q, antigravity, auggie, claude, cline, codex, codebuddy, continue,
+  costrict, crush, cursor, factory, gemini, github-copilot, iflow, kilocode,
+  opencode, qoder, qwen, roocode, windsurf`;
+/** opencode honors OPENCODE_CONFIG_DIR; everything else is home-relative. */
+function opencodeBase() {
+    return process.env.OPENCODE_CONFIG_DIR ?? join(homedir(), ".config", "opencode");
+}
+/**
+ * Registry of supported tools and their conventional skills directories.
+ *
+ * Global paths follow each tool's documented config home plus a `skills/`
+ * folder. For tools without a publicly documented skills folder, a
+ * `~/.config/<tool>/skills/` convention is used; override the destination
+ * with `--dir <path>` for an exact location.
+ */
+/** Lazy home-relative path (homedir is read at call time). */
+const home = (...parts) => join(homedir(), ...parts);
+export const TOOL_REGISTRY = {
+    "amazon-q": { label: "Amazon Q", globalSkillsDir: () => home(".aws", "amazonq", "skills"), projectSkillsDir: join(".amazonq", "skills") },
+    antigravity: { label: "Antigravity", globalSkillsDir: () => home(".config", "antigravity", "skills"), projectSkillsDir: join(".antigravity", "skills") },
+    auggie: { label: "Auggie", globalSkillsDir: () => home(".config", "auggie", "skills"), projectSkillsDir: join(".auggie", "skills") },
+    claude: { label: "Claude Code", globalSkillsDir: () => home(".claude", "skills"), projectSkillsDir: join(".claude", "skills") },
+    cline: { label: "Cline", globalSkillsDir: () => home(".cline", "skills"), projectSkillsDir: join(".cline", "skills") },
+    codex: { label: "Codex CLI", globalSkillsDir: () => home(".codex", "skills"), projectSkillsDir: join(".codex", "skills") },
+    codebuddy: { label: "CodeBuddy", globalSkillsDir: () => home(".config", "codebuddy", "skills"), projectSkillsDir: join(".codebuddy", "skills") },
+    continue: { label: "Continue", globalSkillsDir: () => home(".continue", "skills"), projectSkillsDir: join(".continue", "skills") },
+    costrict: { label: "Costrict", globalSkillsDir: () => home(".config", "costrict", "skills"), projectSkillsDir: join(".costrict", "skills") },
+    crush: { label: "Crush", globalSkillsDir: () => home(".config", "crush", "skills"), projectSkillsDir: join(".crush", "skills") },
+    cursor: { label: "Cursor", globalSkillsDir: () => home(".cursor", "skills"), projectSkillsDir: join(".cursor", "skills") },
+    factory: { label: "Factory", globalSkillsDir: () => home(".factory", "skills"), projectSkillsDir: join(".factory", "skills") },
+    gemini: { label: "Gemini CLI", globalSkillsDir: () => home(".gemini", "skills"), projectSkillsDir: join(".gemini", "skills") },
+    "github-copilot": { label: "GitHub Copilot", globalSkillsDir: () => home(".config", "github-copilot", "skills"), projectSkillsDir: join(".github", "copilot", "skills") },
+    iflow: { label: "iFlow", globalSkillsDir: () => home(".config", "iflow", "skills"), projectSkillsDir: join(".iflow", "skills") },
+    kilocode: { label: "Kilo Code", globalSkillsDir: () => home(".kilo", "skills"), projectSkillsDir: join(".kilo", "skills") },
+    opencode: { label: "opencode", globalSkillsDir: () => join(opencodeBase(), "skills"), projectSkillsDir: join(".opencode", "skills") },
+    qoder: { label: "Qoder", globalSkillsDir: () => home(".config", "qoder", "skills"), projectSkillsDir: join(".qoder", "skills") },
+    qwen: { label: "Qwen Code", globalSkillsDir: () => home(".qwen", "skills"), projectSkillsDir: join(".qwen", "skills") },
+    roocode: { label: "Roo Code", globalSkillsDir: () => home(".roo", "skills"), projectSkillsDir: join(".roo", "skills") },
+    windsurf: { label: "Windsurf", globalSkillsDir: () => home(".codeium", "windsurf", "skills"), projectSkillsDir: join(".windsurf", "skills") },
+};
+/** Sorted list of supported tool names (for help and error messages). */
+export function supportedTools() {
+    return Object.keys(TOOL_REGISTRY).sort();
+}
+/** Look up a tool, throwing a helpful error listing every supported tool. */
+export function resolveTool(name) {
+    const target = TOOL_REGISTRY[name];
+    if (!target) {
+        throw new Error(`Unsupported tool: ${name}\nSupported tools: ${supportedTools().join(", ")}`);
+    }
+    return target;
+}
 /** Absolute path to the directory of bundled skills shipped inside dist/. */
 export function bundledSkillsDir() {
     const moduleDir = dirname(fileURLToPath(import.meta.url));
@@ -15,25 +70,33 @@ export function bundledSkillsDir() {
 /**
  * Skills root to install into. Each bundled skill (a subdirectory containing a
  * SKILL.md) is copied to `<root>/<skill-name>/`. Precedence: explicit --dir >
- * --project (./.opencode/skills) > global opencode skills dir.
+ * --project (./.<tool>/skills) > the tool's global skills dir.
  */
 export function resolveInstallDir(opts) {
     if (opts.dir)
         return opts.dir;
+    const target = resolveTool(opts.tool);
     if (opts.project)
-        return join(process.cwd(), ".opencode", "skills");
-    const base = process.env.OPENCODE_CONFIG_DIR ?? join(homedir(), ".config", "opencode");
-    return join(base, "skills");
+        return join(process.cwd(), target.projectSkillsDir);
+    return target.globalSkillsDir();
 }
-/** Parse `gitea-mcp skills <command> [flags]`. Throws on unknown flags or missing --dir value. */
-export function parseInstallArgs(argv) {
-    const opts = { project: false };
-    let command;
+/** Parse `gitea-mcp init [flags]`. Throws on unknown flags or missing values. */
+export function parseInitArgs(argv) {
+    const opts = { tool: DEFAULT_TOOL, project: false };
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
         if (a === "--project") {
             opts.project = true;
         }
+        else if (a === "--tool") {
+            const val = argv[++i];
+            if (!val)
+                throw new Error("--tool requires a name argument");
+            opts.tool = val;
+        }
+        else if (a.startsWith("--tool=")) {
+            opts.tool = a.slice("--tool=".length);
+        }
         else if (a === "--dir") {
             const val = argv[++i];
             if (!val)
@@ -43,14 +106,14 @@ export function parseInstallArgs(argv) {
         else if (a.startsWith("--dir=")) {
             opts.dir = a.slice("--dir=".length);
         }
-        else if (command === undefined && !a.startsWith("-")) {
-            command = a;
+        else if (a === "--help" || a === "-h") {
+            throw new Error(USAGE);
         }
         else {
-            throw new Error(`Unknown argument: ${a}`);
+            throw new Error(`Unknown argument: ${a}\n${USAGE}`);
         }
     }
-    return { command, opts };
+    return opts;
 }
 /** Recursively copy a directory tree (no experimental fs.cp dependency). */
 async function copyTree(src, dest) {
@@ -68,18 +131,13 @@ async function copyTree(src, dest) {
     }
 }
 /**
- * Implements `gitea-mcp skills install`: copies every bundled opencode skill
- * (each subdirectory of dist/assets/skills containing a SKILL.md) into the
- * opencode skills directory so opencode loads them on next start. Does NOT need
- * GITEA_BASE_URL / GITEA_TOKEN.
+ * Copy every skill (each subdirectory of `srcDir` containing a SKILL.md) into
+ * `<destRoot>/<skill-name>/`, recursing into nested folders. Returns the names
+ * of the skills installed. Throws if `srcDir` cannot be read or holds no skill.
+ * Extracted from `runInitCommand` so the copy loop (and its error branches) can
+ * be exercised against a crafted temp tree without mocking the filesystem.
  */
-export async function runSkillsCommand(argv) {
-    const { command, opts } = parseInstallArgs(argv);
-    if (command !== "install") {
-        const reason = command ? `Unknown skills subcommand: ${command}` : "Missing skills subcommand";
-        throw new Error(`${reason}\n${USAGE}`);
-    }
-    const srcDir = bundledSkillsDir();
+export async function installSkills(srcDir, destRoot) {
     let entries;
     try {
         entries = await readdir(srcDir, { withFileTypes: true });
@@ -87,7 +145,6 @@ export async function runSkillsCommand(argv) {
     catch {
         throw new Error(`Bundled skills not found at ${srcDir}. The package may be corrupted or was installed without its assets.`);
     }
-    const destRoot = resolveInstallDir(opts);
     const installed = [];
     for (const entry of entries) {
         if (!entry.isDirectory())
@@ -105,9 +162,22 @@ export async function runSkillsCommand(argv) {
     if (installed.length === 0) {
         throw new Error(`No skills found to install under ${srcDir}.`);
     }
-    process.stdout.write(`Installed ${installed.length} gitea-mcp skill(s) -> ${destRoot}\n`);
+    return installed;
+}
+/**
+ * Implements `gitea-mcp init`: copies every bundled skill (each subdirectory of
+ * dist/assets/skills containing a SKILL.md) into the target tool's skills
+ * directory so the tool loads them on next start. Does NOT need
+ * GITEA_BASE_URL / GITEA_TOKEN.
+ */
+export async function runInitCommand(argv) {
+    const opts = parseInitArgs(argv);
+    const target = resolveTool(opts.tool);
+    const destRoot = resolveInstallDir(opts);
+    const installed = await installSkills(bundledSkillsDir(), destRoot);
+    process.stdout.write(`Installed ${installed.length} gitea-mcp skill(s) for ${target.label} -> ${destRoot}\n`);
     for (const name of installed)
         process.stdout.write(`  - ${name}\n`);
-    process.stdout.write("Restart opencode for the skills to take effect.\n");
+    process.stdout.write(`Restart ${target.label} for the skills to take effect.\n`);
 }
 //# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@amonstack/gitea-mcp",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for managing Gitea issues via API",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amonstack/gitea_mcp.git"
+  },
+  "homepage": "https://github.com/amonstack/gitea_mcp#readme",
+  "bugs": {
+    "url": "https://github.com/amonstack/gitea_mcp/issues"
+  },
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -29,8 +37,11 @@
     "gitea",
     "issues"
   ],
-  "author": "",
+  "author": "amonstack",
   "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3"