Cursor Plugins #

This directory contains official plugins for Cursor.

Plugin Structure #

Each plugin follows a standard structure:

plugin-name/
├── .cursor/
│   └── plugin.json        # Plugin manifest (required)
├── README.md              # Plugin documentation
├── rules/                 # Cursor rules (.mdc files)
├── agents/                # Subagents (markdown files)
├── skills/                # Agent skills (directories with SKILL.md)
├── hooks/
│   └── hooks.json         # Hook configuration
├── mcp.json               # MCP server definitions (optional)
├── extensions/            # VS Code extensions (.vsix files)
├── scripts/               # Utility scripts for hooks
├── LICENSE
└── CHANGELOG.md

Plugin Components #

Creating a Plugin #

1. Create a new directory under plugins/
2. Add a .cursor/plugin.json manifest file
3. Add your components (rules, agents, skills, hooks, etc.)
4. Add a README.md documenting your plugin

See the boilerplate directory for a complete example.

Plugin Manifest #

The .cursor/plugin.json manifest is required and defines your plugin's metadata:

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "A brief description of what your plugin does",
  "author": {
    "name": "Your Name",
    "email": "you@example.com"
  },
  "license": "MIT",
  "keywords": ["example"],
  "agents": "./agents/",
  "skills": "./skills/",
  "rules": "./rules/",
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./mcp.json",
  "extensions": "./extensions/"
}

Available Plugins #

Installation #

Plugins can be installed via CLI:

agent install <plugin-name>

Or from a marketplace:

agent install <plugin-name>@<marketplace>

Contributing #

When adding a new plugin:

1. Follow the standard directory structure
2. Include a comprehensive README.md
3. Use semantic versioning (MAJOR.MINOR.PATCH)
4. Include a LICENSE file
5. Test your plugin thoroughly before submitting