Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,26 @@
"name": "contentsquare",
"source": "./plugins/contentsquare",
"description": "Query your Contentsquare analytics data directly from your AI coding agent using natural language."
},
{
"name": "contentsquare-android",
"source": "./plugins/contentsquare-android",
"description": "Integrate & manage Contentsquare SDK in Android apps with your AI agent."
},
{
"name": "contentsquare-ios",
"source": "./plugins/contentsquare-ios",
"description": "Integrate & manage Contentsquare SDK in iOS apps with your AI agent."
},
{
"name": "contentsquare-reactnative",
"source": "./plugins/contentsquare-reactnative",
"description": "Integrate & manage Contentsquare SDK in React Native apps with your AI agent."
},
{
"name": "contentsquare-flutter",
"source": "./plugins/contentsquare-flutter",
"description": "Integrate & manage Contentsquare SDK in Flutter apps with your AI agent."
}
]
}
20 changes: 20 additions & 0 deletions .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,26 @@
"name": "contentsquare",
"source": "plugins/contentsquare",
"description": "Query your Contentsquare analytics data directly from Cursor using natural language."
},
{
"name": "contentsquare-android",
"source": "plugins/contentsquare-android",
"description": "Integrate & manage Contentsquare SDK in Android apps with your AI agent."
},
{
"name": "contentsquare-ios",
"source": "plugins/contentsquare-ios",
"description": "Integrate & manage Contentsquare SDK in iOS apps with your AI agent."
},
{
"name": "contentsquare-reactnative",
"source": "plugins/contentsquare-reactnative",
"description": "Integrate & manage Contentsquare SDK in React Native apps with your AI agent."
},
{
"name": "contentsquare-flutter",
"source": "plugins/contentsquare-flutter",
"description": "Integrate & manage Contentsquare SDK in Flutter apps with your AI agent."
}
]
}
2 changes: 1 addition & 1 deletion .husky/pre-commit
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
#!/usr/bin/env sh
./scripts/sync-plugin.sh
git add plugins/*/skills/*/SKILL.md
git add plugins/*/skills/*/
56 changes: 38 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,16 @@ It ships as:

## What's included

Today this repository ships two plugins:
This repository currently ships the following plugins:

| Plugin | Type | Description |
|--------|------|-------------|
| `contentsquare-web` | Skill | Install & verify the Contentsquare tracking tag in any web project (Next.js, React, Vue, Angular, SvelteKit, Nuxt, static HTML). |
| `contentsquare` | MCP | Query your Contentsquare analytics data — journeys, funnels, error impact, page performance — in natural language. |
| Plugin | Type | Description |
| --------------------------- | ----- | -------------------------------------------------------------------------------------------------------------------------------- |
| `contentsquare-web` | Skill | Install & verify the Contentsquare tracking tag in any web project (Next.js, React, Vue, Angular, SvelteKit, Nuxt, static HTML). |
| `contentsquare` | MCP | Query your Contentsquare analytics data — journeys, funnels, error impact, page performance — in natural language. |
| `contentsquare-android` | Skill | Integrate & manage the Contentsquare SDK in Android applications. |
| `contentsquare-ios` | Skill | Integrate & manage the Contentsquare SDK in iOS applications. |
| `contentsquare-reactnative` | Skill | Integrate & manage the Contentsquare SDK in React Native applications. |
| `contentsquare-flutter` | Skill | Integrate & manage the Contentsquare SDK in Flutter applications. |

## What you can do

Expand All @@ -38,21 +42,37 @@ What are the top pages by sessions with errors on my main project?

### As a plugin (Claude Code & GitHub Copilot CLI)

Add the marketplace, then install the plugins you want.
Add the marketplace, then install **only the plugin(s) that match your project's stack**. You do not need to install all of them.

**Claude Code:**

```shell
/plugin marketplace add ContentSquare/agents

# 1. Choose the skill that matches your platform:
/plugin install contentsquare-web@contentsquare
# /plugin install contentsquare-android@contentsquare
# /plugin install contentsquare-ios@contentsquare
# /plugin install contentsquare-reactnative@contentsquare
# /plugin install contentsquare-flutter@contentsquare

# 2. (Optional) Install the MCP server for analytics querying:
/plugin install contentsquare@contentsquare
```

