@clix-so/clix-agent-skills 0.2.0 → 0.2.1

package/README.md

@@ -25,7 +25,7 @@ configure the Clix MCP Server.
 The CLI supports two installation modes for skills:
 
 1. **Repo Root (Project-specific)** - Installs skills to the current project
-  directory (default)
+   directory (default)
 
 - Skills are available only for the current project
 - Best for project-specific configurations
@@ -61,32 +61,32 @@ npx @clix-so/clix-agent-skills@latest install --all --client cursor --global
 ### Available Skills
 
 - **clix-integration**: Seamlessly integrate Clix Mobile SDK to your mobile
-application with Clix MCP Server
+  application with Clix MCP Server
 - **clix-event-tracking**: Implement `Clix.trackEvent` with naming/schema best
-practices and campaign-ready validation
+  practices and campaign-ready validation
 - **clix-user-management**: Implement `Clix.setUserId` + user properties with
-logout best practices, personalization (`user.*`), and audience targeting
+  logout best practices, personalization (`user.*`), and audience targeting
 - **clix-personalization**: Author and debug personalization templates for
-message content, deep links/URLs, and audience targeting rules (`user.*`,
-`event.*`, `trigger.*`, `device.*`)
+  message content, deep links/URLs, and audience targeting rules (`user.*`,
+  `event.*`, `trigger.*`, `device.*`)
 - **clix-api-triggered-campaigns**: Configure API-triggered campaigns in the
-console and trigger them from your backend with safe auth, dynamic filters
-(`trigger.*`), and personalization patterns
+  console and trigger them from your backend with safe auth, dynamic filters
+  (`trigger.*`), and personalization patterns
 
 **Supported Clients:**
 
-
 | Client         | Flag                                 | Default Path       |
 | -------------- | ------------------------------------ | ------------------ |
 | Amp            | `--client amp`                       | `.amp/skills/`     |
 | Claude Code    | `--client claude` (or `claude-code`) | `.claude/skills/`  |
 | Codex          | `--client codex`                     | `.codex/skills/`   |
 | Cursor         | `--client cursor`                    | `.cursor/skills/`  |
+| Gemini CLI     | `--client gemini`                    | `.gemini/skills/`  |
 | GitHub Copilot | `--client github`                    | `.github/skills/`  |
 | Goose          | `--client goose`                     | `.goose/skills/`   |
 | Letta          | `--client letta`                     | `.skills/`         |
 | OpenCode       | `--client opencode`                  | `.opencode/skill/` |
-
+| VS Code        | `--client vscode`                    | `.vscode/skills/`  |
 
 ### Claude Code
 
