Skip to content
Open
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
57 changes: 57 additions & 0 deletions .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"
}
9 changes: 6 additions & 3 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/
Expand Down Expand Up @@ -39,6 +41,7 @@ skills/
testing/SKILL.md
testing/reference.md
ui-package/SKILL.md
very-good-analysis-upgrade/SKILL.md
```

## Skill File Format
Expand Down Expand Up @@ -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`

Expand Down
13 changes: 12 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand All @@ -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 |
Expand Down Expand Up @@ -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
Expand Down