> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clix.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills for Clix

> A collection of Clix Agent Skills designed to accelerate development, from initial SDK integration with MCP support to event tracking, user management, personalization templates, and API-triggered campaigns.

# Overview

<div style={{ display: "inline-flex", gap: 8, alignItems: "center", flexWrap: "wrap", marginTop: "-16px", marginBottom: "-24px" }}>
  <a href="https://www.npmjs.com/package/@clix-so/clix-agent-skills" aria-label="View the Clix Agent Skills package on npm" title="View the Clix Agent Skills package on npm" style={{ textDecoration: "none", borderBottom: "none", backgroundImage: "none", boxShadow: "none" }}>
    <span style={{ position: "absolute", width: 1, height: 1, padding: 0, margin: -1, overflow: "hidden", clip: "rect(0, 0, 0, 0)", whiteSpace: "nowrap", border: 0 }}>
      View the Clix Agent Skills package on npm
    </span>

    <img alt="npm version" src="https://img.shields.io/npm/v/%40clix-so%2Fclix-agent-skills.svg?logo=npm&label=npm" style={{ display: "block" }} />
  </a>

  <a href="https://www.npmjs.com/package/@clix-so/clix-agent-skills" aria-label="View Clix Agent Skills download stats on npm" title="View Clix Agent Skills download stats on npm" style={{ textDecoration: "none", borderBottom: "none", backgroundImage: "none", boxShadow: "none" }}>
    <span style={{ position: "absolute", width: 1, height: 1, padding: 0, margin: -1, overflow: "hidden", clip: "rect(0, 0, 0, 0)", whiteSpace: "nowrap", border: 0 }}>
      View Clix Agent Skills download stats on npm
    </span>

    <img alt="npm downloads" src="https://img.shields.io/npm/d18m/%40clix-so%2Fclix-agent-skills.svg" style={{ display: "block" }} />
  </a>
</div>

<p style={{ marginTop: "-8px" }}>
  This repository contains a collection of **Agent Skills for Clix**. Each skill
  is a separate module within this package that can be installed and used
  independently by AI clients.
</p>

## Available Skills

### Clix Skills

* **clix-integration**: Seamlessly integrate Clix Mobile SDK to your mobile
  application with Clix MCP Server
* **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
* **clix-personalization**: Author and debug personalization templates for
  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
* **clix-skill-creator**: Create new Clix agent skills by researching Clix SDK +
  docs via Clix MCP Server, then generating a complete skill folder (SKILL.md,
  references, scripts, examples) aligned with this repo’s conventions

### Skills for Mobile Developers

* **auditing-permission-ux**: Audit notification permission request UX and
  settings recovery flows for iOS and Android
* **auditing-deep-link-contracts**: Audit deep link contracts with cold/warm
  start test vectors and routing checks

## Installing Skills

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.

### Universal CLI (Recommended)

For Amp, Claude Code, Codex, Copilot, Cursor, Goose, Letta, OpenCode, and VS
Code, we recommend using our installer to set up the skills and automatically
configure the Clix MCP Server.

#### Installation Modes

The CLI supports two installation modes for skills:

**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.

**System Root (Global)** - Installs skills to your home directory. Skills are available across all projects. Best for personal development setup.

```bash theme={null}
# Install a specific skill (repo root - default)
# Default install path (when --client is omitted): .agents/skills/<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 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, personalization, api-triggered-campaigns, skill-creator, auditing-permission-ux, auditing-deep-link-contracts

# Install all available skills globally (system root)
npx @clix-so/clix-agent-skills@latest install --all --client cursor --global
```

**Supported Clients:**

| Client                  | Flag                   | Project Path       | System Path                     |
| ----------------------- | ---------------------- | ------------------ | ------------------------------- |
| Default (no `--client`) | *n/a*                  | `.agents/skills/`  | `~/.agents/skills/`             |
| Amp                     | `--client amp`         | `.agents/skills/`  | `~/.config/agents/skills/`      |
| Claude Code             | `--client claude`      | `.claude/skills/`  | `~/.claude/skills/`             |
| Codex                   | `--client codex`       | `.codex/skills/`   | `~/.codex/skills/`              |
| Cursor                  | `--client cursor`      | `.cursor/skills/`  | `~/.cursor/skills/`             |
| Factory                 | `--client factory`     | `.factory/skills/` | `~/.factory/skills/`            |
| Gemini CLI              | `--client gemini`      | `.gemini/skills/`  | `~/.gemini/skills/`             |
| Google Antigravity      | `--client antigravity` | `.agent/skills/`   | `~/.gemini/antigravity/skills/` |
| GitHub Copilot          | `--client github`      | `.github/skills/`  | `~/.github/skills/`             |
| Goose                   | `--client goose`       | `.agents/skills/`  | `~/.config/agents/skills/`      |
| Letta                   | `--client letta`       | `.skills/`         | `~/.skills/`                    |
| OpenCode                | `--client opencode`    | `.opencode/skill/` | `~/.opencode/skill/`            |
| VS Code                 | `--client vscode`      | `.vscode/skills/`  | `~/.vscode/skills/`             |

### Claude Code (Alternative setup via plugin marketplace)

To register this repository as a plugin marketplace in Claude Code, run the
following command:

```bash theme={null}
/plugin marketplace add clix-so/skills
```

To install specific skills:

1. Visit the Marketplace section in `/plugin`
2. Select `Browse plugins`
3. Choose the skills you wish to install
4. Install your preferred skill

Alternatively, you can install a single skill directly by running:

```bash theme={null}
/plugin install <plugin-name>@<marketplace-name>
# For example
/plugin install clix-integration@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.

### Codex (Alternative setup via skill-installer)

To manually install skills, save them from this repository into your Codex
configuration directory:
[https://developers.openai.com/codex/skills/#where-to-save-skills](https://developers.openai.com/codex/skills/#where-to-save-skills)

Or install a specific skill using the command line:

```bash theme={null}
$skill-installer install <link-to-skill-folder>
# For example
$skill-installer install https://github.com/clix-so/skills/tree/main/skills/integration
```

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.
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.txt` file located within each
skill's individual directory.

## Feedback & Contributions

We welcome bug reports, feature requests, and community contributions. If you have any feedback, please open an issue or pull request:

* GitHub repository: [https://github.com/clix-so/skills](https://github.com/clix-so/skills)
* Package & release notes: [https://www.npmjs.com/package/@clix-so/clix-agent-skills](https://www.npmjs.com/package/@clix-so/clix-agent-skills)