@clix-so/clix-agent-skills 0.1.4 → 0.1.5

package/README.md

@@ -11,8 +11,8 @@ is a self-contained package that can be loaded and executed by AI clients.
 Agent skills in this repository are built on the
 [open agent skills standard](https://agentskills.io/home). Please refer to the
 [official documentation](https://agentskills.io/home#adoption) for up-to-date
-information on supported AI clients. Depending on the AI client you are using, you
-can install skills in different ways.
+information on supported AI clients. Depending on the AI client you are using,
+you can install skills in different ways.
 
 ### Universal CLI (Recommended)
 
@@ -20,15 +20,40 @@ For **Cursor**, **VS Code**, **Claude Desktop**, **OpenCode**, **Goose**,
 **GitHub Copilot**, **Amp**, and **Letta**, use our CLI tool to install skills
 and configure the Clix MCP Server automatically:
 
+#### Installation Modes
+
+The CLI supports two installation modes for skills:
+
+1. **Repo Root (Project-specific)** - Installs skills to the current project
+   directory (default)
+   - Skills are available only for the current project
+   - Best for project-specific configurations
+
+2. **System Root (Global)** - Installs skills to your home directory
+   - Skills are available across all projects
+   - Best for personal development setup
+
+**Note:** MCP (Model Context Protocol) server configuration is always set up
+globally (system root), regardless of the skill installation mode. This ensures
+the MCP server is available across all your projects.
+
 ```bash
-# Install a specific skill
+# Install a specific skill (repo root - default)
 npx @clix-so/clix-agent-skills@latest install <skill-name> --client <your-client>
 # For example, to install a skill on Cursor:
 npx @clix-so/clix-agent-skills@latest install integration --client cursor
 
-# Install all available skills at once
+# Install a specific skill globally (system root)
+npx @clix-so/clix-agent-skills@latest install <skill-name> --client <your-client> --global
+# For example:
+npx @clix-so/clix-agent-skills@latest install integration --client cursor --global
+
+# Install all available skills at once (repo root)
 npx @clix-so/clix-agent-skills@latest install --all --client cursor
 # This will install: integration, event-tracking, user-management
+
+# Install all available skills globally (system root)
+npx @clix-so/clix-agent-skills@latest install --all --client cursor --global
 ```
 
 ### Available Skills

package/dist/bin/cli.js

@@ -28,6 +28,7 @@ program
     .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)")
     .option("-a, --all", "Install all available skills")
+    .option("-g, --global", "Install globally to system root (default: installs to repo root)")
     .action(async (skill, options) => {
     try {
         if (options.all) {

package/dist/bin/commands/install.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.installSkill = installSkill;
 exports.installAllSkills = installAllSkills;
 const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const chalk_1 = __importDefault(require("chalk"));
 const ora_1 = __importDefault(require("ora"));
@@ -100,18 +101,23 @@ async function installSkill(skillName, options) {
                 relativeDest = options.client.startsWith(".") ? `${options.client}/skills` : `.clix/skills`;
         }
     }
-    const destPath = path_1.default.resolve(process.cwd(), relativeDest, skillName);
+    // Determine installation root: repo root (cwd) or system root (home directory)
+    const installRoot = options.global ? os_1.default.homedir() : process.cwd();
+    const destPath = path_1.default.resolve(installRoot, relativeDest, skillName);
     // 3. Copy Files
     try {
         await fs_extra_1.default.ensureDir(destPath);
         await fs_extra_1.default.copy(skillSourcePath, destPath);
-        spinner.succeed(`Skill files installed to ${chalk_1.default.green(relativeDest + "/" + skillName)}`);
+        const installLocation = options.global
+            ? `system root (${path_1.default.join(os_1.default.homedir(), relativeDest, skillName)})`
+            : `repo root (${path_1.default.join(process.cwd(), relativeDest, skillName)})`;
+        spinner.succeed(`Skill files installed to ${chalk_1.default.green(installLocation)}`);
     }
     catch (error) {
         spinner.fail(`Failed to copy skill files: ${getErrorMessage(error)}`);
         throw error;
     }
-    // 4. MCP Configuration
+    // 4. MCP Configuration (always global/system root)
     try {
         await (0, mcp_1.configureMCP)(options.client);
     }

package/dist/bin/utils/mcp.js

@@ -93,17 +93,13 @@ function createEmptyConfig(configKey) {
 }
 /**
  * Gets config path, key, and format for a specific client
+ * MCP configuration is always global (system root)
  */
 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
+            // MCP is always configured globally
             return {
                 path: path_1.default.join(home, ".cursor", "mcp.json"),
                 configKey: "mcpServers",
@@ -140,8 +136,9 @@ function getClientConfig(client) {
             return { path: ampConfigPath, configKey: "amp.mcpServers", format: "json" };
         }
         case "kiro":
+            // MCP is always configured globally
             return {
-                path: path_1.default.join(process.cwd(), ".kiro", "settings", "mcp.json"),
+                path: path_1.default.join(home, ".kiro", "settings", "mcp.json"),
                 configKey: "mcpServers",
                 format: "json",
             };
@@ -228,8 +225,9 @@ async function configureCodexTOML(configPath) {
     }
 }
 async function configureOpenCode() {
-    const configPath = path_1.default.join(process.cwd(), "opencode.json");
-    const nicePath = "opencode.json";
+    // MCP is always configured globally
+    const configPath = path_1.default.join(os_1.default.homedir(), "opencode.json");
+    const nicePath = path_1.default.join("~", "opencode.json");
     console.log(chalk_1.default.blue(`Checking MCP config at ${nicePath}...`));
     let config = {};
     if (!fs_extra_1.default.existsSync(configPath)) {
@@ -333,7 +331,7 @@ async function configureMCP(client) {
         await configureOpenCode();
         return;
     }
-    // Get client config
+    // Get client config (MCP is always global)
     const clientConfig = getClientConfig(targetClient);
     if (!clientConfig) {
         console.log(chalk_1.default.yellow(`Could not determine config path for ${targetClient}. Skipping.`));

package/llms.txt

@@ -0,0 +1,77 @@
+<!-- Clix Agent Skills llms.txt -->
+
+# Clix Agent Skills
+
+This file contains a comprehensive index of all Clix Agent Skills files.
+Each entry includes the file path, type, and description for semantic search.
+
+---
+
+## clix-event-tracking
+
+Implements Clix event tracking (Clix.trackEvent) with consistent naming, safe property schemas, and campaign-ready validation. Use when adding, reviewing, or debugging event tracking; when configuring event-triggered campaigns; or when the user mentions events, tracking, funnels, or properties.
+
+- [clix-event-tracking](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/event-tracking/SKILL.md): Implements Clix event tracking (Clix.trackEvent) with consistent naming, safe property schemas, and campaign-ready validation. Use when adding, reviewing, or debugging event tracking; when configuring event-triggered campaigns; or when the user mentions events, tracking, funnels, or properties.
+
+### References
+
+- [Campaign Mapping (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/event-tracking/references/campaign-mapping.md): Reference documentation for event-tracking skill
+- [Debugging (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/event-tracking/references/debugging.md): Reference documentation for event-tracking skill
+- [Implementation Patterns (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/event-tracking/references/implementation-patterns.md): Reference documentation for event-tracking skill
+- [Naming And Schema (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/event-tracking/references/naming-and-schema.md): Reference documentation for event-tracking skill
+- [Trackevent Contract (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/event-tracking/references/trackevent-contract.md): Reference documentation for event-tracking skill
+
+### Scripts
+
+- [Validate Event Plan (Script)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/event-tracking/scripts/validate-event-plan.sh): Utility script for event-tracking skill
+
+---
+
+## clix-integration
+
+Integrates Clix Mobile SDK into iOS, Android, Flutter, and React Native projects. Provides step-by-step guidance for installation, initialization, and verification. Use when the user asks to install, setup, or configure Clix analytics.
+
+- [clix-integration](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/SKILL.md): Integrates Clix Mobile SDK into iOS, Android, Flutter, and React Native projects. Provides step-by-step guidance for installation, initialization, and verification. Use when the user asks to install, setup, or configure Clix analytics.
+
+### References
+
+- [Error Handling (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/references/error-handling.md): Reference documentation for integration skill
+- [Framework Patterns (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/references/framework-patterns.md): Reference documentation for integration skill
+- [Mcp Integration (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/references/mcp-integration.md): Reference documentation for integration skill
+- [Sdk Reference (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/references/sdk-reference.md): Reference documentation for integration skill
+
+### Examples
+
+- [Android Integration (Example)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/examples/android-integration.kt): Code example for integration skill
+- [Flutter Integration (Example)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/examples/flutter-integration.dart): Code example for integration skill
+- [Ios Integration (Example)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/examples/ios-integration.swift): Code example for integration skill
+- [React Native Integration (Example)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/examples/react-native-integration.tsx): Code example for integration skill
+
+### Scripts
+
+- [Install Mcp (Script)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/scripts/install-mcp.sh): Utility script for integration skill
+- [Validate Sdk (Script)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/integration/scripts/validate-sdk.sh): Utility script for integration skill
+
+---
+
+## clix-user-management
+
+Implements Clix user identification and user properties (setUserId, removeUserId, setUserProperty/setUserProperties, removeUserProperty/removeUserProperties) with safe schemas, logout best practices, and campaign-ready personalization/audience usage. Use when the user mentions login/logout, userId, user properties, personalization, or audience targeting.
+
+- [clix-user-management](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/user-management/SKILL.md): Implements Clix user identification and user properties (setUserId, removeUserId, setUserProperty/setUserProperties, removeUserProperty/removeUserProperties) with safe schemas, logout best practices, and campaign-ready personalization/audience usage. Use when the user mentions login/logout, userId, user properties, personalization, or audience targeting.
+
+### References
+
+- [Debugging (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/user-management/references/debugging.md): Reference documentation for user-management skill
+- [Implementation Patterns (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/user-management/references/implementation-patterns.md): Reference documentation for user-management skill
+- [Logout And Switching (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/user-management/references/logout-and-switching.md): Reference documentation for user-management skill
+- [Personalization And Audience (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/user-management/references/personalization-and-audience.md): Reference documentation for user-management skill
+- [Property Schema (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/user-management/references/property-schema.md): Reference documentation for user-management skill
+- [User Management Contract (Reference)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/user-management/references/user-management-contract.md): Reference documentation for user-management skill
+
+### Scripts
+
+- [Validate User Plan (Script)](https://raw.githubusercontent.com/clix-so/skills/refs/heads/main/skills/user-management/scripts/validate-user-plan.sh): Utility script for user-management skill
+
+---
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clix-so/clix-agent-skills",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "An open collection of agent skills for Clix.",
   "main": "dist/index.js",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "dist",
-    "skills"
+    "skills",
+    "llms.txt"
   ],
   "scripts": {
     "build": "tsc",
@@ -18,9 +19,10 @@
     "lint": "prettier --check .",
     "lint:fix": "prettier --write .",
     "sync-version": "ts-node scripts/sync-version.ts",
+    "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"
+    "prepublishOnly": "npm run sync-version && npm run build && npm test && npm run generate-llms"
   },
   "keywords": [
     "clix",