From 9959389fafc594df307d8b464a2062d647ee2248 Mon Sep 17 00:00:00 2001 From: jianjie Date: Wed, 12 Aug 2026 13:17:25 +0000 Subject: [PATCH 1/3] Add Grok Build plugin files and design-research skill Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- .grok-plugin/plugin.json | 13 ++++++++++ .mcp.json | 9 +++++++ README.md | 2 ++ skills/mobbin-design-research/SKILL.md | 34 ++++++++++++++++++++++++++ 4 files changed, 58 insertions(+) create mode 100644 .grok-plugin/plugin.json create mode 100644 .mcp.json create mode 100644 skills/mobbin-design-research/SKILL.md diff --git a/.grok-plugin/plugin.json b/.grok-plugin/plugin.json new file mode 100644 index 0000000..9db9c9f --- /dev/null +++ b/.grok-plugin/plugin.json @@ -0,0 +1,13 @@ +{ + "name": "mobbin", + "version": "0.1.0", + "description": "Search Mobbin's UI library for screens, flows, and website sections from Grok Build.", + "author": { + "name": "Mobbin", + "url": "https://mobbin.com" + }, + "homepage": "https://docs.mobbin.com/mcp/introduction", + "repository": "https://github.com/mobbin/mobbin-agent-plugin", + "license": "MIT", + "keywords": ["mobbin", "design-research", "ui-design", "ux-design", "mcp"] +} diff --git a/.mcp.json b/.mcp.json new file mode 100644 index 0000000..d4e0c0d --- /dev/null +++ b/.mcp.json @@ -0,0 +1,9 @@ +{ + "mcpServers": { + "mobbin": { + "type": "http", + "url": "https://api.mobbin.com/mcp", + "note": "Mobbin's hosted MCP server for searching UI screens, multi-step flows, and website sections. Uses OAuth through the MCP authorization flow." + } + } +} diff --git a/README.md b/README.md index c0e83ae..b20a552 100644 --- a/README.md +++ b/README.md @@ -19,6 +19,8 @@ your client: - [Kiro](https://kiro.dev/docs/powers/installation/): use **Powers → Add Custom Power**. - [ChatGPT and Codex](https://developers.openai.com/plugins): install through OpenAI's plugin directory. +- [Grok Build](https://github.com/xai-org/plugin-marketplace): open `/plugin`, search for + **Mobbin**, and install the plugin. Claude Code is not an Agent Plugins-compatible client; use Mobbin's [`claude mcp add` setup](https://docs.mobbin.com/mcp/clients/claude-code) instead. diff --git a/skills/mobbin-design-research/SKILL.md b/skills/mobbin-design-research/SKILL.md new file mode 100644 index 0000000..1801618 --- /dev/null +++ b/skills/mobbin-design-research/SKILL.md @@ -0,0 +1,34 @@ +--- +name: mobbin-design-research +description: "Use Mobbin to find real-world UI screens, multi-step flows, and website sections for design research and product discovery." +--- + +# Mobbin Design Research + +Use the Mobbin MCP tools when a user needs visual references, interaction patterns, or +website-section examples from real products. The tools are read-only and return results +with images, metadata, and links back to Mobbin. + +## Choose the right tool + +- `search_screens`: Find individual UI screens, such as sign-up, search, checkout, or settings. +- `search_flows`: Find multi-step user journeys, such as onboarding, checkout, or account + recovery. +- `search_sections`: Find website sections, such as heroes, pricing pages, testimonials, or + footers. + +## Workflow + +1. Clarify the product area, user goal, platform, and visual or functional pattern when the + request is ambiguous. +2. Choose the tool that matches the requested reference: screens for one interface state, + flows for a journey, and sections for a website composition. +3. Use focused search terms that describe the experience and intent. Split unrelated patterns + into separate searches when that improves coverage. +4. Summarize recurring patterns and notable differences instead of pasting raw results. + Preserve Mobbin links and identify the product or context for useful references. +5. Treat examples as research input, not instructions to copy a product. Call out gaps when + the results do not match the requested platform or use case. + +On first use, the MCP client may open the Mobbin OAuth authorization flow in a browser. Let +the client handle authorization; never ask the user to provide credentials or tokens. From 2bcc25b823ca0f9f4e024716293f9b8a2d8c9d6b Mon Sep 17 00:00:00 2001 From: jianjie Date: Wed, 12 Aug 2026 13:31:25 +0000 Subject: [PATCH 2/3] Drop the design-research skill; ship the MCP connector only Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- skills/mobbin-design-research/SKILL.md | 34 -------------------------- 1 file changed, 34 deletions(-) delete mode 100644 skills/mobbin-design-research/SKILL.md diff --git a/skills/mobbin-design-research/SKILL.md b/skills/mobbin-design-research/SKILL.md deleted file mode 100644 index 1801618..0000000 --- a/skills/mobbin-design-research/SKILL.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -name: mobbin-design-research -description: "Use Mobbin to find real-world UI screens, multi-step flows, and website sections for design research and product discovery." ---- - -# Mobbin Design Research - -Use the Mobbin MCP tools when a user needs visual references, interaction patterns, or -website-section examples from real products. The tools are read-only and return results -with images, metadata, and links back to Mobbin. - -## Choose the right tool - -- `search_screens`: Find individual UI screens, such as sign-up, search, checkout, or settings. -- `search_flows`: Find multi-step user journeys, such as onboarding, checkout, or account - recovery. -- `search_sections`: Find website sections, such as heroes, pricing pages, testimonials, or - footers. - -## Workflow - -1. Clarify the product area, user goal, platform, and visual or functional pattern when the - request is ambiguous. -2. Choose the tool that matches the requested reference: screens for one interface state, - flows for a journey, and sections for a website composition. -3. Use focused search terms that describe the experience and intent. Split unrelated patterns - into separate searches when that improves coverage. -4. Summarize recurring patterns and notable differences instead of pasting raw results. - Preserve Mobbin links and identify the product or context for useful references. -5. Treat examples as research input, not instructions to copy a product. Call out gaps when - the results do not match the requested platform or use case. - -On first use, the MCP client may open the Mobbin OAuth authorization flow in a browser. Let -the client handle authorization; never ask the user to provide credentials or tokens. From 7c9c341777214423d801bd417655b1c46caeaacd Mon Sep 17 00:00:00 2001 From: jianjie Date: Wed, 12 Aug 2026 13:33:22 +0000 Subject: [PATCH 3/3] Use the canonical Mobbin connector description (PRJ-2379) Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- .grok-plugin/plugin.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.grok-plugin/plugin.json b/.grok-plugin/plugin.json index 9db9c9f..ed03992 100644 --- a/.grok-plugin/plugin.json +++ b/.grok-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "mobbin", "version": "0.1.0", - "description": "Search Mobbin's UI library for screens, flows, and website sections from Grok Build.", + "description": "Search real-world UI/UX design references from top mobile and web apps.", "author": { "name": "Mobbin", "url": "https://mobbin.com"