**GitHub Copilot CLI:**

```shell
copilot plugin marketplace add ContentSquare/agents

# 1. Choose the skill that matches your platform:
copilot plugin install contentsquare-web@contentsquare
# copilot plugin install contentsquare-android@contentsquare
# copilot plugin install contentsquare-ios@contentsquare
# copilot plugin install contentsquare-reactnative@contentsquare
# copilot plugin install contentsquare-flutter@contentsquare

# 2. (Optional) Install the MCP server for analytics querying:
copilot plugin install contentsquare@contentsquare
```

Expand All @@ -76,12 +96,12 @@ Works with Claude Code, Cursor, GitHub Copilot, and other compatible agents.

Copy the skills from this repository's `./skills` folder into the location your AI assistant uses for context discovery:

| Assistant | Recommended location |
|-----------|---------------------|
| Assistant | Recommended location |
| -------------- | -------------------------------------- |
| GitHub Copilot | `.github/skills/` or `.agents/skills/` |
| Cursor | `.cursor/rules/` or project root |
| Claude Code | `.claude/skills/` or project root |
| Any (generic) | `.agents/skills/` |
| Cursor | `.cursor/rules/` or project root |
| Claude Code | `.claude/skills/` or project root |
| Any (generic) | `.agents/skills/` |

You can verify a skill is discoverable by prompting your agent: "Which skills are available for you to use?".

Expand All @@ -91,12 +111,12 @@ For the MCP server, point your agent's MCP configuration at `https://api.content

The marketplaces reuse single authored sources; the rest are generated copies kept in sync by CI.

| Path | Role |
|------|------|
| `skills/<skill-name>/SKILL.md` | **Authored** source of each standalone skill |
| `plugins/<plugin-name>/` | **Authored** plugin (manifest, and bundled skills and/or `.mcp.json`) |
| `plugins/<plugin-name>/skills/<skill-name>/SKILL.md` | Generated copy of a skill — do not edit |
| `.claude-plugin/marketplace.json` | **Authored** marketplace catalog (Claude Code & Copilot) |
| `.cursor-plugin/marketplace.json` | **Authored** marketplace catalog (Cursor) |
| Path | Role |
| ---------------------------------------------------- | --------------------------------------------------------------------- |
| `skills/<skill-name>/SKILL.md` | **Authored** source of each standalone skill |
| `plugins/<plugin-name>/` | **Authored** plugin (manifest, and bundled skills and/or `.mcp.json`) |
| `plugins/<plugin-name>/skills/<skill-name>/SKILL.md` | Generated copy of a skill — do not edit |
| `.claude-plugin/marketplace.json` | **Authored** marketplace catalog (Claude Code & Copilot) |
| `.cursor-plugin/marketplace.json` | **Authored** marketplace catalog (Cursor) |

After editing an authored source, run `./scripts/sync-plugin.sh` and commit the result. CI fails if the generated copies drift.
19 changes: 19 additions & 0 deletions plugins/contentsquare-android/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
{
"name": "contentsquare-android",
"description": "Contentsquare SDK integration and management for Android applications.",
"version": "1.0.0",
"author": {
"name": "Contentsquare",
"url": "https://contentsquare.com"
},
"homepage": "https://docs.contentsquare.com/en/android/",
"repository": "https://github.com/ContentSquare/agents",
"license": "MIT",
"keywords": [
"contentsquare",
"analytics",
"android",
"mobile",
"sdk"
]
}
19 changes: 19 additions & 0 deletions plugins/contentsquare-android/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
{
"name": "contentsquare-android",
"description": "Contentsquare SDK integration and management for Android applications.",
"version": "1.0.0",
"author": {
"name": "Contentsquare",
"url": "https://contentsquare.com"
},
"homepage": "https://docs.contentsquare.com/en/android/",
"repository": "https://github.com/ContentSquare/agents",
"license": "MIT",
"keywords": [
"contentsquare",
"analytics",
"android",
"mobile",
"sdk"
]
}
Loading