From e7c91e3ff92cda0d4b8a879193f1c114a3a82c3d Mon Sep 17 00:00:00 2001
From: Alvaro Armijos <56322173+alvaroarmijos@users.noreply.github.com>
Date: Sun, 12 Apr 2026 19:28:47 -0500
Subject: [PATCH] feat: add Cursor plugin support

Add .cursor-plugin/plugin.json manifest for Cursor IDE, update README with Cursor installation instructions using /add-plugin, and update CLAUDE.md to reflect the dual Claude Code/Cursor support.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .cursor-plugin/plugin.json | 57 ++++++++++++++++++++++++++++++++++++++
 CLAUDE.md                  |  9 ++++--
 README.md                  | 13 ++++++++-
 3 files changed, 75 insertions(+), 4 deletions(-)
 create mode 100644 .cursor-plugin/plugin.json

diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
new file mode 100644
index 0000000..2b372bf
--- /dev/null
+++ b/.cursor-plugin/plugin.json
@@ -0,0 +1,57 @@
+{
+  "name": "vgv-ai-flutter-plugin",
+  "version": "0.0.2",
+  "description": "Best-practice skills for Flutter and Dart covering accessibility, BLoC, testing, theming, navigation, security, internationalization, and architecture — plus automated dart analyze and format hooks.",
+  "homepage": "https://github.com/VeryGoodOpenSource/vgv-ai-flutter-plugin",
+  "repository": "https://github.com/VeryGoodOpenSource/vgv-ai-flutter-plugin",
+  "license": "MIT",
+  "author": {
+    "name": "Very Good Ventures",
+    "email": "hello@verygood.ventures"
+  },
+  "keywords": [
+    "a11y",
+    "accessibility",
+    "analyze",
+    "architecture",
+    "bloc",
+    "bloc-test",
+    "code-quality",
+    "create-project",
+    "dart",
+    "deep-linking",
+    "flutter",
+    "format",
+    "go-router",
+    "golden-testing",
+    "hooks",
+    "i18n",
+    "internationalization",
+    "l10n",
+    "layered-architecture",
+    "lint",
+    "localization",
+    "material-3",
+    "mcp",
+    "mobile-security",
+    "mocktail",
+    "monorepo",
+    "navigation",
+    "owasp",
+    "screen-reader",
+    "security",
+    "semantics",
+    "state-management",
+    "testing",
+    "theming",
+    "very-good-cli",
+    "ui-package",
+    "wcag",
+    "widget-testing",
+    "sdk-upgrade",
+    "dart-sdk",
+    "flutter-sdk"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json"
+}
diff --git a/CLAUDE.md b/CLAUDE.md
index 2f6192a..d89ff06 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,14 +4,16 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-VGV AI Flutter Plugin is a Claude Code plugin that provides best-practices skills for Flutter and Dart development. It is a **documentation-only repository** — there is no Dart/Flutter source code, no `pubspec.yaml`, and no tests. All value lives in the markdown skill files.
+VGV AI Flutter Plugin is a plugin for **Claude Code** and **Cursor** that provides best-practices skills for Flutter and Dart development. It is a **documentation-only repository** — there is no Dart/Flutter source code, no `pubspec.yaml`, and no tests. All value lives in the markdown skill files.
 
 ## Repository Structure
 
 ```text
 .mcp.json                # MCP server configuration (Very Good CLI)
 .claude-plugin/
-  plugin.json          # Plugin manifest (name, version, tags)
+  plugin.json          # Claude Code plugin manifest (name, version, tags)
+.cursor-plugin/
+  plugin.json          # Cursor plugin manifest — maps skills/, hooks/, and .mcp.json
 hooks/
   hooks.json           # Hook definitions (PreToolUse and PostToolUse)
   scripts/
@@ -39,6 +41,7 @@ skills/
   testing/SKILL.md
   testing/reference.md
   ui-package/SKILL.md
+  very-good-analysis-upgrade/SKILL.md
 ```
 
 ## Skill File Format
@@ -66,7 +69,7 @@ Every `SKILL.md` follows this structure:
 ## Adding a New Skill
 
 1. Create `skills/<skill_name>/SKILL.md` following the format above
-2. Update tags in `.claude-plugin/plugin.json`
+2. Update tags in `.claude-plugin/plugin.json` and `.cursor-plugin/plugin.json`
 3. Update the skills table in `README.md` (skill name must link to the `SKILL.md` file)
 4. Update the repository structure in `CLAUDE.md`
 
diff --git a/README.md b/README.md
index 1d8240d..3aa03e6 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ VGV AI Flutter Plugin is a collection of contextual best-practices skills that C
 
 ## Installation
 
-### From the Marketplace
+### Claude Code
 
 Inside Claude Code:
 
@@ -24,6 +24,16 @@ Inside Claude Code:
 
 For more details, see the [Very Good Claude Marketplace][marketplace_link].
 
+### Cursor
+
+Inside Cursor's AI chat or composer:
+
+```bash
+/add-plugin vgv-ai-flutter-plugin
+```
+
+Or install from the [Cursor Marketplace][cursor_marketplace_link].
+
 ## Skills
 
 | Skill | Description |
@@ -116,6 +126,7 @@ This plugin includes a `.mcp.json` configuration that connects Claude Code to th
 The `.mcp.json` file at the project root registers a `very-good-cli` MCP server using stdio transport. When Claude Code detects this configuration, it connects to the Very Good CLI MCP server and gains access to the tools above. The skills continue to provide knowledge and best practices while the MCP tools handle execution.
 
 [marketplace_link]: https://github.com/VeryGoodOpenSource/very_good_claude_marketplace
+[cursor_marketplace_link]: https://cursor.com/marketplace
 [claude_code_link]: https://claude.ai/code
 [vgv_link]: https://verygood.ventures
 [very_good_ventures_link_dark]: https://verygood.ventures#gh-dark-mode-only