Przejdź do treści
Biblioteka skilli
AI i agenci · Budowanie i kod

developing-cursor-plugins

/developing-cursor-plugins

Prowadzi przez pełny cykl życia wtyczek Cursor: tworzenie, modyfikowanie, testowanie, wydawanie i utrzymanie, z gotowymi przepływami, wzorcami i przykładami.

Repozytorium
agent-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
5
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Prowadzi przez pełny cykl życia wtyczek Cursor: tworzenie, modyfikowanie, testowanie, wydawanie i utrzymanie, z gotowymi przepływami, wzorcami i przykładami.

Oryginalny opis (EN)

Use when working on Cursor plugins (creating, modifying, testing, releasing, or maintaining) - provides streamlined workflows, patterns, and examples for the complete Cursor plugin lifecycle

Jak działa

  1. Overview
  2. When to Use
  3. Quick Reference
  4. Plugin Development Workflow
  5. Critical Rules
Sekcje z nagłówków SKILL.md, w oryginale · 153 linii, 610 słów
Podgląd SKILL.md
---
name: developing-cursor-plugins
description: Use when working on Cursor plugins (creating, modifying, testing, releasing, or maintaining) - provides streamlined workflows, patterns, and examples for the complete Cursor plugin lifecycle
metadata:
  last_updated: "2026-06-05"
---

# Developing Cursor Plugins

## Overview

This skill provides efficient workflows for creating Cursor plugins. Use it to make plugin development fast and correct — it synthesizes official docs into actionable steps and covers Cursor-specific patterns like `.mdc` rules, plugin manifests, and MCP integration.

## When to Use

Use this skill when:
- Creating a new Cursor plugin from scratch
- Adding components to an existing plugin (rules, skills, commands, agents, hooks, MCP servers)
- Writing `.cursor/rules/*.mdc` rule files
- Setting up a local development environment for plugin testing
- Troubleshooting plugin structure or loading issues
- Understanding plugin architecture and component choices
- Releasing or distributing a plugin (Cursor Marketplace, cursor.directory, team marketplace)

**For comprehensive official documentation**, use the `working-with-cursor` skill to access full docs.

## Quick Reference

| Need to... | Read This | Official Docs |
|-----------|-----------|---------------|
| Understand directory structure | `references/plugin-structure.md` | `plugins.md` |
| Choose a component pattern | `references/common-patterns.md` | `plugins.md` |
| Write .cursor/rules/*.mdc files | `references/cursor-rules-guide.md` | `context-rules.md` |
| Debug plugin issues | `references/troubleshooting.md` | Various |

## Plugin Development Workflow

### Phase 1: Plan

Before writing anything:

1. **Define your plugin's purpose**
   - What problem does it solve?
   - Who will use it — personal, team, or public?
   - Which components are needed?

2. **Choose your pattern** (read `references/common-patterns.md`)
   - Rules only (lightweight context injection)?
   - Rules + skills (guidance + reusable workflows)?
   - MCP integration (external tool access)?
   - Full-featured platform (all component types)?

3. **Review installed plugins** at `~/.cursor/plugins/` for examples

### Phase 2: Create Structure

1. **Create directories**:
   ```bash
   mkdir -p my-plugin/.cursor-plugin
   mkdir -p my-plugin/rules my-plugin/skills my-plugin/commands
   ```

2. **Create the manifest** `.cursor-plugin/plugin.json`:
   ```json
   {
     "name": "my-plugin",
     "version": "1.0.0",
     "description": "What this plugin does",
     "author": { "name": "Your Name" }
   }
   ```

3. **Add components** (see `references/plugin-structure.md` for full layout)

### Phase 3: Develop

**Rules** (`.cursor/rules/*.mdc`) — unique to Cursor, read `references/cursor-rules-guide.md` first:
```yaml
---
description: When to apply this rule (used by AI for auto-discovery)
globs: ["**/*.ts", "**/*.tsx"]
alwaysApply: false
---
# Rule content here
```

**Skills** (`skills/skill-name/SKILL.md`):
```yaml
---
name: skill-name
description: What this skill does and when to invoke it
---
# Skill content
```

**MCP servers** (`.cursor/mcp.json` at plugin root):
```json
{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "my-mcp-package"]
    }
  }
}
```

### Phase 4: Test Locally

1. **Link plugin** for live iteration:
   ```bash
   ln -s $(pwd)/my-plugin ~/.cursor/plugins/local/my-plugin
   ```

2. **Reload Cursor** via `Developer: Reload Window` in command palette

3. **Verify loading** — check that rules appear, skills are discoverable, MCP tools connect

4. **Test each component**:
   - Rules: open a file matching the glob, confirm AI applies guidance
   - Skills: invoke via `/skill-name` in agent chat
   - MCP: check tool availability in agent context

### Phase 5: Release

**Distribution options:**
- **Cursor Marketplace** — official, reviewed, open-source: [cursor.com/marketplace/publish](https://cursor.com/marketplace/publish)
- **cursor.directory** — community platform for plugins and MCP servers
- **Team Marketplace** — internal GitHub repo, configured in Cursor team settings
- **Direct GitHub** — users install manually via local symlink

**Version bump:** Update `version` in `.cursor-plugin/plugin.json`, tag the release.

## Critical Rules

### `.cursor-plugin/` Contains ONLY the Manifest

❌ WRONG:
```
.cursor-plugin/
├── plugin.json
└── skills/          ← skills here
```

✅ CORRECT:
```
.cursor-plugin/
└── plugin.json      ← manifest only
skills/              ← components at plugin root
```

### Rules Live in `rules/` at Plugin Root

Rules bundled with a plugin go in `rules/*.mdc` at the plugin root. They are installed into `.cursor/rules/` when the plugin is activated — users should NOT hand-edit the installed copies.

### Use `.mdc` Extension for Rules

Rules in `.cursor/rules/` **must** use the `.mdc` extension. Plain `.md` files in that directory are ignored by Cursor.
Pliki w paczce (5)
  • SKILL.md 5 KB
  • references/common-patterns.md 5 KB
  • references/cursor-rules-guide.md 6 KB
  • references/plugin-structure.md 4 KB
  • references/troubleshooting.md 5 KB

Wersje

W bazie nie ma innych skilli o nazwie developing-cursor-plugins.

Migawka bazy z 13.11.2026 · wersja paczki 4189aef9afc8 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100developing-claude-code-plugins
    Prowadzi przez pełny cykl życia wtyczek Claude Code: tworzenie, modyfikowanie, testowanie, wydawanie i utrzymanie, z gotowymi przepływami, wzorcami i przykładami.
  • 100developing-codex-plugins
    Prowadzi przez pełny cykl życia wtyczek Codex: tworzenie, modyfikowanie, testowanie, wydawanie i utrzymanie, z gotowymi przepływami, wzorcami i materiałem referencyjnym.
  • 100cursor-custom-prompts
    Tworzy skuteczne własne prompty dla Cursor AI i pomaga z instrukcjami.
  • 100claude-plugins
    Prowadzi przez tworzenie i walidację plików plugin.json pluginów Claude Code oraz rozwiązywanie problemów z konfiguracją.
  • 100create-skill
    Prowadzi przez tworzenie, aktualizację i debugowanie skilli Agent Skills dla Cursor: format SKILL.md, struktura, katalog ~/.cursor/skills/ i dobre praktyki.
  • 90Claude Code Plugin Builder
    Tworzy pluginy Claude Code z manifestem, strukturą katalogów i komponentami: komendami, agentami, skillami, hookami i MCP.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.