@@ -117,7 +117,10 @@ Alternatively, you can install a single skill directly by running:
 /plugin install clix-api-triggered-campaigns@clix-agent-skills
 ```
 
-**Note for Claude Code users**: Skills now support automatic hot-reload! Skills created or modified in `~/.claude/skills` or `.claude/skills` are immediately available without restarting the session. Skills also show real-time progress while executing, displaying tool uses as they happen.
+**Note for Claude Code users**: Skills now support automatic hot-reload! Skills
+created or modified in `~/.claude/skills` or `.claude/skills` are immediately
+available without restarting the session. Skills also show real-time progress
+while executing, displaying tool uses as they happen.
 
 ### Codex
 
@@ -135,7 +138,6 @@ $skill-installer install https://github.com/clix-so/skills/tree/main/skills/inte
 
 Ensure you restart Codex after installation to detect the new skills.
 
-
 ## Disclaimer
 
 Please be aware that these skills may occasionally fail or execute incorrectly
@@ -148,4 +150,4 @@ Please use them with caution and supervision.
 
 Each skill in this repository is governed by its own license. For specific terms
 and conditions, please consult the `LICENSE.txt` file located within each
-skill's individual directory.
+skill's individual directory.

package/dist/bin/cli.js

@@ -25,7 +25,7 @@ program
 program
     .command("install [skill]")
     .description("Install agent skill(s)")
-    .option("-c, --client <client>", "Target AI client (cursor, claude|claude-code, vscode, amp, kiro, amazonq, codex, opencode, manual)")
+    .option("-c, --client <client>", "Target AI client (amazonq, amp, claude|claude-code, codex, copilot|github, cursor, gemini, goose, kiro, letta, opencode, vscode, manual)")
     .option("-p, --path <path>", "Custom installation path (default: .clix/skills)")
     .option("-a, --all", "Install all available skills")
     .option("-g, --global", "Install globally to system root (default: installs to repo root)")

package/dist/bin/commands/install.js

@@ -63,22 +63,30 @@ async function installSkill(skillName, options) {
     }
     else if (options.client) {
         switch (options.client.toLowerCase()) {
+            case "amazonq":
+                relativeDest = ".amazonq/skills";
+                break;
+            case "amp":
+                relativeDest = ".amp/skills";
+                break;
             case "claude":
             case "claude-code":
                 // Claude Code uses the .claude/ folder convention, but MCP is configured via `claude mcp ...`
                 relativeDest = ".claude/skills";
                 break;
-            case "cursor":
-                relativeDest = ".cursor/skills";
-                break;
-            case "vscode":
-                relativeDest = ".vscode/skills";
-                break;
             case "codex":
                 relativeDest = ".codex/skills";
                 break;
-            case "opencode":
-                relativeDest = ".opencode/skill";
+            case "copilot":
+            case "github":
+                relativeDest = ".github/skills";
+                break;
+            case "cursor":
+                relativeDest = ".cursor/skills";
+                break;
+            case "gemini":
+                // Gemini CLI discovers project skills in `.gemini/skills/` and user skills in `~/.gemini/skills/`
+                relativeDest = ".gemini/skills";
                 break;
             case "letta":
                 relativeDest = ".skills";
@@ -86,18 +94,14 @@ async function installSkill(skillName, options) {
             case "goose":
                 relativeDest = ".goose/skills";
                 break;
-            case "github":
-            case "copilot":
-                relativeDest = ".github/skills";
-                break;
-            case "amp":
-                relativeDest = ".amp/skills";
-                break;
             case "kiro":
                 relativeDest = ".kiro/skills";
                 break;
-            case "amazonq":
-                relativeDest = ".amazonq/skills";
+            case "opencode":
+                relativeDest = ".opencode/skill";
+                break;
+            case "vscode":
+                relativeDest = ".vscode/skills";
                 break;
             default:
                 relativeDest = options.client.startsWith(".") ? `${options.client}/skills` : `.clix/skills`;

package/dist/bin/utils/mcp.js

@@ -151,6 +151,13 @@ function createEmptyConfig(configKey) {
 function getClientConfig(client) {
     const home = os_1.default.homedir();
     switch (client.toLowerCase()) {
+        case "gemini":
+            // Gemini CLI stores MCP server configuration in `~/.gemini/settings.json` (user scope)
+            return {
+                path: path_1.default.join(home, ".gemini", "settings.json"),
+                configKey: "mcpServers",
+                format: "json",
+            };
         case "cursor": {
             // MCP is always configured globally
             return {
@@ -351,17 +358,18 @@ async function configureMCP(client) {
                 name: "client",
                 message: "Which AI client are you using?",
                 choices: [
-                    { name: "Cursor", value: "cursor" },
-                    { name: "Claude Code", value: "claude" },
-                    { name: "VS Code", value: "vscode" },
-                    { name: "Amp", value: "amp" },
-                    { name: "Kiro", value: "kiro" },
                     { name: "Amazon Q", value: "amazonq" },
+                    { name: "Amp", value: "amp" },
+                    { name: "Claude Code", value: "claude" },
                     { name: "Codex", value: "codex" },
-                    { name: "OpenCode", value: "opencode" },
-                    { name: "Letta", value: "letta" },
-                    { name: "Goose", value: "goose" },
+                    { name: "Cursor", value: "cursor" },
+                    { name: "Gemini CLI", value: "gemini" },
                     { name: "GitHub", value: "github" },
+                    { name: "Goose", value: "goose" },
+                    { name: "Kiro", value: "kiro" },
+                    { name: "Letta", value: "letta" },
+                    { name: "OpenCode", value: "opencode" },
+                    { name: "VS Code", value: "vscode" },
                     { name: "None / Manual", value: "manual" },
                 ],
             },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clix-so/clix-agent-skills",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "An open collection of agent skills for Clix.",
   "main": "dist/index.js",
   "bin": {
@@ -23,7 +23,7 @@
     "generate-llms": "ts-node scripts/generate-llms.ts",
     "preversion": "npm run sync-version",
     "postversion": "npm run sync-version",
-    "prepublishOnly": "npm run sync-version && npm run build && npm test && npm run generate-llms"
+    "prepublishOnly": "npm run sync-version && npm run build && npm test && npm run generate-llms && npm run lint:fix"
   },
   "keywords": [
     "clix",