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.jsonindex 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 filediff --git a/README.md b/README.mdindex 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 Structurediff --git a/cursor-dev-kit/.cursor-plugin/plugin.json b/cursor-dev-kit/.cursor-plugin/plugin.jsonnew file mode 100644index 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/LICENSEnew file mode 100644index 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.mdnew file mode 100644index 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++MITdiff --git a/cursor-dev-kit/agents/ci-watcher.md b/cursor-dev-kit/agents/ci-watcher.mdnew file mode 100644index 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 stepdiff --git a/cursor-dev-kit/commands/check-compiler-errors.md b/cursor-dev-kit/commands/check-compiler-errors.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdcnew file mode 100644index 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.mdcnew file mode 100644index 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.mdnew file mode 100644index 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 greendiff --git a/cursor-dev-kit/skills/review-and-ship/SKILL.md b/cursor-dev-kit/skills/review-and-ship/SKILL.mdnew file mode 100644index 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 URLdiff --git a/cursor-dev-kit/skills/run-smoke-tests/SKILL.md b/cursor-dev-kit/skills/run-smoke-tests/SKILL.mdnew file mode 100644index 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)