@clix-so/clix-agent-skills 0.1.1 → 0.1.3

package/README.md

@@ -7,9 +7,9 @@ is a self-contained package that can be loaded and executed by AI clients.
 
 Agents skills on this repository are built on the
 [open agent skills standard](https://agentskills.io/home). Please refer to the
-[official documentation](https://agentskills.io/docs) for up-to-date information
-of support AI clients. Depending on the AI client you are using, you can install
-skills in different ways.
+[official documentation](https://agentskills.io/home#adoption) for up-to-date
+information of support AI clients. Depending on the AI client you are using, you
+can install skills in different ways.
 
 ### Universal CLI (Recommended)
 
@@ -18,7 +18,9 @@ For **Cursor**, **VS Code**, **Claude Desktop**, **OpenCode**, **Goose**,
 and configure the Clix MCP Server automatically:
 
 ```bash
-npx @clix-so/clix-agent-skills install <skill-name> --client <your-client>
+npx @clix-so/clix-agent-skills@latest install <skill-name> --client <your-client>
+# For example, to install integration skill on Cursor:
+# npx @clix-so/clix-agent-skills@latest install integration --client cursor
 ```
 
 **Supported Clients:**
@@ -55,7 +57,7 @@ Alternatively, you can install a single skill directly by running:
 ```bash
 /plugin install <plugin-name>@<marketplace-name>
 # For example
-/plugin install clix-integration@clix-agent-skills
+# /plugin install clix-integration@clix-agent-skills
 ```
 
 Remember to restart Claude Code after installation to load the new skills.
@@ -81,10 +83,10 @@ incorrectly** due to the non-deterministic nature of AI.
 
 It is critical that you **carefully review and verify all actions** performed by
 these skills. While they are designed to be helpful, you remain responsible for
-checking their output before use. Use them with caution and supervision.
+checking their output before use. Please use them with caution and supervision.
 
 ## License
 
 Each skill in this repository is governed by its own license. For specific terms
-and conditions, please consult the `LICENSE` file located within each skill's
-individual directory.
+and conditions, please consult the `LICENSE.txt` file located within each
+skill's individual directory.

package/dist/bin/cli.js

@@ -7,22 +7,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const install_1 = require("./commands/install");
+const package_json_1 = require("../../package.json");
+/**
+ * Extracts error message from unknown error type
+ */
+function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
 const program = new commander_1.Command();
 program
     .name("clix-agent-skills")
     .description("CLI to manage and install Clix Agent Skills")
-    .version("1.0.0");
+    .version(package_json_1.version);
 program
     .command("install <skill>")
     .description("Install a specific agent skill")
-    .option("-c, --client <client>", "Target AI client (cursor, claude, vscode, manual)")
+    .option("-c, --client <client>", "Target AI client (cursor, claude, vscode, amp, kiro, amazonq, codex, opencode, manual)")
     .option("-p, --path <path>", "Custom installation path (default: .clix/skills)")
     .action(async (skill, options) => {
     try {
         await (0, install_1.installSkill)(skill, options);
     }
     catch (error) {
-        console.error(chalk_1.default.red("Error installing skill:"), error.message);
+        console.error(chalk_1.default.red("Error installing skill:"), getErrorMessage(error));
         process.exit(1);
     }
 });

package/dist/bin/commands/install.js

@@ -9,6 +9,15 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const chalk_1 = __importDefault(require("chalk"));
 const ora_1 = __importDefault(require("ora"));
 const mcp_1 = require("../utils/mcp");
+/**
+ * Extracts error message from unknown error type
+ */
+function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
 async function installSkill(skillName, options) {
     const spinner = (0, ora_1.default)(`Installing skill: ${chalk_1.default.bold(skillName)}`).start();
     // 1. Locate Skill in current package
@@ -80,6 +89,12 @@ async function installSkill(skillName, options) {
             case "amp":
                 relativeDest = ".amp/skills";
                 break;
+            case "kiro":
+                relativeDest = ".kiro/skills";
+                break;
+            case "amazonq":
+                relativeDest = ".amazonq/skills";
+                break;
             default:
                 relativeDest = options.client.startsWith(".") ? `${options.client}/skills` : `.clix/skills`;
         }
@@ -91,16 +106,16 @@ async function installSkill(skillName, options) {
         await fs_extra_1.default.copy(skillSourcePath, destPath);
         spinner.succeed(`Skill files installed to ${chalk_1.default.green(relativeDest + "/" + skillName)}`);
     }
-    catch (err) {
-        spinner.fail(`Failed to copy skill files: ${err.message}`);
-        throw err;
+    catch (error) {
+        spinner.fail(`Failed to copy skill files: ${getErrorMessage(error)}`);
+        throw error;
     }
     // 4. MCP Configuration
     try {
         await (0, mcp_1.configureMCP)(options.client);
     }
-    catch (err) {
-        console.warn(chalk_1.default.yellow(`MCP Configuration warning: ${err.message}`));
+    catch (error) {
+        console.warn(chalk_1.default.yellow(`MCP Configuration warning: ${getErrorMessage(error)}`));
     }
     console.log(`\n${chalk_1.default.green("✔")} Skill ${chalk_1.default.bold(skillName)} is ready to use!`);
     console.log(`  - Docs: ${path_1.default.join(destPath, "SKILL.md")}`);

package/dist/bin/utils/mcp.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -9,12 +42,262 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const os_1 = __importDefault(require("os"));
 const chalk_1 = __importDefault(require("chalk"));
 const inquirer_1 = __importDefault(require("inquirer"));
-const CLIX_MCP_CONFIG = {
-    "clix-mcp-server": {
-        command: "npx",
-        args: ["-y", "@clix-so/clix-mcp-server@latest"],
-    },
+const TOML = __importStar(require("@iarna/toml"));
+// ============================================================================
+// Constants
+// ============================================================================
+const CLIX_MCP_SERVER_ENTRY = {
+    command: "npx",
+    args: ["-y", "@clix-so/clix-mcp-server@latest"],
 };
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Extracts error message from unknown error type
+ */
+function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * Gets the MCP servers object from JSON config based on client type
+ */
+function getMcpServersFromConfig(config, configKey) {
+    if (configKey === "amp.mcpServers") {
+        return config["amp.mcpServers"];
+    }
+    return config.mcpServers;
+}
+/**
+ * Sets the MCP servers object in JSON config based on client type
+ */
+function setMcpServersInConfig(config, configKey, servers) {
+    if (configKey === "amp.mcpServers") {
+        config["amp.mcpServers"] = servers;
+    }
+    else {
+        config.mcpServers = servers;
+    }
+}
+/**
+ * Creates empty JSON config structure based on client type
+ */
+function createEmptyConfig(configKey) {
+    if (configKey === "amp.mcpServers") {
+        return { "amp.mcpServers": {} };
+    }
+    return { mcpServers: {} };
+}
+/**
+ * Gets config path, key, and format for a specific client
+ */
+function getClientConfig(client) {
+    const home = os_1.default.homedir();
+    switch (client.toLowerCase()) {
+        case "cursor": {
+            // Check for project-level definition first
+            const projectCursorPath = path_1.default.join(process.cwd(), ".cursor", "mcp.json");
+            if (fs_extra_1.default.existsSync(projectCursorPath)) {
+                return { path: projectCursorPath, configKey: "mcpServers", format: "json" };
+            }
+            // Fallback to global
+            return {
+                path: path_1.default.join(home, ".cursor", "mcp.json"),
+                configKey: "mcpServers",
+                format: "json",
+            };
+        }
+        case "claude": {
+            let configPath = null;
+            if (process.platform === "darwin") {
+                configPath = path_1.default.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+            }
+            else if (process.platform === "win32") {
+                configPath = path_1.default.join(process.env.APPDATA || "", "Claude", "claude_desktop_config.json");
+            }
+            else if (process.platform === "linux") {
+                configPath = path_1.default.join(home, ".config", "Claude", "claude_desktop_config.json");
+            }
+            return configPath ? { path: configPath, configKey: "mcpServers", format: "json" } : null;
+        }
+        case "vscode":
+            return {
+                path: path_1.default.join(home, ".vscode", "mcp.json"),
+                configKey: "mcpServers",
+                format: "json",
+            };
+        case "amp": {
+            let ampConfigPath;
+            if (process.platform === "win32") {
+                ampConfigPath = path_1.default.join(process.env.USERPROFILE || home, ".config", "amp", "settings.json");
+            }
+            else {
+                ampConfigPath = path_1.default.join(home, ".config", "amp", "settings.json");
+            }
+            return { path: ampConfigPath, configKey: "amp.mcpServers", format: "json" };
+        }
+        case "kiro":
+            return {
+                path: path_1.default.join(process.cwd(), ".kiro", "settings", "mcp.json"),
+                configKey: "mcpServers",
+                format: "json",
+            };
+        case "amazonq":
+            return {
+                path: path_1.default.join(home, ".aws", "amazonq", "agents", "default.json"),
+                configKey: "mcpServers",
+                format: "json",
+            };
+        case "codex":
+            return {
+                path: path_1.default.join(home, ".codex", "config.toml"),
+                configKey: "mcp_servers",
+                format: "toml",
+            };
+        default:
+            return null;
+    }
+}
+// ============================================================================
+// TOML Configuration (Codex)
+// ============================================================================
+async function configureCodexTOML(configPath) {
+    const nicePath = configPath.replace(os_1.default.homedir(), "~");
+    console.log(chalk_1.default.blue(`Checking MCP config at ${nicePath}...`));
+    let config = {};
+    if (!fs_extra_1.default.existsSync(configPath)) {
+        const { create } = await inquirer_1.default.prompt([
+            {
+                type: "confirm",
+                name: "create",
+                message: `Config file not found at ${nicePath}. Create it?`,
+                default: true,
+            },
+        ]);
+        if (!create) {
+            console.log(chalk_1.default.yellow("Skipping MCP configuration. You can configure manually later."));
+            return;
+        }
+        try {
+            await fs_extra_1.default.ensureDir(path_1.default.dirname(configPath));
+            config = { mcp_servers: {} };
+            await fs_extra_1.default.writeFile(configPath, TOML.stringify(config), "utf-8");
+            console.log(chalk_1.default.green(`✔ Created config file at ${nicePath}`));
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`Failed to create config file: ${getErrorMessage(error)}`));
+            return;
+        }
+    }
+    else {
+        // Read existing TOML config
+        try {
+            const content = await fs_extra_1.default.readFile(configPath, "utf-8");
+            config = TOML.parse(content);
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`Failed to parse existing config TOML: ${getErrorMessage(error)}`));
+            return;
+        }
+    }
+    // Initialize mcp_servers if not present
+    if (!config.mcp_servers) {
+        config.mcp_servers = {};
+    }
+    // Check if already configured
+    if (config.mcp_servers["clix-mcp-server"]) {
+        console.log(chalk_1.default.green("✔ Clix MCP Server is already configured."));
+        return;
+    }
+    // Ask to inject
+    const { inject } = await inquirer_1.default.prompt([
+        {
+            type: "confirm",
+            name: "inject",
+            message: `Add Clix MCP Server to ${nicePath}?`,
+            default: true,
+        },
+    ]);
+    if (inject) {
+        config.mcp_servers["clix-mcp-server"] = CLIX_MCP_SERVER_ENTRY;
+        await fs_extra_1.default.writeFile(configPath, TOML.stringify(config), "utf-8");
+        console.log(chalk_1.default.green(`✔ Added Clix MCP Server to configuration. Please restart codex.`));
+    }
+}
+async function configureOpenCode() {
+    const configPath = path_1.default.join(process.cwd(), "opencode.json");
+    const nicePath = "opencode.json";
+    console.log(chalk_1.default.blue(`Checking MCP config at ${nicePath}...`));
+    let config = {};
+    if (!fs_extra_1.default.existsSync(configPath)) {
+        const { create } = await inquirer_1.default.prompt([
+            {
+                type: "confirm",
+                name: "create",
+                message: `Config file not found at ${nicePath}. Create it?`,
+                default: true,
+            },
+        ]);
+        if (!create) {
+            console.log(chalk_1.default.yellow("Skipping MCP configuration. You can configure manually later."));
+            return;
+        }
+        try {
+            config = {
+                $schema: "https://opencode.ai/config.json",
+                mcp: {},
+            };
+            await fs_extra_1.default.writeJSON(configPath, config, { spaces: 2 });
+            console.log(chalk_1.default.green(`✔ Created config file at ${nicePath}`));
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`Failed to create config file: ${getErrorMessage(error)}`));
+            return;
+        }
+    }
+    else {
+        try {
+            config = await fs_extra_1.default.readJSON(configPath);
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`Failed to parse existing config JSON: ${getErrorMessage(error)}`));
+            return;
+        }
+    }
+    // Initialize mcp if not present
+    if (!config.mcp) {
+        config.mcp = {};
+    }
+    // Check if already configured
+    if (config.mcp["clix-mcp-server"]) {
+        console.log(chalk_1.default.green("✔ Clix MCP Server is already configured."));
+        return;
+    }
+    // Ask to inject
+    const { inject } = await inquirer_1.default.prompt([
+        {
+            type: "confirm",
+            name: "inject",
+            message: `Add Clix MCP Server to ${nicePath}?`,
+            default: true,
+        },
+    ]);
+    if (inject) {
+        config.mcp["clix-mcp-server"] = {
+            type: "local",
+            command: ["npx", "-y", "@clix-so/clix-mcp-server@latest"],
+            enabled: true,
+        };
+        await fs_extra_1.default.writeJSON(configPath, config, { spaces: 2 });
+        console.log(chalk_1.default.green(`✔ Added Clix MCP Server to configuration. Please restart opencode.`));
+    }
+}
+// ============================================================================
+// Main Function
+// ============================================================================
 async function configureMCP(client) {
     let targetClient = client;
     if (!targetClient) {
@@ -27,12 +310,14 @@ async function configureMCP(client) {
                     { name: "Cursor", value: "cursor" },
                     { name: "Claude Desktop", value: "claude" },
                     { name: "VS Code", value: "vscode" },
+                    { name: "Amp", value: "amp" },
+                    { name: "Kiro", value: "kiro" },
+                    { name: "Amazon Q", value: "amazonq" },
                     { name: "Codex", value: "codex" },
                     { name: "OpenCode", value: "opencode" },
                     { name: "Letta", value: "letta" },
                     { name: "Goose", value: "goose" },
                     { name: "GitHub", value: "github" },
-                    { name: "Amp", value: "amp" },
                     { name: "None / Manual", value: "manual" },
                 ],
             },
@@ -43,15 +328,27 @@ async function configureMCP(client) {
         console.log(chalk_1.default.blue("Skipping automatic MCP configuration."));
         return;
     }
-    const configPath = getConfigPath(targetClient);
-    if (!configPath) {
-        console.log(chalk_1.default.yellow(`Could not determine config path for ${targetClient}. skipping.`));
+    // Handle OpenCode separately (different JSON structure)
+    if (targetClient === "opencode") {
+        await configureOpenCode();
         return;
     }
+    // Get client config
+    const clientConfig = getClientConfig(targetClient);
+    if (!clientConfig) {
+        console.log(chalk_1.default.yellow(`Could not determine config path for ${targetClient}. Skipping.`));
+        return;
+    }
+    // Handle TOML format (Codex)
+    if (clientConfig.format === "toml") {
+        await configureCodexTOML(clientConfig.path);
+        return;
+    }
+    // Handle JSON format (all other clients)
+    const { path: configPath, configKey } = clientConfig;
     const nicePath = configPath.replace(os_1.default.homedir(), "~");
     console.log(chalk_1.default.blue(`Checking MCP config at ${nicePath}...`));
     if (!fs_extra_1.default.existsSync(configPath)) {
-        // For now, confirm before creating new file
         const { create } = await inquirer_1.default.prompt([
             {
                 type: "confirm",
@@ -66,26 +363,30 @@ async function configureMCP(client) {
         }
         try {
             await fs_extra_1.default.ensureDir(path_1.default.dirname(configPath));
-            await fs_extra_1.default.writeJSON(configPath, { mcpServers: {} }, { spaces: 2 });
+            await fs_extra_1.default.writeJSON(configPath, createEmptyConfig(configKey), { spaces: 2 });
             console.log(chalk_1.default.green(`✔ Created config file at ${nicePath}`));
         }
         catch (error) {
-            console.log(chalk_1.default.red(`Failed to create config file: ${error.message}`));
+            console.log(chalk_1.default.red(`Failed to create config file: ${getErrorMessage(error)}`));
             return;
         }
     }
     // Read config
-    let config = {};
+    let config;
     try {
         config = await fs_extra_1.default.readJSON(configPath);
     }
-    catch (e) {
-        console.log(chalk_1.default.red("Failed to parse existing config JSON."));
+    catch (error) {
+        console.log(chalk_1.default.red(`Failed to parse existing config JSON: ${getErrorMessage(error)}`));
         return;
     }
-    if (!config.mcpServers)
-        config.mcpServers = {};
-    if (config.mcpServers["clix-mcp-server"]) {
+    // Get or create mcpServers object
+    let mcpServers = getMcpServersFromConfig(config, configKey);
+    if (!mcpServers) {
+        mcpServers = {};
+        setMcpServersInConfig(config, configKey, mcpServers);
+    }
+    if (mcpServers["clix-mcp-server"]) {
         console.log(chalk_1.default.green("✔ Clix MCP Server is already configured."));
         return;
     }
@@ -99,33 +400,9 @@ async function configureMCP(client) {
         },
     ]);
     if (inject) {
-        config.mcpServers["clix-mcp-server"] = CLIX_MCP_CONFIG["clix-mcp-server"];
+        mcpServers["clix-mcp-server"] = CLIX_MCP_SERVER_ENTRY;
+        setMcpServersInConfig(config, configKey, mcpServers);
         await fs_extra_1.default.writeJSON(configPath, config, { spaces: 2 });
         console.log(chalk_1.default.green(`✔ Added Clix MCP Server to configuration. Please restart ${targetClient}.`));
     }
 }
-function getConfigPath(client) {
-    const home = os_1.default.homedir();
-    switch (client.toLowerCase()) {
-        case "cursor":
-            // Check for project-level definition first
-            const projectCursorPath = path_1.default.join(process.cwd(), ".cursor", "mcp.json");
-            if (fs_extra_1.default.existsSync(projectCursorPath)) {
-                return projectCursorPath;
-            }
-            // Fallback to global
-            return path_1.default.join(home, ".cursor", "mcp.json");
-        case "claude":
-            if (process.platform === "darwin") {
-                return path_1.default.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
-            }
-            else if (process.platform === "win32") {
-                return path_1.default.join(process.env.APPDATA || "", "Claude", "claude_desktop_config.json");
-            }
-            return null;
-        case "vscode":
-            return path_1.default.join(home, ".vscode", "mcp.json"); // Standard VS Code MCP path assumption
-        default:
-            return null;
-    }
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clix-so/clix-agent-skills",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "An open collection of agent skills for Clix.",
   "main": "dist/index.js",
   "bin": {
@@ -16,7 +16,11 @@
     "dev": "ts-node src/bin/cli.ts",
     "test": "jest",
     "lint": "prettier --check .",
-    "lint:fix": "prettier --write ."
+    "lint:fix": "prettier --write .",
+    "sync-version": "ts-node scripts/sync-version.ts",
+    "preversion": "npm run sync-version",
+    "postversion": "npm run sync-version",
+    "prepublishOnly": "npm run sync-version && npm run build && npm test"
   },
   "keywords": [
     "clix",
@@ -32,6 +36,7 @@
     "url": "https://github.com/clix-so/skills"
   },
   "dependencies": {
+    "@iarna/toml": "^2.2.5",
     "chalk": "^4.1.2",
     "commander": "^14.0.2",
     "fs-extra": "^11.3.3",
@@ -40,6 +45,7 @@
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
+    "@types/iarna__toml": "^2.0.5",
     "@types/inquirer": "^9.0.9",
     "@types/jest": "^30.0.0",
     "@types/node": "^25.0.3",

package/skills/integration/SKILL.md

@@ -5,7 +5,6 @@ description:
   projects. Provides step-by-step guidance for installation, initialization, and
   verification. Use when the user asks to install, setup, or configure Clix
   analytics.
-version: 0.1.0
 ---
 
 # Clix SDK Integration Skill
@@ -42,7 +41,8 @@ latest verified SDK source code.
      - Run: `bash scripts/install-mcp.sh`
      - The script will:
        - Verify the package is available
-       - Auto-detect the MCP client (Codex, Cursor, Claude Desktop, VS Code, etc.)
+       - Auto-detect the MCP client (OpenCode, Amp, Codex, Cursor, Claude
+         Desktop, VS Code, etc.)
        - Automatically configure the MCP server in the appropriate config file
        - Provide clear instructions for restart
      - Instruct user to restart their agent/IDE to load the new server.
@@ -55,8 +55,8 @@ latest verified SDK source code.
 
 ## Interaction Guidelines for Agents
 
-When using this skill (for example inside Claude Code, Codex, Cursor, or other
-AI IDEs), follow these behaviors:
+When using this skill (for example inside OpenCode, Amp, Claude Code, Codex,
+Cursor, or other AI IDEs), follow these behaviors:
 
 - **Start with reconnaissance**
   - Inspect the project structure first (list key files like `package.json`,
@@ -123,6 +123,9 @@ Examine the codebase structure to determine platform:
 - **Other**: If it’s not one of the above, stop and ask the user—this skill is
   mobile-only.
 
+**Priority rule (important):** If React Native or Flutter is detected, treat it
+as the primary platform even if native `ios/` and `android/` folders exist.
+
 **Step 2.2: Verify Detection**
 
 Confirm platform detection with user if ambiguous:
@@ -238,6 +241,42 @@ Run validation checks:
 - Verify environment variables are accessible
 - Verify SDK is properly imported and initialized
 
+### Platform Verification Checklists (UI Steps → Repo Verification)
+
+Use these checklists to verify manual UI steps were actually completed.
+
+#### iOS Verification
+
+- **Dependencies present**: `Podfile`/`Podfile.lock` or SwiftPM/Xcode references
+- **Entitlements present**: an `*.entitlements` file exists and is wired to the
+  correct target(s)
+- **Capabilities configured**: `project.pbxproj` reflects required capabilities
+  (as applicable to Push Notifications / Background Modes)
+
+#### Android Verification
+
+- **Dependencies present**: module-level `build.gradle` / `build.gradle.kts`
+  includes required SDK dependencies
+- **Manifest updated**: `AndroidManifest.xml` contains required permissions,
+  services/receivers (as required by the SDK)
+- **Firebase config placed** (if used): `google-services.json` exists in the
+  expected module directory (commonly `app/`)
+
+#### React Native Verification
+
+- **JS dependency**: `package.json` includes the Clix package
+- **iOS native**: `ios/Podfile.lock` updated after `pod install` (when required)
+- **Android native**: Gradle + Manifest updates present if required by the SDK
+- **Initialization**: root entrypoint initializes the SDK exactly once
+
+#### Flutter Verification
+
+- **Pub dependency**: `pubspec.yaml` includes the required packages and
+  `pubspec.lock` is updated after `flutter pub get`
+- **iOS native**: `ios/Podfile.lock` updated after `pod install` (when required)
+- **Android native**: Gradle + Manifest updates present if required
+- **Initialization**: SDK initialized before `runApp`
+
 **Step 5.3: Documentation**
 
 Create or update documentation:
@@ -388,6 +427,20 @@ Future<void> main() async {
 6. **Document changes** - Update README and configuration files
 7. **Version control** - Add `.env` to `.gitignore`, commit `.env.example`
 
+## Docs Usage Note (MCP vs Static vs Web Docs)
+
+- If MCP tools are available: treat `search_sdk` results as the source of truth
+  for initialization/API usage.
+- If MCP tools are unavailable: you may reference the official quickstarts below
+  for **manual steps**, and use `examples/` + `references/` for code patterns.
+
+**Official quickstarts:**
+
+- iOS: `https://docs.clix.so/sdk-quickstart-ios`
+- Android: `https://docs.clix.so/sdk-quickstart-android`
+- React Native: `https://docs.clix.so/sdk-quickstart-react-native`
+- Flutter: `https://docs.clix.so/sdk-quickstart-flutter`
+
 ## Progressive Disclosure
 
 - **Level 1**: This SKILL.md file (always loaded)

package/skills/integration/references/mcp-integration.md

@@ -282,3 +282,65 @@ claude mcp add --transport stdio clix-mcp-server -- npx -y @clix-so/clix-mcp-ser
   }
 }
 ```
+
+#### Amp
+
+**Setup**
+
+Amp uses `amp.mcpServers` in VS Code settings files. Configure in either:
+
+- **Workspace settings**: `.vscode/settings.json` (recommended for
+  project-specific setup)
+- **User settings**: `~/.vscode/settings.json` (for global setup)
+
+1. Open `.vscode/settings.json` (create if it doesn't exist).
+2. Add the configuration:
+
+```json
+{
+  "amp.mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```
+
+3. Restart Amp or reload the VS Code window.
+
+**Note**: The server name `clix-mcp-server` ensures tools appear as
+`clix-mcp-server:*` (e.g., `clix-mcp-server:search_sdk`,
+`clix-mcp-server:search_docs`). See
+[Amp MCP documentation](https://ampcode.com/manual#mcp) for more details.
+
+#### OpenCode
+
+**Setup**
+
+OpenCode uses `opencode.json` or `opencode.jsonc` files in your project root.
+See [OpenCode MCP documentation](https://opencode.ai/docs/mcp-servers/) for
+details.
+
+1. Open `opencode.json` or `opencode.jsonc` (create if it doesn't exist).
+2. Add the configuration:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "clix-mcp-server": {
+      "type": "local",
+      "command": ["npx", "-y", "@clix-so/clix-mcp-server@latest"],
+      "enabled": true
+    }
+  }
+}
+```
+
+3. Restart OpenCode or reload the configuration.
+
+**Note**: The server name `clix-mcp-server` ensures tools appear as
+`clix-mcp-server:*` (e.g., `clix-mcp-server:search_sdk`,
+`clix-mcp-server:search_docs`). You can reference the server in prompts with
+`use clix-mcp-server` or add it to your `AGENTS.md` file.

package/skills/integration/scripts/install-mcp.sh

@@ -58,6 +58,30 @@ get_config_path() {
     vscode)
       echo "${home}/.vscode/mcp.json"
       ;;
+    amp)
+      # Amp uses VS Code settings.json format
+      # Check workspace settings first, then user settings
+      if [ -f ".vscode/settings.json" ]; then
+        echo ".vscode/settings.json"
+      elif [ -f "${home}/.vscode/settings.json" ]; then
+        echo "${home}/.vscode/settings.json"
+      else
+        # Default to workspace settings
+        echo ".vscode/settings.json"
+      fi
+      ;;
+    opencode)
+      # OpenCode uses opencode.json or opencode.jsonc in project root
+      # Check for .jsonc first (preferred), then .json
+      if [ -f "opencode.jsonc" ]; then
+        echo "opencode.jsonc"
+      elif [ -f "opencode.json" ]; then
+        echo "opencode.json"
+      else
+        # Default to .jsonc
+        echo "opencode.jsonc"
+      fi
+      ;;
     *)
       echo ""
       ;;
@@ -116,6 +140,112 @@ EOF
   log "${GREEN}✔ Configured Clix MCP Server in Codex config${RESET}"
 }
 
+# Configure MCP for Amp (uses amp.mcpServers in VS Code settings.json)
+configure_amp() {
+  local config_path="$1"
+  local config_dir=$(dirname "$config_path")
+
+  mkdir -p "$config_dir"
+
+  if [ ! -f "$config_path" ]; then
+    echo '{}' > "$config_path"
+    log "${GREEN}✔ Created Amp settings file${RESET}"
+  fi
+
+  # Check if already configured
+  if grep -q "clix-mcp-server" "$config_path" 2>/dev/null; then
+    log "${GREEN}✔ Clix MCP Server already configured in Amp${RESET}"
+    return 0
+  fi
+
+  # Use node to safely update JSON
+  if command -v node &> /dev/null; then
+    node <<EOF
+const fs = require('fs');
+const path = '$config_path';
+let config = {};
+try {
+  const content = fs.readFileSync(path, 'utf8');
+  config = JSON.parse(content);
+} catch (e) {
+  config = {};
+}
+if (!config['amp.mcpServers']) config['amp.mcpServers'] = {};
+config['amp.mcpServers']['clix-mcp-server'] = {
+  command: 'npx',
+  args: ['-y', '@clix-so/clix-mcp-server@latest']
+};
+fs.writeFileSync(path, JSON.stringify(config, null, 2) + '\n');
+EOF
+    log "${GREEN}✔ Configured Clix MCP Server in Amp${RESET}"
+  else
+    log "${YELLOW}⚠️  Node.js not found. Please manually add to $config_path:${RESET}"
+    log "${BLUE}{${RESET}"
+    log "${BLUE}  \"amp.mcpServers\": {${RESET}"
+    log "${BLUE}    \"clix-mcp-server\": {${RESET}"
+    log "${BLUE}      \"command\": \"npx\",${RESET}"
+    log "${BLUE}      \"args\": [\"-y\", \"@clix-so/clix-mcp-server@latest\"]${RESET}"
+    log "${BLUE}    }${RESET}"
+    log "${BLUE}  }${RESET}"
+    log "${BLUE}}${RESET}"
+  fi
+}
+
+# Configure MCP for OpenCode (uses opencode.json/jsonc with mcp section)
+configure_opencode() {
+  local config_path="$1"
+
+  if [ ! -f "$config_path" ]; then
+    # Create new opencode.jsonc file
+    cat > "$config_path" <<'EOF'
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {}
+}
+EOF
+    log "${GREEN}✔ Created OpenCode config file${RESET}"
+  fi
+
+  # Check if already configured
+  if grep -q "clix-mcp-server" "$config_path" 2>/dev/null; then
+    log "${GREEN}✔ Clix MCP Server already configured in OpenCode${RESET}"
+    return 0
+  fi
+
+  # Use node to safely update JSON/JSONC
+  if command -v node &> /dev/null; then
+    node <<EOF
+const fs = require('fs');
+const path = '$config_path';
+let content = fs.readFileSync(path, 'utf8');
+// Remove comments for JSONC parsing (simple approach)
+let jsonContent = content.replace(/\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, '');
+let config = JSON.parse(jsonContent);
+if (!config.mcp) config.mcp = {};
+config.mcp['clix-mcp-server'] = {
+  type: 'local',
+  command: ['npx', '-y', '@clix-so/clix-mcp-server@latest'],
+  enabled: true
+};
+// Write back as JSONC if original was .jsonc, otherwise JSON
+const isJsonc = path.endsWith('.jsonc');
+fs.writeFileSync(path, JSON.stringify(config, null, 2) + '\n');
+EOF
+    log "${GREEN}✔ Configured Clix MCP Server in OpenCode${RESET}"
+  else
+    log "${YELLOW}⚠️  Node.js not found. Please manually add to $config_path:${RESET}"
+    log "${BLUE}{${RESET}"
+    log "${BLUE}  \"mcp\": {${RESET}"
+    log "${BLUE}    \"clix-mcp-server\": {${RESET}"
+    log "${BLUE}      \"type\": \"local\",${RESET}"
+    log "${BLUE}      \"command\": [\"npx\", \"-y\", \"@clix-so/clix-mcp-server@latest\"],${RESET}"
+    log "${BLUE}      \"enabled\": true${RESET}"
+    log "${BLUE}    }${RESET}"
+    log "${BLUE}  }${RESET}"
+    log "${BLUE}}${RESET}"
+  fi
+}
+
 # Configure MCP for JSON-based clients
 configure_json_client() {
   local config_path="$1"
@@ -163,6 +293,20 @@ EOF
 
 # Auto-detect client
 detect_client() {
+  # Check for OpenCode (check for opencode.json/jsonc or opencode command)
+  if [ -f "opencode.json" ] || [ -f "opencode.jsonc" ] || command -v opencode &> /dev/null; then
+    echo "opencode"
+    return
+  fi
+
+  # Check for Amp (check for amp.mcpServers in settings.json or amp command)
+  if command -v amp &> /dev/null || \
+     grep -q "amp.mcpServers" ".vscode/settings.json" 2>/dev/null || \
+     grep -q "amp.mcpServers" "${HOME}/.vscode/settings.json" 2>/dev/null; then
+    echo "amp"
+    return
+  fi
+
   # Check for Codex
   if [ -f "${HOME}/.codex/config.toml" ] || command -v codex &> /dev/null; then
     echo "codex"
@@ -222,6 +366,10 @@ if [ "$detected_client" != "unknown" ]; then
 
     if [ "$detected_client" = "codex" ]; then
       configure_codex "$config_path"
+    elif [ "$detected_client" = "amp" ]; then
+      configure_amp "$config_path"
+    elif [ "$detected_client" = "opencode" ]; then
+      configure_opencode "$config_path"
     else
       configure_json_client "$config_path"
     fi
@@ -235,6 +383,8 @@ if [ "$detected_client" != "unknown" ]; then
 else
   log "${YELLOW}⚠️  Could not auto-detect MCP client.${RESET}"
   log "${BLUE}The package is ready to use. Configure manually:${RESET}"
+  log "${BLUE}  - OpenCode: Add to opencode.json or opencode.jsonc${RESET}"
+  log "${BLUE}  - Amp: Add to .vscode/settings.json or ~/.vscode/settings.json${RESET}"
   log "${BLUE}  - Codex: Add to ~/.codex/config.toml${RESET}"
   log "${BLUE}  - Cursor: Add to .cursor/mcp.json or ~/.cursor/mcp.json${RESET}"
   log "${BLUE}  - Claude Desktop: Add to config file${RESET}"