Package the repo as a Mobbin agent plugin

.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://code.claude.com/schemas/marketplace.json",
+  "name": "mobbin",
+  "description": "Official Mobbin plugins.",
+  "owner": {
+    "name": "Mobbin",
+    "email": "support@mobbin.com",
+    "url": "https://mobbin.com"
+  },
+  "plugins": [
+    {
+      "name": "mobbin",
+      "source": "./",
+      "description": "Mobbin MCP server and skills for finding real-world app screens, flows, and website sections while designing and building UI.",
+      "homepage": "https://docs.mobbin.com/mcp/introduction",
+      "repository": "https://github.com/mobbin/skills",
+      "license": "MIT"
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "mobbin",
+  "version": "1.1.0",
+  "description": "Mobbin MCP server and skills for finding real-world app screens, flows, and website sections while designing and building UI.",
+  "mcpServers": "./mcp.json",
+  "author": {
+    "name": "Mobbin",
+    "email": "support@mobbin.com",
+    "url": "https://mobbin.com"
+  },
+  "homepage": "https://docs.mobbin.com/mcp/introduction",
+  "repository": "https://github.com/mobbin/skills",
+  "license": "MIT",
+  "keywords": ["mobbin", "design", "mcp", "ui", "ux"]
+}

.cursor-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "mobbin",
+  "displayName": "Mobbin",
+  "version": "1.1.0",
+  "description": "Mobbin MCP server and skills for finding real-world app screens, flows, and website sections while designing and building UI.",
+  "author": {
+    "name": "Mobbin",
+    "email": "support@mobbin.com",
+    "url": "https://mobbin.com"
+  },
+  "homepage": "https://docs.mobbin.com/mcp/introduction",
+  "repository": "https://github.com/mobbin/skills",
+  "license": "MIT",
+  "keywords": ["mobbin", "design", "mcp", "ui", "ux"]
+}

.github/workflows/validate.yml

@@ -0,0 +1,21 @@
+name: Validate
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npm run validate

.gitignore

@@ -1,2 +1,3 @@
 .DS_Store
 .env*.local
+node_modules/

.grok-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "mobbin",
+  "displayName": "Mobbin",
+  "version": "1.1.0",
+  "description": "Mobbin MCP server and skills for finding real-world app screens, flows, and website sections while designing and building UI.",
+  "author": {
+    "name": "Mobbin",
+    "email": "support@mobbin.com",
+    "url": "https://mobbin.com"
+  },
+  "homepage": "https://docs.mobbin.com/mcp/introduction",
+  "repository": "https://github.com/mobbin/skills",
+  "license": "MIT",
+  "keywords": ["mobbin", "design", "mcp", "ui", "ux"],
+  "skills": "./skills/",
+  "mcpServers": "./mcp.json"
+}

README.md

@@ -2,18 +2,10 @@
 
 Agent skills for [Mobbin](https://mobbin.com) — the world's largest library of real app UI screenshots.
 
-## Prerequisites
-
-- **Mobbin MCP Server** — these skills require the Mobbin MCP server (`api.mobbin.com/mcp`) to be configured in your AI coding agent. Add it to your MCP client config:
-  ```json
-  {
-    "mcpServers": {
-      "mobbin": {
-        "url": "https://api.mobbin.com/mcp"
-      }
-    }
-  }
-  ```
+## What's included
+
+- **Skills** in [`skills/`](skills/). They teach the agent when and how to use Mobbin.
+- **The Mobbin MCP server** at `https://api.mobbin.com/mcp`. The plugin installs it for you. On first use your agent opens a browser to sign in to Mobbin. You need a Pro, Team, or Enterprise plan.
 
 ## Available Skills
 
@@ -35,11 +27,42 @@ Search Mobbin for real app screenshots and visually analyze them before answerin
 
 ## Installation
 
+Where your agent supports plugins, install the plugin. It sets up the skills and the MCP server together.
+
+### Claude Code
+
+```
+/plugin marketplace add mobbin/skills
+/plugin install mobbin@mobbin
+```
+
+### VS Code / GitHub Copilot
+
+1. Turn on `chat.plugins.enabled` in VS Code settings.
+2. Run **Chat: Install Plugin From Source** from the Command Palette.
+3. Enter `https://github.com/mobbin/skills`.
+
+### Cursor
+
+Install **Mobbin** from the [Cursor Marketplace](https://cursor.com/marketplace).
+
+### Other agents: skills only
+
 ```bash
 npx skills add mobbin/skills
 ```
 
-Skills are automatically available once installed. The agent will use them when relevant tasks are detected.
+This installs only the skills, so add the MCP server to your agent's MCP config yourself:
+
+```json
+{
+  "mcpServers": {
+    "mobbin": {
+      "url": "https://api.mobbin.com/mcp"
+    }
+  }
+}
+```
 
 <details>
 <summary>Manual installation</summary>
@@ -52,9 +75,7 @@ cp -r skills/skills/* ~/.claude/skills/
 On Claude.ai, add the contents of a skill's `SKILL.md` to your project knowledge.
 </details>
 
-## Contributing
-
-To add a new skill, create a directory under `skills/` with a `SKILL.md` file following the [Agent Skills](https://agentskills.io/) format.
+The MCP server on its own, for clients without plugin support, is documented in [`mobbin/mobbin-mcp-server`](https://github.com/mobbin/mobbin-mcp-server).
 
 ## License
 

mcp.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+  "mcpServers": {
+    "mobbin": {
+      "type": "streamable-http",
+      "url": "https://api.mobbin.com/mcp"
+    }
+  }
+}

package.json

@@ -0,0 +1,11 @@
+{
+  "name": "mobbin-skills",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "validate": "node scripts/validate.mjs"
+  },
+  "devDependencies": {
+    "ajv": "8.20.0"
+  }
+}

plugin.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "mobbin",
+  "version": "1.1.0",
+  "description": "Mobbin MCP server and skills for finding real-world app screens, flows, and website sections while designing and building UI.",
+  "author": {
+    "name": "Mobbin",
+    "email": "support@mobbin.com",
+    "url": "https://mobbin.com"
+  },
+  "homepage": "https://docs.mobbin.com/mcp/introduction",
+  "repository": "https://github.com/mobbin/skills",
+  "license": "MIT",
+  "keywords": ["mobbin", "design", "mcp", "ui", "ux"]
+}