@clix-so/clix-agent-skills 0.1.2 → 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.2",
+  "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
@@ -124,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:
@@ -239,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:
@@ -389,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)