@clix-so/clix-agent-skills 0.1.1

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

@@ -0,0 +1,284 @@
+# Clix MCP Server
+
+Clix MCP Server implements the
+[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) to enable LLMs
+to search Clix documentation and SDK code.
+
+## Integration Guide
+
+### Install
+
+You generally do **not** need a global install. The recommended setup runs the
+server via `npx` from your MCP client config.
+
+Optional global install (only if your client requires a direct binary on PATH):
+
+- **npm**:
+
+```bash
+npm i -g @clix-so/clix-mcp-server@latest
+```
+
+- **yarn**:
+
+```bash
+yarn global add @clix-so/clix-mcp-server@latest
+```
+
+### Configure .mcp.json
+
+Create or update the `.mcp.json` at your project root (or the configuration
+location your MCP client uses).
+
+Recommended configuration using `npx`:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```
+
+### Important: Server name affects tool namespace
+
+Most MCP clients expose tools with a prefix that matches the **server name**.
+For example, naming the server `clix-mcp-server` yields tools like:
+
+- `clix-mcp-server:search_docs`
+- `clix-mcp-server:search_sdk`
+
+If you name the server something else (e.g. `clix`), your tools will appear as
+`clix:*` and skills that expect `clix-mcp-server:*` will think the server is
+missing.
+
+### Use Clix MCP Server with Popular MCP Clients and IDEs
+
+#### Android Studio
+
+**Option 1: GitHub Copilot plugin in Android Studio**
+
+1. Settings > Tools > GitHub Copilot > Model Context Protocol (MCP) > Configure.
+2. Edit `mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```
+
+**Option 2: Using MCP Server plugin from JetBrains**
+
+1. Install "MCP Server" plugin from JetBrains.
+2. Configure client:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    },
+    "jetbrains": { "command": "npx", "args": ["-y", "@jetbrains/mcp-proxy"] }
+  }
+}
+```
+
+**Option 3: Gemini in Android Studio**
+
+1. [Add an MCP server to Gemini](https://developer.android.com/studio/gemini/add-mcp-server).
+2. Use standard configuration:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```
+
+#### Xcode
+
+**Option 1: GitHub Copilot for Xcode**
+
+1. Settings > MCP Configuration > Edit Config.
+2. Add:
+
+```json
+{
+  "servers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```
+
+**Option 2: XcodeBuildMCP**
+
+1. Add to your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    },
+    "XcodeBuildMCP": {
+      "command": "npx",
+      "args": ["-y", "xcodebuildmcp@latest"]
+    }
+  }
+}
+```
+
+#### Cursor
+
+**Manual setup**
+
+1. Cursor Settings > Tool & MCP > New MCP Server.
+2. Paste JSON and restart:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```
+
+#### Amazon Q
+
+**Manual setup**
+
+1. Open `~/.aws/amazonq/agents/default.json`.
+2. Add to `mcpServers`:
+
+```json
+"mcpServers": {
+  "clix-mcp-server": {
+    "command": "npx",
+    "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+  }
+}
+```
+
+#### Google Antigravity
+
+**Manual setup**
+
+1. Agent tab > ellipsis (...) > MCP Server > Manage MCP Servers.
+2. Add to `mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```
+
+#### VS Code
+
+**Manual setup**
+
+1. Open `~/.vscode/mcp.json`.
+2. Paste JSON and restart:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```
+
+#### Claude Code CLI
+
+**Command Line:**
+
+```bash
+claude mcp add --transport stdio clix-mcp-server -- npx -y @clix-so/clix-mcp-server@latest
+```
+
+**Marketplace:**
+
+```bash
+/plugin marketplace add clix-so/clix-mcp-server
+```
+
+#### Codex CLI
+
+**Setup**
+
+1. Open `~/.codex/config.toml`.
+2. Add and restart:
+
+```toml
+[mcp_servers]
+  # IMPORTANT: keep this name as "clix-mcp-server" so tools show up as
+  # `clix-mcp-server:*` (and not `clix:*`).
+  [mcp_servers."clix-mcp-server"]
+  command = "npx"
+  args = ["-y", "@clix-so/clix-mcp-server@latest"]
+```
+
+#### Kiro CLI
+
+**Setup**
+
+1. Open `.kiro/settings/mcp.json`.
+2. Add:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```
+
+#### Claude Desktop App
+
+**Setup**
+
+1. Open config
+   (`~/Library/Application Support/Claude/claude_desktop_config.json` or
+   `%APPDATA%\\Claude\\claude_desktop_config.json`).
+2. Add and restart:
+
+```json
+{
+  "mcpServers": {
+    "clix-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@clix-so/clix-mcp-server@latest"]
+    }
+  }
+}
+```

