Skip to content

Cursor plugin specification and official plugins

TypeScript

Rename cursor-picks to cursor-dev-kit

ericzakariassonb52a8d55addf
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 19620bb4..60b354e7 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -5,133 +5,73 @@
"email": "[email protected]"
},
"metadata": {
- "description": "Official Cursor plugin marketplace — developer tools, framework rules, MCP integrations, and agent skills"
+ "description": "Official Cursor plugin marketplace \u2014 developer tools, framework rules, MCP integrations, and agent skills"
},
"plugins": [
{
- "name": "deep-learning-python",
- "source": "deep-learning-python",
- "description": "Deep learning, transformers, and diffusion model development rules by Yu Changqian (cursor.directory)"
+ "name": "frontend",
+ "source": "frontend",
+ "description": "Cursor plugin for frontend engineering workflows \u2014 React, TypeScript, accessibility, and performance"
},
{
- "name": "django-python",
- "source": "django-python",
- "description": "Django and scalable Python web application development rules by Caio Barbieri (cursor.directory)"
+ "name": "design",
+ "source": "design",
+ "description": "Cursor plugin for product design workflows \u2014 UX specs, design systems, handoff, and iteration"
},
{
- "name": "docker",
- "source": "docker",
- "description": "Cursor plugin for Docker — Dockerfiles, Compose, multi-stage builds, and container best practices"
+ "name": "data-science",
+ "source": "data-science",
+ "description": "Cursor plugin for data science workflows \u2014 analysis, modeling, experimentation, and reporting"
},
{
- "name": "elixir-phoenix",
- "source": "elixir-phoenix",
- "description": "Elixir, Phoenix, LiveView, and Tailwind development rules by Ilyich Vismara (cursor.directory)"
+ "name": "ios",
+ "source": "ios",
+ "description": "Cursor plugin for iOS development \u2014 Swift, SwiftUI, architecture, and testing"
},
{
- "name": "fastapi-python",
- "source": "fastapi-python",
- "description": "FastAPI and scalable Python API development rules by Caio Barbieri (cursor.directory)"
+ "name": "android",
+ "source": "android",
+ "description": "Cursor plugin for Android development \u2014 Kotlin, Jetpack Compose, architecture, and testing"
},
{
- "name": "firebase",
- "source": "firebase",
- "description": "Cursor plugin for Firebase — Firestore, Authentication, Cloud Functions, Hosting, and Storage"
+ "name": "planning",
+ "source": "planning",
+ "description": "Cursor plugin for software planning \u2014 scope, milestones, risk management, and execution plans"
},
{
- "name": "flutter-dart",
- "source": "flutter-dart",
- "description": "Flutter and Dart clean architecture development rules by Sercan Yusuf (cursor.directory)"
+ "name": "code-review",
+ "source": "code-review",
+ "description": "Cursor plugin for code review workflows \u2014 correctness, security, regressions, and actionable feedback"
},
{
- "name": "frontend-developer",
- "source": "frontend-developer",
- "description": "Expert React, Next.js, TypeScript, and Tailwind CSS development rules by Mohammadali Karimi (cursor.directory)"
+ "name": "web-browser",
+ "source": "web-browser",
+ "description": "Cursor plugin for browser debugging workflows \u2014 DevTools, network traces, and reproducible bug reports"
},
{
- "name": "github",
- "source": "github",
- "description": "Cursor plugin for GitHub — Actions, API, CLI, Pull Requests, and repository management"
+ "name": "teaching",
+ "source": "teaching",
+ "description": "Cursor plugin for teaching workflows \u2014 explain concepts, scaffold exercises, and assess understanding"
},
{
- "name": "go-api-development",
- "source": "go-api-development",
- "description": "Go API development with standard library (1.22+) rules by Marvin Kaunda (cursor.directory)"
+ "name": "documentation",
+ "source": "documentation",
+ "description": "Cursor plugin for technical documentation workflows \u2014 READMEs, API docs, architecture notes, and changelogs"
},
{
- "name": "laravel-tallstack",
- "source": "laravel-tallstack",
- "description": "Laravel TALL Stack (Tailwind, Alpine.js, Livewire, Laravel) with DaisyUI rules by Ismael Fi (cursor.directory)"
+ "name": "presentation-pptx",
+ "source": "presentation-pptx",
+ "description": "Cursor plugin for presentation authoring \u2014 narrative design, slide outlines, and PPTX-ready content"
},
{
- "name": "launchdarkly",
- "source": "launchdarkly",
- "description": "Cursor plugin for LaunchDarkly — feature flags, experimentation, progressive rollouts, and targeting"
+ "name": "learning",
+ "source": "learning",
+ "description": "Cursor plugin for learning workflows \u2014 skill mapping, practice plans, and feedback loops"
},
{
- "name": "mongodb",
- "source": "mongodb",
- "description": "Cursor plugin for MongoDB — schema design, queries, aggregation, indexes, and Mongoose ODM"
- },
- {
- "name": "nextjs-react-typescript",
- "source": "nextjs-react-typescript",
- "description": "Next.js App Router, React, Shadcn UI, and Tailwind development rules by Pontus Abrahamsson (cursor.directory)"
- },
- {
- "name": "playwright-testing",
- "source": "playwright-testing",
- "description": "Playwright end-to-end testing and QA automation rules by Douglas Urrea Ocampo (cursor.directory)"
- },
- {
- "name": "rails-ruby",
- "source": "rails-ruby",
- "description": "Ruby on Rails, PostgreSQL, Hotwire, and Tailwind development rules by Theo Vararu (cursor.directory)"
- },
- {
- "name": "rust-async",
- "source": "rust-async",
- "description": "Rust async programming and concurrent systems development rules by Sheng-Yan, Zhang (cursor.directory)"
- },
- {
- "name": "sentry",
- "source": "sentry",
- "description": "Cursor plugin for Sentry — error monitoring, performance tracking, session replay, and alerting"
- },
- {
- "name": "slack",
- "source": "slack",
- "description": "Cursor plugin for Slack — Bolt framework, Block Kit, Events API, and Slack app development"
- },
- {
- "name": "solidity-web3",
- "source": "solidity-web3",
- "description": "Solidity smart contract security and development best practices by Alfredo Bonilla (cursor.directory)"
- },
- {
- "name": "sveltekit-development",
- "source": "sveltekit-development",
- "description": "Svelte 5 and SvelteKit modern web development guide by MMBytes (cursor.directory)"
- },
- {
- "name": "swiftui-ios",
- "source": "swiftui-ios",
- "description": "SwiftUI and Swift iOS/macOS development rules by Josh Pigford (cursor.directory)"
- },
- {
- "name": "terraform-iac",
- "source": "terraform-iac",
- "description": "Terraform and cloud Infrastructure as Code best practices by Abdeldjalil Sichaib (cursor.directory)"
- },
- {
- "name": "twilio",
- "source": "twilio",
- "description": "Cursor plugin for Twilio — SMS, Voice, WhatsApp, Verify, and communications APIs"
- },
- {
- "name": "unity-gamedev",
- "source": "unity-gamedev",
- "description": "C# Unity game development and design patterns rules by Pontus Abrahamsson (cursor.directory)"
+ "name": "cursor-dev-kit",
+ "source": "cursor-dev-kit",
+ "description": "Cursor Dev Kit \u2014 internal-style workflows used by Cursor developers for CI, code review, shipping, and testing"
}
]
-}
+}
\ No newline at end of file
diff --git a/README.md b/README.md
index 63962431..6a6ff114 100644
--- a/README.md
+++ b/README.md
@@ -14,23 +14,19 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| [MongoDB](mongodb/) | Backend | Schema design, queries, aggregation, indexes, and Mongoose |
| [Twilio](twilio/) | SaaS | SMS, Voice, WhatsApp, Verify, and communications APIs |
| [Slack](slack/) | SaaS | Bolt framework, Block Kit, Events API, and app development |
-| [Next.js React TypeScript](nextjs-react-typescript/) | Frontend | Next.js App Router, React, Shadcn UI, and Tailwind rules |
-| [Frontend Developer](frontend-developer/) | Frontend | React, Next.js, TypeScript, and Tailwind CSS development rules |
-| [SvelteKit](sveltekit-development/) | Frontend | Svelte 5 and SvelteKit modern web development guide |
-| [Flutter Dart](flutter-dart/) | Mobile | Flutter and Dart clean architecture development rules |
-| [SwiftUI iOS](swiftui-ios/) | Mobile | SwiftUI and Swift iOS/macOS development rules |
-| [FastAPI Python](fastapi-python/) | Backend | FastAPI and scalable Python API development rules |
-| [Django Python](django-python/) | Backend | Django and scalable Python web application rules |
-| [Rails Ruby](rails-ruby/) | Backend | Ruby on Rails, PostgreSQL, Hotwire, and Tailwind rules |
-| [Elixir Phoenix](elixir-phoenix/) | Backend | Elixir, Phoenix, LiveView, and Tailwind development rules |
-| [Laravel TALL Stack](laravel-tallstack/) | Backend | Laravel TALL Stack (Tailwind, Alpine.js, Livewire) with DaisyUI |
-| [Go API Development](go-api-development/) | Backend | Go API development with standard library (1.22+) rules |
-| [Rust Async](rust-async/) | Systems | Rust async programming and concurrent systems rules |
-| [Playwright Testing](playwright-testing/) | Testing | Playwright end-to-end testing and QA automation rules |
-| [Unity GameDev](unity-gamedev/) | GameDev | C# Unity game development and design patterns rules |
-| [Deep Learning Python](deep-learning-python/) | ML | Deep learning, transformers, and diffusion model rules |
-| [Terraform IaC](terraform-iac/) | DevOps | Terraform and cloud Infrastructure as Code best practices |
-| [Solidity Web3](solidity-web3/) | Blockchain | Solidity smart contract security and development rules |
+| [Frontend](frontend/) | Developer Tools | React, TypeScript, accessibility, and performance workflows |
+| [Design](design/) | Utilities | UX specs, design systems, handoff, and iteration workflows |
+| [Data Science](data-science/) | Utilities | Analysis, modeling, experimentation, and reporting workflows |
+| [iOS](ios/) | Developer Tools | Swift, SwiftUI, architecture, and testing workflows |
+| [Android](android/) | Developer Tools | Kotlin, Jetpack Compose, architecture, and testing workflows |
+| [Planning](planning/) | Utilities | Scope, milestones, risk management, and execution planning |
+| [Code Review](code-review/) | Developer Tools | Correctness, security, regression checks, and actionable feedback |
+| [Web Browser](web-browser/) | Developer Tools | DevTools-driven debugging, network traces, and repro workflows |
+| [Teaching](teaching/) | Utilities | Concept explanations, exercises, and understanding checks |
+| [Documentation](documentation/) | Utilities | READMEs, API docs, architecture notes, and changelog writing |
+| [Presentation PPTX](presentation-pptx/) | Utilities | Narrative design, slide outlines, and PPTX-ready content |
+| [Learning](learning/) | Utilities | Skill maps, practice plans, and feedback loops |
+| [Cursor Dev Kit](cursor-dev-kit/) | Developer Tools | Internal-style workflows for CI, code review, shipping, and testing |
## Repository Structure
diff --git a/cursor-dev-kit/.cursor-plugin/plugin.json b/cursor-dev-kit/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..7dfe5cba
--- /dev/null
+++ b/cursor-dev-kit/.cursor-plugin/plugin.json
@@ -0,0 +1,29 @@
+{
+ "name": "cursor-dev-kit",
+ "version": "1.0.0",
+ "description": "Cursor Dev Kit — internal-style workflows used by Cursor developers for CI, code review, shipping, and testing",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://github.com/cursor/plugins",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "keywords": [
+ "cursor-dev-kit",
+ "ci",
+ "code-review",
+ "shipping",
+ "testing"
+ ],
+ "category": "developer-tools",
+ "tags": [
+ "internal-workflows",
+ "quality",
+ "delivery"
+ ],
+ "skills": "./skills/",
+ "commands": "./commands/",
+ "agents": "./agents/",
+ "rules": "./rules/"
+}
diff --git a/cursor-dev-kit/LICENSE b/cursor-dev-kit/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/cursor-dev-kit/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cursor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/cursor-dev-kit/README.md b/cursor-dev-kit/README.md
new file mode 100644
index 00000000..e4305621
--- /dev/null
+++ b/cursor-dev-kit/README.md
@@ -0,0 +1,47 @@
+# Cursor Dev Kit Plugin
+
+Cursor Dev Kit is a curated bundle of internal-style workflows used by Cursor developers for CI, code review, shipping, and test reliability.
+
+## Installation
+
+```bash
+agent install cursor-dev-kit
+```
+
+## Components
+
+### Skills
+
+| Skill | Description |
+|:------|:------------|
+| `loop-on-ci` | Watch CI runs and iterate on failures until checks pass |
+| `review-and-ship` | Run a structured review, commit changes, and open a PR |
+| `run-smoke-tests` | Run Playwright smoke tests and triage failures |
+
+### Commands
+
+| Command | Description |
+|:--------|:------------|
+| `fix-ci` | Find failing CI jobs, extract failures, and apply focused fixes |
+| `new-branch-and-pr` | Wrap work in a clean branch workflow and open a PR |
+| `get-pr-comments` | Fetch and summarize PR comments and review feedback |
+| `check-compiler-errors` | Run project compile/type-check commands and report failures |
+| `worktree` | Start work in a dedicated git worktree |
+| `apply-worktree` | Apply committed worktree changes to the main worktree |
+
+### Agents
+
+| Agent | Description |
+|:------|:------------|
+| `ci-watcher` | Monitor GitHub Actions runs and return concise pass/fail summaries |
+
+### Rules
+
+| Rule | Description |
+|:-----|:------------|
+| `typescript-exhaustive-switch` | Require exhaustive switch handling for unions/enums |
+| `no-inline-imports` | Keep imports at module top-level for readability and consistency |
+
+## License
+
+MIT
diff --git a/cursor-dev-kit/agents/ci-watcher.md b/cursor-dev-kit/agents/ci-watcher.md
new file mode 100644
index 00000000..1ceb9424
--- /dev/null
+++ b/cursor-dev-kit/agents/ci-watcher.md
@@ -0,0 +1,25 @@
+---
+name: ci-watcher
+description: Watch GitHub CI for the current branch and report pass/fail with relevant failure logs
+---
+
+# CI Watcher
+
+You are a CI monitoring specialist.
+
+## Workflow
+
+1. Determine current branch:
+ - `git branch --show-current`
+2. Find latest run for that branch:
+ - `gh run list --branch <branch> --limit 1`
+3. Watch to completion:
+ - `gh run watch <run-id> --exit-status`
+4. If failed, fetch failed logs:
+ - `gh run view <run-id> --log-failed`
+
+## Output
+
+- CI status (passed/failed)
+- Workflow/run metadata
+- If failed: concise failure excerpt and likely next step
diff --git a/cursor-dev-kit/commands/check-compiler-errors.md b/cursor-dev-kit/commands/check-compiler-errors.md
new file mode 100644
index 00000000..6aa6c427
--- /dev/null
+++ b/cursor-dev-kit/commands/check-compiler-errors.md
@@ -0,0 +1,12 @@
+---
+name: check-compiler-errors
+description: Run compile and type-check commands and report failures
+---
+
+# Check Compiler Errors
+
+Run the repo's compile and type-check commands, then:
+
+1. Summarize errors by file and type.
+2. Fix the highest-confidence issues first.
+3. Re-run checks until clean or blocked.
diff --git a/cursor-dev-kit/commands/fix-ci.md b/cursor-dev-kit/commands/fix-ci.md
new file mode 100644
index 00000000..62e5ecbb
--- /dev/null
+++ b/cursor-dev-kit/commands/fix-ci.md
@@ -0,0 +1,11 @@
+---
+name: fix-ci
+description: Find failing CI jobs, inspect logs, and apply focused fixes
+---
+
+# Fix CI
+
+1. Identify the latest run for the current branch.
+2. Inspect failed jobs and extract the first actionable error.
+3. Apply the smallest safe fix.
+4. Re-run CI and repeat until green.
diff --git a/cursor-dev-kit/commands/get-pr-comments.md b/cursor-dev-kit/commands/get-pr-comments.md
new file mode 100644
index 00000000..f1a7f035
--- /dev/null
+++ b/cursor-dev-kit/commands/get-pr-comments.md
@@ -0,0 +1,11 @@
+---
+name: get-pr-comments
+description: Fetch and summarize review comments from the active pull request
+---
+
+# Get PR Comments
+
+1. Resolve the active PR for the current branch.
+2. Fetch review comments and discussion comments.
+3. Group feedback by severity and actionability.
+4. Return a concise action list.
diff --git a/cursor-dev-kit/commands/new-branch-and-pr.md b/cursor-dev-kit/commands/new-branch-and-pr.md
new file mode 100644
index 00000000..a713bfce
--- /dev/null
+++ b/cursor-dev-kit/commands/new-branch-and-pr.md
@@ -0,0 +1,12 @@
+---
+name: new-branch-and-pr
+description: Create a fresh branch, complete work, and open a pull request
+---
+
+# New Branch and PR
+
+1. Ensure working tree is clean or explicitly handled.
+2. Create a descriptive branch from latest main.
+3. Complete implementation and tests.
+4. Commit focused changes and push.
+5. Create a concise PR with summary and test notes.
diff --git a/cursor-dev-kit/rules/no-inline-imports.mdc b/cursor-dev-kit/rules/no-inline-imports.mdc
new file mode 100644
index 00000000..71e6b14c
--- /dev/null
+++ b/cursor-dev-kit/rules/no-inline-imports.mdc
@@ -0,0 +1,8 @@
+---
+description: Keep imports at top of file and avoid inline imports
+alwaysApply: true
+---
+
+# No Inline Imports
+
+Always place imports at the top of the module. Avoid inline imports in function bodies, type annotations, or interface fields unless there is a strict circular-dependency reason and it is documented.
diff --git a/cursor-dev-kit/rules/typescript-exhaustive-switch.mdc b/cursor-dev-kit/rules/typescript-exhaustive-switch.mdc
new file mode 100644
index 00000000..4011384a
--- /dev/null
+++ b/cursor-dev-kit/rules/typescript-exhaustive-switch.mdc
@@ -0,0 +1,6 @@
+---
+description: Use exhaustive switch handling for TypeScript unions and enums
+alwaysApply: true
+---
+
+typescript-exhaustive-switch: In switch statements over discriminated unions or enums, use a `never` check in the default case so newly added variants cause compile-time failures until handled.
diff --git a/cursor-dev-kit/skills/loop-on-ci/SKILL.md b/cursor-dev-kit/skills/loop-on-ci/SKILL.md
new file mode 100644
index 00000000..60d3aed8
--- /dev/null
+++ b/cursor-dev-kit/skills/loop-on-ci/SKILL.md
@@ -0,0 +1,40 @@
+---
+name: loop-on-ci
+description: Watch CI runs and iterate on failures until all checks pass
+---
+
+# Skill: Loop on CI
+
+Watch CI for the current branch and keep fixing failures until green.
+
+## Workflow
+
+1. Find the current branch and latest workflow run.
+2. Wait for CI completion with `gh run watch --exit-status`.
+3. If failed, inspect failed logs, implement a focused fix, commit, and push.
+4. Repeat until all required checks pass.
+
+## Commands
+
+```bash
+# Latest run for current branch
+gh run list --branch "$(git branch --show-current)" --limit 5
+
+# Block until completion (0 on pass, non-zero on fail)
+gh run watch --exit-status
+
+# Inspect failed jobs
+gh run view <run-id> --log-failed
+```
+
+## Guardrails
+
+- Keep each fix scoped to a single failure cause when possible.
+- Do not bypass hooks (`--no-verify`) to force progress.
+- If failures are flaky, retry once and report flake evidence.
+
+## Output
+
+- Current CI status
+- Failure summary and fixes applied
+- PR URL once checks are green
diff --git a/cursor-dev-kit/skills/review-and-ship/SKILL.md b/cursor-dev-kit/skills/review-and-ship/SKILL.md
new file mode 100644
index 00000000..e39ae5dd
--- /dev/null
+++ b/cursor-dev-kit/skills/review-and-ship/SKILL.md
@@ -0,0 +1,36 @@
+---
+name: review-and-ship
+description: Run a structured review, close key issues, and ship changes via PR
+---
+
+# Skill: Review and Ship
+
+Use this workflow to review changes thoroughly and ship confidently.
+
+## Workflow
+
+1. Review diff against base branch and identify behavior-impacting risks.
+2. Run or update tests for changed behavior.
+3. Fix critical issues before finalizing.
+4. Commit selective files with a concise message.
+5. Push branch and open or update a PR.
+
+## Suggested Checks
+
+```bash
+git fetch origin main
+git diff origin/main...HEAD
+git status
+```
+
+## Guardrails
+
+- Prioritize correctness, security, and regressions over style-only comments.
+- Keep commits focused and avoid unrelated file changes.
+- If pre-commit checks fail, fix the issues rather than bypassing hooks.
+
+## Output
+
+- Findings summary (critical, warning, note)
+- Tests run and outcomes
+- PR URL
diff --git a/cursor-dev-kit/skills/run-smoke-tests/SKILL.md b/cursor-dev-kit/skills/run-smoke-tests/SKILL.md
new file mode 100644
index 00000000..e19a0a27
--- /dev/null
+++ b/cursor-dev-kit/skills/run-smoke-tests/SKILL.md
@@ -0,0 +1,40 @@
+---
+name: run-smoke-tests
+description: Run Playwright smoke tests, debug failures, and verify fixes
+---
+
+# Skill: Run Smoke Tests
+
+Run smoke tests for high-signal end-to-end verification.
+
+## Workflow
+
+1. Build prerequisites for the target app.
+2. Run the relevant smoke suite or a focused test file.
+3. If failing, inspect traces/logs and isolate the root cause.
+4. Apply a minimal fix and rerun until stable.
+
+## Example Commands
+
+```bash
+# Run full smoke suite
+npm run smoketest
+
+# Run a specific smoke test file
+npm run smoketest -- path/to/test.spec.ts
+
+# Faster iteration when build artifacts are ready
+npm run smoketest-no-compile -- path/to/test.spec.ts
+```
+
+## Guardrails
+
+- Prefer deterministic waits and assertions over brittle timeouts.
+- Re-run passing fixes to reduce flaky false positives.
+- Quarantine tests only when explicitly requested and documented.
+
+## Output
+
+- Test results summary
+- Root cause and fix
+- Remaining flake risk (if any)