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

package/README.md

@@ -1,15 +1,18 @@
 # Agent Skills for Clix
 
+[![npm version](https://img.shields.io/npm/v/%40clix-so%2Fclix-agent-skills.svg?logo=npm&label=npm)](https://www.npmjs.com/package/@clix-so/clix-agent-skills)
+[![npm downloads](https://img.shields.io/npm/dm/%40clix-so%2Fclix-agent-skills.svg)](https://www.npmjs.com/package/@clix-so/clix-agent-skills)
+
 This repository contains a collection of **Agent Skills for Clix**. Each skill
 is a self-contained package that can be loaded and executed by AI clients.
 
 ## Installing Skills
 
-Agents skills on this repository are built on the
+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/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 on supported AI clients. Depending on the AI client you are using, you
+can install skills in different ways.
 
 ### Universal CLI (Recommended)
 
@@ -18,9 +21,24 @@ 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>
+# Install a specific skill
+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
+npx @clix-so/clix-agent-skills@latest install --all --client cursor
+# This will install: integration, event-tracking, user-management
 ```
 
+### Available Skills
+
+- **clix-integration**: Integrate Clix Mobile SDK and MCP server setup
+- **clix-event-tracking**: Implement `Clix.trackEvent` with naming/schema best
+  practices and campaign-ready validation
+- **clix-user-management**: Implement `Clix.setUserId` + user properties with
+  logout best practices, personalization (`user.*`), and audience targeting
+
 **Supported Clients:**
 
 | Client         | Flag                | Default Path       |
@@ -45,10 +63,10 @@ following command:
 
 To install specific skills:
 
-1. Select `Browse and install plugins`
-2. Select `clix-agent-skills` from the list
+1. Visit the Marketplace section in `/plugin`
+2. Select `Browse plugins`
 3. Choose the skills you wish to install
-4. Click `Install` to proceed
+4. Install skill
 
 Alternatively, you can install a single skill directly by running:
 
@@ -56,6 +74,8 @@ Alternatively, you can install a single skill directly by running:
 /plugin install <plugin-name>@<marketplace-name>
 # For example
 /plugin install clix-integration@clix-agent-skills
+/plugin install clix-event-tracking@clix-agent-skills
+/plugin install clix-user-management@clix-agent-skills
 ```
 
 Remember to restart Claude Code after installation to load the new skills.
@@ -68,7 +88,9 @@ configuration directory:
 
 Or install a specific skill using the command line:
 
-```
+```bash
+$skill-installer install <link-to-skill-folder>
+# For example
 $skill-installer install https://github.com/clix-so/skills/tree/main/skills/integration
 ```
 
@@ -76,15 +98,14 @@ Ensure you restart Codex after installation to detect the new skills.
 
 ## Disclaimer
 
-Please be aware that **these skills may occasionally fail or execute
-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.
+Please be aware that these skills may occasionally fail or execute 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.
+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,42 @@ 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)")
+    .command("install [skill]")
+    .description("Install agent skill(s)")
+    .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")
     .action(async (skill, options) => {
     try {
-        await (0, install_1.installSkill)(skill, options);
+        if (options.all) {
+            await (0, install_1.installAllSkills)(options);
+        }
+        else if (skill) {
+            await (0, install_1.installSkill)(skill, options);
+        }
+        else {
+            console.error(chalk_1.default.red("Error: Please specify a skill name or use --all flag"));
+            process.exit(1);
+        }
     }
     catch (error) {
-        console.error(chalk_1.default.red("Error installing skill:"), error.message);
+        console.error(chalk_1.default.red("Error installing skill(s):"), getErrorMessage(error));
         process.exit(1);
     }
 });

package/dist/bin/commands/install.js

@@ -4,11 +4,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.installSkill = installSkill;
+exports.installAllSkills = installAllSkills;
 const path_1 = __importDefault(require("path"));
 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 +90,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,18 +107,74 @@ 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")}`);
     console.log(`  - Instruct your agent to read these docs to start working.`);
 }
+/**
+ * Find all available skills in the skills directory
+ */
+async function findAllSkills() {
+    // Find package root (same logic as installSkill)
+    let packageRoot = __dirname;
+    while (!fs_extra_1.default.existsSync(path_1.default.join(packageRoot, "package.json"))) {
+        const parent = path_1.default.dirname(packageRoot);
+        if (parent === packageRoot) {
+            packageRoot = process.cwd();
+            break;
+        }
+        packageRoot = parent;
+    }
+    const skillsDir = path_1.default.join(packageRoot, "skills");
+    if (!fs_extra_1.default.existsSync(skillsDir)) {
+        return [];
+    }
+    const entries = await fs_extra_1.default.readdir(skillsDir, { withFileTypes: true });
+    return entries
+        .filter((entry) => entry.isDirectory())
+        .filter((entry) => fs_extra_1.default.existsSync(path_1.default.join(skillsDir, entry.name, "SKILL.md")))
+        .map((entry) => entry.name);
+}
+/**
+ * Install all available skills
+ */
+async function installAllSkills(options) {
+    const spinner = (0, ora_1.default)("Discovering available skills...").start();
+    const skills = await findAllSkills();
+    if (skills.length === 0) {
+        spinner.fail("No skills found to install.");
+        return;
+    }
+    spinner.succeed(`Found ${chalk_1.default.bold(skills.length)} skill(s): ${skills.join(", ")}`);
+    console.log();
+    let successCount = 0;
+    let failCount = 0;
+    for (const skillName of skills) {
+        try {
+            await installSkill(skillName, options);
+            successCount++;
+        }
+        catch (error) {
+            console.error(chalk_1.default.red(`\n✗ Failed to install ${chalk_1.default.bold(skillName)}: ${getErrorMessage(error)}`));
+            failCount++;
+        }
+    }
+    console.log();
+    if (failCount === 0) {
+        console.log(chalk_1.default.green(`\n✔ Successfully installed all ${chalk_1.default.bold(successCount)} skill(s)!`));
+    }
+    else {
+        console.log(chalk_1.default.yellow(`\n⚠ Installed ${chalk_1.default.bold(successCount)} skill(s), ${chalk_1.default.bold(failCount)} failed.`));
+    }
+}