package/skills/integration/references/sdk-reference.md

@@ -0,0 +1,217 @@
+# Clix SDK API Reference
+
+Complete API documentation for Clix SDK across all platforms.
+
+## Core Initialization
+
+### Configuration
+
+All platforms use a configuration object with these fields:
+
+- `projectId` (required): Your Clix project ID
+- `apiKey` (optional): Public API key for analytics-only mode
+- `endpoint` (optional): Custom API endpoint URL
+- `logLevel` (optional): Logging verbosity level
+- `debug` (optional): Enable debug mode
+
+### Initialization Methods
+
+**iOS:**
+
+```swift
+Clix.initialize(config: ClixConfig)
+```
+
+**Android:**
+
+```kotlin
+Clix.initialize(context: Application, config: ClixConfig)
+```
+
+**React Native:**
+
+```typescript
+Clix.initialize(config);
+```
+
+## User Management
+
+### Set User ID
+
+Identify a user with a unique identifier:
+
+**All Platforms:**
+
+```swift/kotlin/typescript/javascript
+Clix.setUserId("user-123")
+```
+
+### Remove User ID
+
+Clear user identification:
+
+**All Platforms:**
+
+```swift/kotlin/typescript/javascript
+Clix.removeUserId()
+```
+
+### Set User Property
+
+Set a single user property:
+
+**All Platforms:**
+
+```swift/kotlin/typescript/javascript
+Clix.setUserProperty("plan", "premium")
+```
+
+### Set Multiple User Properties
+
+Set multiple properties at once:
+
+**All Platforms:**
+
+```swift/kotlin/typescript/javascript
+Clix.setUserProperties({
+  "plan": "premium",
+  "trial_days": 7
+})
+```
+
+### Remove User Property
+
+Remove a user property:
+
+**All Platforms:**
+
+```swift/kotlin/typescript/javascript
+Clix.removeUserProperty("plan")
+```
+
+## Event Tracking
+
+### Track Event
+
+Track a custom event:
+
+**All Platforms:**
+
+```swift/kotlin/typescript/javascript
+Clix.trackEvent("button_clicked", {
+  "button_name": "signup",
+  "location": "header"
+})
+```
+
+## Device Information
+
+### Get Device ID
+
+Retrieve the device identifier:
+
+**All Platforms:**
+
+```swift/kotlin/typescript/javascript
+const deviceId = await Clix.getDeviceId()
+```
+
+### Get Push Token
+
+Retrieve push notification token:
+
+**All Platforms:**
+
+```swift/kotlin/typescript
+const token = await Clix.Notification.getToken()
+```
+
+## Error Handling
+
+All SDK methods include error handling:
+
+**iOS:**
+
+```swift
+do {
+    try Clix.initialize(config: config)
+} catch {
+    print("Clix initialization failed: \(error)")
+}
+```
+
+**Android:**
+
+```kotlin
+try {
+    Clix.initialize(this, config)
+} catch (e: Exception) {
+    Log.e("Clix", "Initialization failed", e)
+}
+```
+
+**JavaScript/TypeScript:**
+
+```typescript
+try {
+  await Clix.initialize(config);
+} catch (error) {
+  console.error("Clix initialization failed:", error);
+}
+```
+
+## Platform-Specific Notes
+
+### iOS
+
+- Requires iOS 14+
+- Swift 5.5+ for async/await support
+- Thread-safe implementation
+- Supports both CocoaPods and Swift Package Manager
+
+### Android
+
+- Requires Android API 21+ (Android 5.0)
+- Kotlin coroutines for async operations
+- Lifecycle-aware operations
+- Supports Gradle dependency management
+
+### React Native
+
+- Requires React Native 0.60+
+- Native module bridge for iOS/Android
+- Unified JavaScript API
+- Supports TurboModules
+
+## SDK Versioning
+
+SDK versions follow semantic versioning (major.minor.patch).
+
+Check current version:
+
+- **iOS**: Check Podfile.lock or Package.resolved
+- **Android**: Check build.gradle dependencies
+- **JavaScript**: Check package.json or package-lock.json
+
+## Rate Limiting
+
+SDK automatically handles rate limiting:
+
+- Events are batched and sent efficiently
+- Failed requests are retried with exponential backoff
+- Network errors are handled gracefully
+
+## Privacy & Security
+
+- All data is encrypted in transit (HTTPS)
+- No sensitive user data is collected by default
+- GDPR and CCPA compliant
+- User data can be deleted on request
+
+## Support
+
+For detailed API documentation, visit:
+
+- iOS: https://github.com/clix-so/clix-ios-sdk
+- Android: https://github.com/clix-so/clix-android-sdk
+- React Native: https://github.com/clix-so/clix-react-native-sdk