Skip to content

Cursor plugin specification and official plugins

TypeScript

Apply writing guide: sentence-case titles, remove em-dashes and semicolons

ericzakariasson97128c02db90
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 248c354d..7349fc85 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -5,68 +5,68 @@
"email": "[email protected]"
},
"metadata": {
- "description": "Official Cursor plugin marketplace — developer tools, framework rules, MCP integrations, and agent skills"
+ "description": "Official Cursor plugin marketplace: developer tools, framework rules, MCP integrations, and agent skills"
},
"plugins": [
{
"name": "frontend",
"source": "frontend",
- "description": "Cursor plugin for frontend engineering workflows — React, TypeScript, accessibility, and performance"
+ "description": "Cursor plugin for frontend engineering workflows: React, TypeScript, accessibility, and performance"
},
{
"name": "design",
"source": "design",
- "description": "Cursor plugin for product design workflows — UX specs, design systems, handoff, and iteration"
+ "description": "Cursor plugin for product design workflows: UX specs, design systems, handoff, and iteration"
},
{
"name": "data-science",
"source": "data-science",
- "description": "Cursor plugin for analyst-first data science workflows — exploratory analysis, validation, and decision-ready reporting"
+ "description": "Cursor plugin for analyst-first data science workflows: exploratory analysis, validation, and decision-ready reporting"
},
{
"name": "ios",
"source": "ios",
- "description": "Cursor plugin for iOS development — Swift, SwiftUI, architecture, and testing"
+ "description": "Cursor plugin for iOS development: Swift, SwiftUI, architecture, and testing"
},
{
"name": "android",
"source": "android",
- "description": "Cursor plugin for Android development — Kotlin, Jetpack Compose, architecture, and testing"
+ "description": "Cursor plugin for Android development: Kotlin, Jetpack Compose, architecture, and testing"
},
{
"name": "planning",
"source": "planning",
- "description": "Cursor plugin for software planning — scope, milestones, risk management, and execution plans"
+ "description": "Cursor plugin for software planning: scope, milestones, risk management, and execution plans"
},
{
"name": "code-review",
"source": "code-review",
- "description": "Cursor plugin for code review workflows — correctness, security, regressions, and actionable feedback"
+ "description": "Cursor plugin for code review workflows: correctness, security, regressions, and actionable feedback"
},
{
"name": "web-browser",
"source": "web-browser",
- "description": "Cursor plugin for browser debugging workflows — DevTools, network traces, and reproducible bug reports"
+ "description": "Cursor plugin for browser debugging workflows: DevTools, network traces, and reproducible bug reports"
},
{
"name": "documentation",
"source": "documentation",
- "description": "Cursor plugin for technical documentation workflows — READMEs, API docs, architecture notes, and changelogs"
+ "description": "Cursor plugin for technical documentation workflows: READMEs, API docs, architecture notes, and changelogs"
},
{
"name": "presentation-pptx",
"source": "presentation-pptx",
- "description": "Cursor plugin for presentation authoring — narrative design, slide outlines, and PPTX-ready content"
+ "description": "Cursor plugin for presentation authoring: narrative design, slide outlines, and PPTX-ready content"
},
{
"name": "learning",
"source": "learning",
- "description": "Cursor plugin for learning workflows — skill mapping, practice plans, and feedback loops"
+ "description": "Cursor plugin for learning workflows: skill mapping, practice plans, and feedback loops"
},
{
"name": "cursor-dev-kit",
"source": "cursor-dev-kit",
- "description": "Cursor Dev Kit — internal-style workflows used by Cursor developers for CI, code review, shipping, and testing"
+ "description": "Cursor Dev Kit: internal-style workflows used by Cursor developers for CI, code review, shipping, and testing"
},
{
"name": "create-plugin",
diff --git a/README.md b/README.md
index 54be3813..3abb1631 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Cursor Plugins
+# Cursor plugins
Official Cursor plugins for popular developer tools, frameworks, and SaaS products. Each plugin is a standalone directory at the repository root with its own `.cursor-plugin/plugin.json` manifest.
@@ -20,7 +20,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| [Cursor Dev Kit](cursor-dev-kit/) | Developer Tools | Internal-style workflows for CI, code review, shipping, and testing |
| [Create Plugin](create-plugin/) | Developer Tools | Meta workflows for creating Cursor plugins with scaffolding and submission checks |
-## Repository Structure
+## Repository structure
This is a multi-plugin marketplace repository. The root `.cursor-plugin/marketplace.json` lists all plugins, and each plugin has its own manifest:
diff --git a/android/.cursor-plugin/plugin.json b/android/.cursor-plugin/plugin.json
index ffcb5ea4..d42584bb 100644
--- a/android/.cursor-plugin/plugin.json
+++ b/android/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "android",
"version": "1.0.0",
- "description": "Cursor plugin for Android development \u2014 Kotlin, Jetpack Compose, architecture, and testing",
+ "description": "Cursor plugin for Android development: Kotlin, Jetpack Compose, architecture, and testing",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/android/README.md b/android/README.md
index 183a0091..f6910f0a 100644
--- a/android/README.md
+++ b/android/README.md
@@ -1,6 +1,6 @@
-# Android Plugin
+# Android plugin
-Android development — Kotlin, Jetpack Compose, architecture, and testing.
+Android development: Kotlin, Jetpack Compose, architecture, and testing.
## Installation
diff --git a/android/skills/build-android-feature/SKILL.md b/android/skills/build-android-feature/SKILL.md
index debfa3d6..452e64c0 100644
--- a/android/skills/build-android-feature/SKILL.md
+++ b/android/skills/build-android-feature/SKILL.md
@@ -3,7 +3,7 @@ name: build-android-feature
description: Implement Android features with robust architecture, state management, and tests
---
-# Build an Android Feature
+# Build an Android feature
## Trigger
diff --git a/android/skills/debug-android-issue/SKILL.md b/android/skills/debug-android-issue/SKILL.md
index befd84e1..ce2e7726 100644
--- a/android/skills/debug-android-issue/SKILL.md
+++ b/android/skills/debug-android-issue/SKILL.md
@@ -3,7 +3,7 @@ name: debug-android-issue
description: Reproduce and debug Android issues in Compose, lifecycle, and data layers
---
-# Debug an Android Issue
+# Debug an Android issue
## Trigger
diff --git a/code-review/.cursor-plugin/plugin.json b/code-review/.cursor-plugin/plugin.json
index cf762973..606da0bc 100644
--- a/code-review/.cursor-plugin/plugin.json
+++ b/code-review/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "code-review",
"version": "1.0.0",
- "description": "Cursor plugin for code review workflows \u2014 correctness, security, regressions, and actionable feedback",
+ "description": "Cursor plugin for code review workflows: correctness, security, regressions, and actionable feedback",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/code-review/README.md b/code-review/README.md
index adefb295..617aa8d9 100644
--- a/code-review/README.md
+++ b/code-review/README.md
@@ -1,6 +1,6 @@
-# Code Review Plugin
+# Code review plugin
-Code review workflows — correctness, security, regressions, and actionable feedback.
+Code review workflows: correctness, security, regressions, and actionable feedback.
## Installation
diff --git a/code-review/agents/security-reviewer.md b/code-review/agents/security-reviewer.md
index 6948da5b..bdb9d101 100644
--- a/code-review/agents/security-reviewer.md
+++ b/code-review/agents/security-reviewer.md
@@ -5,7 +5,7 @@ model: inherit
readonly: true
---
-# Security Reviewer
+# Security reviewer
Security-focused code reviewer for auth, payments, sensitive data, and PR security risks.
diff --git a/code-review/rules/regression-risk-checklist.mdc b/code-review/rules/regression-risk-checklist.mdc
index 192558ff..a4409675 100644
--- a/code-review/rules/regression-risk-checklist.mdc
+++ b/code-review/rules/regression-risk-checklist.mdc
@@ -2,7 +2,7 @@
alwaysApply: true
---
-# Regression Risk Checklist
+# Regression risk checklist
1. Confirm API contracts and response shapes remain backward compatible.
2. Validate migration and rollout safety for schema/config changes.
diff --git a/code-review/rules/security-review-checklist.mdc b/code-review/rules/security-review-checklist.mdc
index 61daeca8..77147fc1 100644
--- a/code-review/rules/security-review-checklist.mdc
+++ b/code-review/rules/security-review-checklist.mdc
@@ -2,7 +2,7 @@
alwaysApply: true
---
-# Security Review Checklist
+# Security review checklist
1. Validate and sanitize untrusted input at trust boundaries.
2. Confirm authorization checks exist for sensitive actions and resource access.
diff --git a/code-review/skills/review-pr-changes/SKILL.md b/code-review/skills/review-pr-changes/SKILL.md
index 25965c17..b0279bc2 100644
--- a/code-review/skills/review-pr-changes/SKILL.md
+++ b/code-review/skills/review-pr-changes/SKILL.md
@@ -3,7 +3,7 @@ name: review-pr-changes
description: Perform risk-focused code reviews with prioritized findings and test-gap analysis
---
-# Review Pull Request Changes
+# Review pull request changes
## Trigger
diff --git a/code-review/skills/review-pr/SKILL.md b/code-review/skills/review-pr/SKILL.md
index c66947b3..00a134f5 100644
--- a/code-review/skills/review-pr/SKILL.md
+++ b/code-review/skills/review-pr/SKILL.md
@@ -3,7 +3,7 @@ name: review-pr
description: Perform a risk-focused pull request review and return prioritized findings
---
-# Review Pull Request
+# Review pull request
## Trigger
diff --git a/code-review/skills/review-risky-changes/SKILL.md b/code-review/skills/review-risky-changes/SKILL.md
index 294c3615..fd558d88 100644
--- a/code-review/skills/review-risky-changes/SKILL.md
+++ b/code-review/skills/review-risky-changes/SKILL.md
@@ -3,7 +3,7 @@ name: review-risky-changes
description: Deep review of high-risk changes involving auth, data, infra, or shared core logic
---
-# Review High-Risk Changes
+# Review high-risk changes
## Trigger
diff --git a/code-review/skills/security-review/SKILL.md b/code-review/skills/security-review/SKILL.md
index fba9e24c..552b82c1 100644
--- a/code-review/skills/security-review/SKILL.md
+++ b/code-review/skills/security-review/SKILL.md
@@ -3,7 +3,7 @@ name: security-review
description: Conduct a focused security review for changed code and integration boundaries
---
-# Conduct a Security Review
+# Conduct a security review
## Trigger
diff --git a/code-review/skills/test-gap-audit/SKILL.md b/code-review/skills/test-gap-audit/SKILL.md
index dfddba92..93f002fd 100644
--- a/code-review/skills/test-gap-audit/SKILL.md
+++ b/code-review/skills/test-gap-audit/SKILL.md
@@ -3,7 +3,7 @@ name: test-gap-audit
description: Identify missing tests and propose a prioritized test plan for changed behavior
---
-# Audit Test Gaps
+# Audit test gaps
## Trigger
diff --git a/create-plugin/README.md b/create-plugin/README.md
index f385c09f..197291b8 100644
--- a/create-plugin/README.md
+++ b/create-plugin/README.md
@@ -1,4 +1,4 @@
-# Create Plugin Plugin
+# Create plugin
Meta workflows for creating Cursor plugins that are marketplace-ready.
@@ -35,7 +35,7 @@ agent install create-plugin
|:--------|:------------|
| `create-plugin` | Build a new plugin scaffold with the right files and metadata |
-## Typical Flow
+## Typical flow
1. Use `/create-plugin` with a plugin name, purpose, and target component types.
2. Generate or update `plugin.json`, then add rules/skills/agents/commands as needed.
diff --git a/create-plugin/agents/plugin-architect.md b/create-plugin/agents/plugin-architect.md
index d59bec49..6cf08f2b 100644
--- a/create-plugin/agents/plugin-architect.md
+++ b/create-plugin/agents/plugin-architect.md
@@ -5,7 +5,7 @@ model: inherit
readonly: true
---
-# Plugin Architect
+# Plugin architect
Design focused, maintainable Cursor plugins with the smallest viable component set.
diff --git a/create-plugin/commands/create-plugin.md b/create-plugin/commands/create-plugin.md
index e548dfc7..c280f527 100644
--- a/create-plugin/commands/create-plugin.md
+++ b/create-plugin/commands/create-plugin.md
@@ -3,7 +3,7 @@ name: create-plugin
description: Scaffold a new Cursor plugin with manifest, component files, and marketplace wiring when needed
---
-# Create Plugin
+# Create plugin
Create a new plugin scaffold using this flow:
diff --git a/create-plugin/rules/plugin-quality-gates.mdc b/create-plugin/rules/plugin-quality-gates.mdc
index 9b853ace..606e48dd 100644
--- a/create-plugin/rules/plugin-quality-gates.mdc
+++ b/create-plugin/rules/plugin-quality-gates.mdc
@@ -3,7 +3,7 @@ description: Keep Cursor plugin manifests, paths, and component metadata valid d
alwaysApply: true
---
-# Plugin Quality Gates
+# Plugin quality gates
When creating or editing Cursor plugins:
diff --git a/create-plugin/skills/create-plugin-scaffold/SKILL.md b/create-plugin/skills/create-plugin-scaffold/SKILL.md
index cea1b1da..7c9578c4 100644
--- a/create-plugin/skills/create-plugin-scaffold/SKILL.md
+++ b/create-plugin/skills/create-plugin-scaffold/SKILL.md
@@ -3,7 +3,7 @@ name: create-plugin-scaffold
description: Create a new Cursor plugin scaffold with a valid manifest, component directories, and marketplace wiring. Use when starting a new plugin or adding a plugin to a multi-plugin repository.
---
-# Create Plugin Scaffold
+# Create plugin scaffold
## Trigger
diff --git a/create-plugin/skills/review-plugin-submission/SKILL.md b/create-plugin/skills/review-plugin-submission/SKILL.md
index 026cee04..37b0982e 100644
--- a/create-plugin/skills/review-plugin-submission/SKILL.md
+++ b/create-plugin/skills/review-plugin-submission/SKILL.md
@@ -3,7 +3,7 @@ name: review-plugin-submission
description: Audit a Cursor plugin for marketplace readiness. Use when validating manifests, component metadata, discovery paths, and submission quality before publishing.
---
-# Review Plugin Submission
+# Review plugin submission
## Trigger
diff --git a/cursor-dev-kit/.cursor-plugin/plugin.json b/cursor-dev-kit/.cursor-plugin/plugin.json
index ac05432f..9adf21fc 100644
--- a/cursor-dev-kit/.cursor-plugin/plugin.json
+++ b/cursor-dev-kit/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "cursor-dev-kit",
"version": "1.0.0",
- "description": "Cursor Dev Kit \u2014 internal-style workflows used by Cursor developers for CI, code review, shipping, and testing",
+ "description": "Cursor Dev Kit: internal-style workflows used by Cursor developers for CI, code review, shipping, and testing",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/cursor-dev-kit/README.md b/cursor-dev-kit/README.md
index b499ee66..6c995278 100644
--- a/cursor-dev-kit/README.md
+++ b/cursor-dev-kit/README.md
@@ -1,4 +1,4 @@
-# Cursor Dev Kit Plugin
+# Cursor Dev Kit plugin
Internal-style workflows for CI, code review, shipping, and test reliability.
diff --git a/cursor-dev-kit/agents/ci-watcher.md b/cursor-dev-kit/agents/ci-watcher.md
index d2eacc01..8801f812 100644
--- a/cursor-dev-kit/agents/ci-watcher.md
+++ b/cursor-dev-kit/agents/ci-watcher.md
@@ -5,7 +5,7 @@ model: fast
is_background: true
---
-# CI Watcher
+# CI watcher
CI monitoring specialist for GitHub Actions.
diff --git a/cursor-dev-kit/rules/no-inline-imports.mdc b/cursor-dev-kit/rules/no-inline-imports.mdc
index 71e6b14c..ddcaf570 100644
--- a/cursor-dev-kit/rules/no-inline-imports.mdc
+++ b/cursor-dev-kit/rules/no-inline-imports.mdc
@@ -3,6 +3,6 @@ description: Keep imports at top of file and avoid inline imports
alwaysApply: true
---
-# No Inline Imports
+# 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/skills/check-compiler-errors/SKILL.md b/cursor-dev-kit/skills/check-compiler-errors/SKILL.md
index d87834e2..585f4bb6 100644
--- a/cursor-dev-kit/skills/check-compiler-errors/SKILL.md
+++ b/cursor-dev-kit/skills/check-compiler-errors/SKILL.md
@@ -3,7 +3,7 @@ name: check-compiler-errors
description: Run compile and type-check commands and report failures
---
-# Check Compiler Errors
+# Check compiler errors
## Trigger
diff --git a/cursor-dev-kit/skills/fix-ci/SKILL.md b/cursor-dev-kit/skills/fix-ci/SKILL.md
index 8d7a3173..7f9fb3f4 100644
--- a/cursor-dev-kit/skills/fix-ci/SKILL.md
+++ b/cursor-dev-kit/skills/fix-ci/SKILL.md
@@ -7,7 +7,7 @@ description: Find failing CI jobs, inspect logs, and apply focused fixes
## Trigger
-Branch CI is failing; need a fast, iterative path to green checks.
+Branch CI is failing and needs a fast, iterative path to green checks.
## Workflow
diff --git a/cursor-dev-kit/skills/fix-merge-conflicts/SKILL.md b/cursor-dev-kit/skills/fix-merge-conflicts/SKILL.md
index a090fd90..2940fe4c 100644
--- a/cursor-dev-kit/skills/fix-merge-conflicts/SKILL.md
+++ b/cursor-dev-kit/skills/fix-merge-conflicts/SKILL.md
@@ -3,7 +3,7 @@ name: fix-merge-conflicts
description: Resolve merge conflicts non-interactively, validate build and tests, and finalize conflict resolution
---
-# Fix Merge Conflicts
+# Fix merge conflicts
## Trigger
@@ -13,7 +13,7 @@ Branch has unresolved merge conflicts and needs a reliable path to a buildable s
1. Detect all conflicting files from git status and conflict markers.
2. Resolve each conflict with minimal, correctness-first edits.
-3. Prefer preserving both sides when safe; otherwise choose the variant that compiles and keeps public behavior stable.
+3. Prefer preserving both sides when safe. Otherwise, choose the variant that compiles and keeps public behavior stable.
4. Regenerate lockfiles with package manager tools instead of hand-editing.
5. Run compile, lint, and relevant tests.
6. Stage resolved files and summarize key decisions.
diff --git a/cursor-dev-kit/skills/get-pr-comments/SKILL.md b/cursor-dev-kit/skills/get-pr-comments/SKILL.md
index 5831b2a1..af503214 100644
--- a/cursor-dev-kit/skills/get-pr-comments/SKILL.md
+++ b/cursor-dev-kit/skills/get-pr-comments/SKILL.md
@@ -3,7 +3,7 @@ name: get-pr-comments
description: Fetch and summarize review comments from the active pull request
---
-# Get PR Comments
+# Get PR comments
## Trigger
diff --git a/cursor-dev-kit/skills/new-branch-and-pr/SKILL.md b/cursor-dev-kit/skills/new-branch-and-pr/SKILL.md
index 4c284bb5..860682f0 100644
--- a/cursor-dev-kit/skills/new-branch-and-pr/SKILL.md
+++ b/cursor-dev-kit/skills/new-branch-and-pr/SKILL.md
@@ -3,7 +3,7 @@ name: new-branch-and-pr
description: Create a fresh branch, complete work, and open a pull request
---
-# New Branch and PR
+# New branch and PR
## Trigger
diff --git a/cursor-dev-kit/skills/review-and-ship/SKILL.md b/cursor-dev-kit/skills/review-and-ship/SKILL.md
index d223ce56..aaf0e563 100644
--- a/cursor-dev-kit/skills/review-and-ship/SKILL.md
+++ b/cursor-dev-kit/skills/review-and-ship/SKILL.md
@@ -3,11 +3,11 @@ name: review-and-ship
description: Run a structured review, close key issues, and ship changes via PR
---
-# Review and Ship
+# Review and ship
## Trigger
-Reviewing changes before shipping; need to close key issues and open/update PR.
+Reviewing changes before shipping. Close key issues and open/update PR.
## Workflow
diff --git a/cursor-dev-kit/skills/run-smoke-tests/SKILL.md b/cursor-dev-kit/skills/run-smoke-tests/SKILL.md
index 4cafe8fe..fb0337f6 100644
--- a/cursor-dev-kit/skills/run-smoke-tests/SKILL.md
+++ b/cursor-dev-kit/skills/run-smoke-tests/SKILL.md
@@ -3,7 +3,7 @@ name: run-smoke-tests
description: Run Playwright smoke tests, debug failures, and verify fixes
---
-# Run Smoke Tests
+# Run smoke tests
## Trigger
diff --git a/cursor-dev-kit/skills/weekly-review/SKILL.md b/cursor-dev-kit/skills/weekly-review/SKILL.md
index 687d6f83..216e855f 100644
--- a/cursor-dev-kit/skills/weekly-review/SKILL.md
+++ b/cursor-dev-kit/skills/weekly-review/SKILL.md
@@ -3,7 +3,7 @@ name: weekly-review
description: Produce a weekly synthesis of authored commits with highlights by bugfix, tech debt, and net-new work
---
-# Weekly Review
+# Weekly review
## Trigger
diff --git a/cursor-dev-kit/skills/what-did-i-get-done/SKILL.md b/cursor-dev-kit/skills/what-did-i-get-done/SKILL.md
index 385ce85c..51995c1f 100644
--- a/cursor-dev-kit/skills/what-did-i-get-done/SKILL.md
+++ b/cursor-dev-kit/skills/what-did-i-get-done/SKILL.md
@@ -3,7 +3,7 @@ name: what-did-i-get-done
description: Summarize authored commits over a user-specified time period into a concise update
---
-# What Did I Get Done
+# What did I get done
## Trigger
@@ -22,7 +22,7 @@ Need a short, high-signal summary of work completed in a specific time range (fo
- Be extremely concise and information-dense.
- Prioritize substantial behavior or architecture changes.
- Omit cosmetic-only changes (formatting, imports, minor renames).
-- Do not infer intent or motivation; describe changes functionally.
+- Do not infer intent or motivation. Describe changes functionally.
## Output
diff --git a/data-science/.cursor-plugin/plugin.json b/data-science/.cursor-plugin/plugin.json
index 2e2e9269..014e4010 100644
--- a/data-science/.cursor-plugin/plugin.json
+++ b/data-science/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "data-science",
"version": "1.0.0",
- "description": "Cursor plugin for analyst-first data science workflows \u2014 exploratory analysis, validation, and decision-ready reporting",
+ "description": "Cursor plugin for analyst-first data science workflows: exploratory analysis, validation, and decision-ready reporting",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/data-science/README.md b/data-science/README.md
index b49fb0fa..4f60a1a3 100644
--- a/data-science/README.md
+++ b/data-science/README.md
@@ -1,6 +1,6 @@
-# Data Science Plugin
+# Data science plugin
-Analyst-first data science — question framing, exploratory analysis, decision-ready insights.
+Analyst-first data science: question framing, exploratory analysis, decision-ready insights.
## Installation
diff --git a/data-science/rules/analysis-quality-gates.mdc b/data-science/rules/analysis-quality-gates.mdc
index db719dc0..9f7d2dd2 100644
--- a/data-science/rules/analysis-quality-gates.mdc
+++ b/data-science/rules/analysis-quality-gates.mdc
@@ -2,7 +2,7 @@
alwaysApply: true
---
-# Analysis Quality Gates
+# Analysis quality gates
1. Validate metric definitions and denominators against the business question.
2. Check data freshness, missingness, duplicates, and join key integrity before interpretation.
diff --git a/data-science/rules/notebook-and-analysis-formatting.mdc b/data-science/rules/notebook-and-analysis-formatting.mdc
index 652a8621..35d37773 100644
--- a/data-science/rules/notebook-and-analysis-formatting.mdc
+++ b/data-science/rules/notebook-and-analysis-formatting.mdc
@@ -2,11 +2,11 @@
alwaysApply: true
---
-# Notebook and Analysis Formatting
+# Notebook and analysis formatting
1. Start analysis with a short objective, metric definitions, and time window.
-2. Keep notebook cells focused and ordered; one analytical intent per cell with clear headings.
+2. Keep notebook cells focused and ordered. One analytical intent per cell with clear headings.
3. Label every chart and table with title, units, denominator, and filter context.
-4. Keep outputs concise; summarize large intermediate data instead of dumping full frames.
+4. Keep outputs concise. Summarize large intermediate data instead of dumping full frames.
5. Prefer consistent naming and formatting in notebooks and scripts (for example, snake_case and explicit column names).
6. End with a brief findings, caveats, and next steps section.
diff --git a/data-science/skills/draft-analysis-readout/SKILL.md b/data-science/skills/draft-analysis-readout/SKILL.md
index 5ded889f..8ee86583 100644
--- a/data-science/skills/draft-analysis-readout/SKILL.md
+++ b/data-science/skills/draft-analysis-readout/SKILL.md
@@ -3,7 +3,7 @@ name: draft-analysis-readout
description: Convert validated findings into a stakeholder-ready readout with caveats and recommendations
---
-# Draft Analysis Readout
+# Draft analysis readout
## Trigger
diff --git a/data-science/skills/review-analysis-results/SKILL.md b/data-science/skills/review-analysis-results/SKILL.md
index 5fd5078e..1e50e152 100644
--- a/data-science/skills/review-analysis-results/SKILL.md
+++ b/data-science/skills/review-analysis-results/SKILL.md
@@ -3,11 +3,11 @@ name: review-analysis-results
description: Stress-test analysis conclusions, uncertainty, and caveats before stakeholder readout
---
-# Review Analysis Results
+# Review analysis results
## Trigger
-Analysis draft is complete; conclusions need validation before sharing recommendations.
+Analysis draft is complete. Conclusions need validation before sharing recommendations.
## Workflow
diff --git a/data-science/skills/run-analysis/SKILL.md b/data-science/skills/run-analysis/SKILL.md
index fdc88552..3ad5ba45 100644
--- a/data-science/skills/run-analysis/SKILL.md
+++ b/data-science/skills/run-analysis/SKILL.md
@@ -3,7 +3,7 @@ name: run-analysis
description: Execute an analyst-first workflow from question framing through validated findings
---
-# Run Analysis
+# Run analysis
## Trigger
diff --git a/data-science/skills/run-data-science-cycle/SKILL.md b/data-science/skills/run-data-science-cycle/SKILL.md
index 10134bc7..fbde9be1 100644
--- a/data-science/skills/run-data-science-cycle/SKILL.md
+++ b/data-science/skills/run-data-science-cycle/SKILL.md
@@ -3,7 +3,7 @@ name: run-data-science-cycle
description: Run an analyst-first analysis loop from question framing through validated, decision-ready insights
---
-# Run a Data Science Cycle
+# Run a data science cycle
## Trigger
@@ -20,8 +20,8 @@ Need analyst-grade answers from data: exploratory analysis, trend/slice comparis
## Guardrails
-- Keep cells focused and readable; one analytical intent per notebook cell.
-- Keep transformations reproducible and ordered; move reusable logic to scripts when needed.
+- Keep cells focused and readable. One analytical intent per notebook cell.
+- Keep transformations reproducible and ordered. Move reusable logic to scripts when needed.
- Track confounders and selection bias risks, not only metric movement.
- Report uncertainty and practical effect size, not only point estimates.
- Prefer simple baselines unless added complexity changes decisions.
diff --git a/design/.cursor-plugin/plugin.json b/design/.cursor-plugin/plugin.json
index db1eddbc..35352400 100644
--- a/design/.cursor-plugin/plugin.json
+++ b/design/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "design",
"version": "1.0.0",
- "description": "Cursor plugin for product design workflows \u2014 UX specs, design systems, handoff, and iteration",
+ "description": "Cursor plugin for product design workflows: UX specs, design systems, handoff, and iteration",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/design/README.md b/design/README.md
index 552586e8..fb13b8af 100644
--- a/design/README.md
+++ b/design/README.md
@@ -1,6 +1,6 @@
-# Design Plugin
+# Design plugin
-Product design — UX specs, design systems, handoff, and iteration.
+Product design: UX specs, design systems, handoff, and iteration.
## Installation
diff --git a/design/skills/create-design-spec/SKILL.md b/design/skills/create-design-spec/SKILL.md
index be8b1304..81690344 100644
--- a/design/skills/create-design-spec/SKILL.md
+++ b/design/skills/create-design-spec/SKILL.md
@@ -3,7 +3,7 @@ name: create-design-spec
description: Turn product requirements into a clear design spec and handoff checklist
---
-# Create a Design Spec
+# Create a design spec
## Trigger
diff --git a/design/skills/review-design-quality/SKILL.md b/design/skills/review-design-quality/SKILL.md
index 71f3a400..75f83c24 100644
--- a/design/skills/review-design-quality/SKILL.md
+++ b/design/skills/review-design-quality/SKILL.md
@@ -3,7 +3,7 @@ name: review-design-quality
description: Evaluate a design solution for usability, consistency, and implementation readiness
---
-# Review Design Quality
+# Review design quality
## Trigger
diff --git a/documentation/.cursor-plugin/plugin.json b/documentation/.cursor-plugin/plugin.json
index 0be57a24..75601104 100644
--- a/documentation/.cursor-plugin/plugin.json
+++ b/documentation/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "documentation",
"version": "1.0.0",
- "description": "Cursor plugin for technical documentation workflows \u2014 READMEs, API docs, architecture notes, and changelogs",
+ "description": "Cursor plugin for technical documentation workflows: READMEs, API docs, architecture notes, and changelogs",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/documentation/README.md b/documentation/README.md
index c662e626..5670a143 100644
--- a/documentation/README.md
+++ b/documentation/README.md
@@ -1,6 +1,6 @@
-# Documentation Plugin
+# Documentation plugin
-Technical documentation — READMEs, API docs, architecture notes, and changelogs.
+Technical documentation: READMEs, API docs, architecture notes, and changelogs.
## Installation
diff --git a/documentation/rules/docs-quality-standards.mdc b/documentation/rules/docs-quality-standards.mdc
index 33c61ce2..4f722ee1 100644
--- a/documentation/rules/docs-quality-standards.mdc
+++ b/documentation/rules/docs-quality-standards.mdc
@@ -2,7 +2,7 @@
alwaysApply: true
---
-# Documentation Quality Standards
+# Documentation quality standards
1. Start with prerequisites and intended audience.
2. Include runnable examples and expected outcomes.
diff --git a/documentation/skills/draft-api-docs/SKILL.md b/documentation/skills/draft-api-docs/SKILL.md
index fb77cad0..7d58b95c 100644
--- a/documentation/skills/draft-api-docs/SKILL.md
+++ b/documentation/skills/draft-api-docs/SKILL.md
@@ -3,7 +3,7 @@ name: draft-api-docs
description: Generate API documentation from current routes, models, and error behavior
---
-# Draft API Docs
+# Draft API docs
## Trigger
diff --git a/documentation/skills/review-doc-accuracy/SKILL.md b/documentation/skills/review-doc-accuracy/SKILL.md
index f020dbd8..e65b5d77 100644
--- a/documentation/skills/review-doc-accuracy/SKILL.md
+++ b/documentation/skills/review-doc-accuracy/SKILL.md
@@ -3,7 +3,7 @@ name: review-doc-accuracy
description: Audit docs for drift against current implementation and propose precise updates
---
-# Review Documentation Accuracy
+# Review documentation accuracy
## Trigger
diff --git a/documentation/skills/write-technical-docs/SKILL.md b/documentation/skills/write-technical-docs/SKILL.md
index 5c68cc9f..8c388590 100644
--- a/documentation/skills/write-technical-docs/SKILL.md
+++ b/documentation/skills/write-technical-docs/SKILL.md
@@ -3,7 +3,7 @@ name: write-technical-docs
description: Produce accurate, maintainable documentation with clear structure and examples
---
-# Write Technical Documentation
+# Write technical documentation
## Trigger
diff --git a/frontend/.cursor-plugin/plugin.json b/frontend/.cursor-plugin/plugin.json
index bed9d80e..e47802c2 100644
--- a/frontend/.cursor-plugin/plugin.json
+++ b/frontend/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "frontend",
"version": "1.0.0",
- "description": "Cursor plugin for frontend engineering workflows \u2014 React, TypeScript, accessibility, and performance",
+ "description": "Cursor plugin for frontend engineering workflows: React, TypeScript, accessibility, and performance",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/frontend/README.md b/frontend/README.md
index 827066ac..f88ea77c 100644
--- a/frontend/README.md
+++ b/frontend/README.md
@@ -1,6 +1,6 @@
-# Frontend Plugin
+# Frontend plugin
-Frontend engineering — React, TypeScript, accessibility, and performance.
+Frontend engineering: React, TypeScript, accessibility, and performance.
## Installation
diff --git a/frontend/rules/accessibility-and-ux.mdc b/frontend/rules/accessibility-and-ux.mdc
index 81e5832d..1a8b8578 100644
--- a/frontend/rules/accessibility-and-ux.mdc
+++ b/frontend/rules/accessibility-and-ux.mdc
@@ -2,7 +2,7 @@
alwaysApply: true
---
-# Accessibility and UX Guardrails
+# Accessibility and UX guardrails
1. Ensure all interactive controls are keyboard accessible.
2. Use semantic elements and proper ARIA labels when needed.
diff --git a/frontend/rules/frontend-performance-checks.mdc b/frontend/rules/frontend-performance-checks.mdc
index 59a0f8e9..a2b668a6 100644
--- a/frontend/rules/frontend-performance-checks.mdc
+++ b/frontend/rules/frontend-performance-checks.mdc
@@ -2,7 +2,7 @@
alwaysApply: true
---
-# Frontend Performance Checks
+# Frontend performance checks
1. Avoid unnecessary re-renders in hot UI paths.
2. Keep bundle growth justified and measurable.
diff --git a/frontend/skills/build-frontend-feature/SKILL.md b/frontend/skills/build-frontend-feature/SKILL.md
index 1f87b295..c539aec4 100644
--- a/frontend/skills/build-frontend-feature/SKILL.md
+++ b/frontend/skills/build-frontend-feature/SKILL.md
@@ -3,7 +3,7 @@ name: build-frontend-feature
description: Plan and implement frontend features with accessibility and performance checks
---
-# Build a Frontend Feature Safely
+# Build a frontend feature safely
## Trigger
diff --git a/frontend/skills/ship-frontend-change/SKILL.md b/frontend/skills/ship-frontend-change/SKILL.md
index 5ffeb2ce..13bbd0d1 100644
--- a/frontend/skills/ship-frontend-change/SKILL.md
+++ b/frontend/skills/ship-frontend-change/SKILL.md
@@ -3,7 +3,7 @@ name: ship-frontend-change
description: Plan, implement, and verify a frontend change with accessibility and performance checks
---
-# Ship Frontend Change
+# Ship frontend change
## Trigger
diff --git a/frontend/skills/triage-frontend-bug/SKILL.md b/frontend/skills/triage-frontend-bug/SKILL.md
index a428904c..988ebaa9 100644
--- a/frontend/skills/triage-frontend-bug/SKILL.md
+++ b/frontend/skills/triage-frontend-bug/SKILL.md
@@ -3,7 +3,7 @@ name: triage-frontend-bug
description: Reproduce, isolate, and prioritize frontend bugs with a minimal fix strategy
---
-# Triage a Frontend Bug
+# Triage a frontend bug
## Trigger
diff --git a/ios/.cursor-plugin/plugin.json b/ios/.cursor-plugin/plugin.json
index 21bc48f4..2d357315 100644
--- a/ios/.cursor-plugin/plugin.json
+++ b/ios/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ios",
"version": "1.0.0",
- "description": "Cursor plugin for iOS development \u2014 Swift, SwiftUI, architecture, and testing",
+ "description": "Cursor plugin for iOS development: Swift, SwiftUI, architecture, and testing",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/ios/README.md b/ios/README.md
index dd536eb2..8fbffeb0 100644
--- a/ios/README.md
+++ b/ios/README.md
@@ -1,6 +1,6 @@
-# iOS Plugin
+# iOS plugin
-iOS development — Swift, SwiftUI, architecture, and testing.
+iOS development: Swift, SwiftUI, architecture, and testing.
## Installation
diff --git a/ios/skills/build-ios-feature/SKILL.md b/ios/skills/build-ios-feature/SKILL.md
index 529aec4a..d820e03e 100644
--- a/ios/skills/build-ios-feature/SKILL.md
+++ b/ios/skills/build-ios-feature/SKILL.md
@@ -3,7 +3,7 @@ name: build-ios-feature
description: Implement iOS features with clear architecture, state handling, and test coverage
---
-# Build an iOS Feature
+# Build an iOS feature
## Trigger
diff --git a/ios/skills/debug-ios-issue/SKILL.md b/ios/skills/debug-ios-issue/SKILL.md
index e7ec6845..1faee337 100644
--- a/ios/skills/debug-ios-issue/SKILL.md
+++ b/ios/skills/debug-ios-issue/SKILL.md
@@ -3,7 +3,7 @@ name: debug-ios-issue
description: Reproduce and debug iOS issues with state, lifecycle, and networking diagnostics
---
-# Debug an iOS Issue
+# Debug an iOS issue
## Trigger
diff --git a/learning/.cursor-plugin/plugin.json b/learning/.cursor-plugin/plugin.json
index 3305d33d..3c1a616f 100644
--- a/learning/.cursor-plugin/plugin.json
+++ b/learning/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "learning",
"version": "1.0.0",
- "description": "Cursor plugin for learning workflows \u2014 skill mapping, practice plans, and feedback loops",
+ "description": "Cursor plugin for learning workflows: skill mapping, practice plans, and feedback loops",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/learning/README.md b/learning/README.md
index 0c88ded8..792a70a5 100644
--- a/learning/README.md
+++ b/learning/README.md
@@ -1,6 +1,6 @@
-# Learning Plugin
+# Learning plugin
-Learning workflows — skill mapping, practice plans, and feedback loops.
+Learning workflows: skill mapping, practice plans, and feedback loops.
## Installation
diff --git a/learning/skills/create-learning-path/SKILL.md b/learning/skills/create-learning-path/SKILL.md
index b0f56ce4..1744f1ab 100644
--- a/learning/skills/create-learning-path/SKILL.md
+++ b/learning/skills/create-learning-path/SKILL.md
@@ -3,7 +3,7 @@ name: create-learning-path
description: Build a personalized learning roadmap with milestones and practice checkpoints
---
-# Create a Learning Path
+# Create a learning path
## Trigger
diff --git a/learning/skills/run-learning-retrospective/SKILL.md b/learning/skills/run-learning-retrospective/SKILL.md
index f7331399..d8f465c9 100644
--- a/learning/skills/run-learning-retrospective/SKILL.md
+++ b/learning/skills/run-learning-retrospective/SKILL.md
@@ -3,11 +3,11 @@ name: run-learning-retrospective
description: Evaluate learning progress, identify blockers, and adjust the learning plan
---
-# Run a Learning Retrospective
+# Run a learning retrospective
## Trigger
-Learner completed a milestone; needs data-driven adjustment to their plan.
+Learner completed a milestone and needs data-driven adjustment to their plan.
## Workflow
diff --git a/planning/.cursor-plugin/plugin.json b/planning/.cursor-plugin/plugin.json
index 6fe11c9f..23027ac4 100644
--- a/planning/.cursor-plugin/plugin.json
+++ b/planning/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "planning",
"version": "1.0.0",
- "description": "Cursor plugin for software planning \u2014 scope, milestones, risk management, and execution plans",
+ "description": "Cursor plugin for software planning: scope, milestones, risk management, and execution plans",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/planning/README.md b/planning/README.md
index d26b067c..50300235 100644
--- a/planning/README.md
+++ b/planning/README.md
@@ -1,6 +1,6 @@
-# Planning Plugin
+# Planning plugin
-Software planning — scope, milestones, risk management, and execution plans.
+Software planning: scope, milestones, risk management, and execution plans.
## Installation
diff --git a/planning/rules/planning-quality-gates.mdc b/planning/rules/planning-quality-gates.mdc
index 720232fc..9c302c24 100644
--- a/planning/rules/planning-quality-gates.mdc
+++ b/planning/rules/planning-quality-gates.mdc
@@ -2,7 +2,7 @@
alwaysApply: true
---
-# Planning Quality Gates
+# Planning quality gates
1. Scope is explicit and out-of-scope is documented.
2. Milestones are dependency-aware and testable.
diff --git a/planning/skills/create-execution-plan/SKILL.md b/planning/skills/create-execution-plan/SKILL.md
index c88eb226..40dd8fd7 100644
--- a/planning/skills/create-execution-plan/SKILL.md
+++ b/planning/skills/create-execution-plan/SKILL.md
@@ -3,7 +3,7 @@ name: create-execution-plan
description: Convert goals into a scoped, sequenced, and risk-aware implementation plan
---
-# Create an Execution Plan
+# Create an execution plan
## Trigger
diff --git a/planning/skills/create-milestone-plan/SKILL.md b/planning/skills/create-milestone-plan/SKILL.md
index 85ee5fcb..b867d68f 100644
--- a/planning/skills/create-milestone-plan/SKILL.md
+++ b/planning/skills/create-milestone-plan/SKILL.md
@@ -3,7 +3,7 @@ name: create-milestone-plan
description: Build a dependency-aware milestone plan with acceptance criteria
---
-# Create Milestone Plan
+# Create milestone plan
## Trigger
diff --git a/planning/skills/de-risk-plan/SKILL.md b/planning/skills/de-risk-plan/SKILL.md
index 161a574c..859fe73d 100644
--- a/planning/skills/de-risk-plan/SKILL.md
+++ b/planning/skills/de-risk-plan/SKILL.md
@@ -3,7 +3,7 @@ name: de-risk-plan
description: Stress-test a plan for hidden assumptions, dependencies, and delivery risk
---
-# De-Risk Plan
+# De-risk plan
## Trigger
diff --git a/planning/skills/manage-delivery-risks/SKILL.md b/planning/skills/manage-delivery-risks/SKILL.md
index 106b2541..6393cc6b 100644
--- a/planning/skills/manage-delivery-risks/SKILL.md
+++ b/planning/skills/manage-delivery-risks/SKILL.md
@@ -3,7 +3,7 @@ name: manage-delivery-risks
description: Identify, prioritize, and mitigate delivery risks in implementation plans
---
-# Manage Delivery Risks
+# Manage delivery risks
## Trigger
diff --git a/presentation-pptx/.cursor-plugin/plugin.json b/presentation-pptx/.cursor-plugin/plugin.json
index cff8f8f5..15b9b6c4 100644
--- a/presentation-pptx/.cursor-plugin/plugin.json
+++ b/presentation-pptx/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "presentation-pptx",
"version": "1.0.0",
- "description": "Cursor plugin for presentation authoring \u2014 narrative design, slide outlines, and PPTX-ready content",
+ "description": "Cursor plugin for presentation authoring: narrative design, slide outlines, and PPTX-ready content",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/presentation-pptx/README.md b/presentation-pptx/README.md
index c78eebc2..f1233412 100644
--- a/presentation-pptx/README.md
+++ b/presentation-pptx/README.md
@@ -1,6 +1,6 @@
-# Presentation PPTX Plugin
+# Presentation PPTX plugin
-Presentation authoring — narrative design, slide outlines, and PPTX-ready content.
+Presentation authoring: narrative design, slide outlines, and PPTX-ready content.
## Installation
diff --git a/presentation-pptx/skills/build-presentation-outline/SKILL.md b/presentation-pptx/skills/build-presentation-outline/SKILL.md
index 445a3e81..8e1bed40 100644
--- a/presentation-pptx/skills/build-presentation-outline/SKILL.md
+++ b/presentation-pptx/skills/build-presentation-outline/SKILL.md
@@ -3,7 +3,7 @@ name: build-presentation-outline
description: Convert goals into a compelling slide narrative with speaker-ready structure
---
-# Build a Presentation Outline
+# Build a presentation outline
## Trigger
diff --git a/presentation-pptx/skills/improve-slide-deck/SKILL.md b/presentation-pptx/skills/improve-slide-deck/SKILL.md
index fe3770fa..4edbf7d8 100644
--- a/presentation-pptx/skills/improve-slide-deck/SKILL.md
+++ b/presentation-pptx/skills/improve-slide-deck/SKILL.md
@@ -3,7 +3,7 @@ name: improve-slide-deck
description: Critique and improve slide decks for clarity, narrative flow, and audience impact
---
-# Improve a Slide Deck
+# Improve a slide deck
## Trigger
diff --git a/web-browser/.cursor-plugin/plugin.json b/web-browser/.cursor-plugin/plugin.json
index 7e91d8d4..ba48c251 100644
--- a/web-browser/.cursor-plugin/plugin.json
+++ b/web-browser/.cursor-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "web-browser",
"version": "1.0.0",
- "description": "Cursor plugin for browser debugging workflows \u2014 DevTools, network traces, and reproducible bug reports",
+ "description": "Cursor plugin for browser debugging workflows: DevTools, network traces, and reproducible bug reports",
"author": {
"name": "Cursor",
"email": "[email protected]"
diff --git a/web-browser/README.md b/web-browser/README.md
index 0d9ee788..2fef34a8 100644
--- a/web-browser/README.md
+++ b/web-browser/README.md
@@ -1,6 +1,6 @@
-# Web Browser Plugin
+# Web browser plugin
-Browser debugging — DevTools, network traces, and reproducible bug reports.
+Browser debugging: DevTools, network traces, and reproducible bug reports.
## Installation
@@ -25,15 +25,15 @@ agent install web-browser
|:------|:------------|
| `browser-debugger` | Reproduction, trace analysis, and fix validation |
-## MCP Browser Workflow (canonical)
+## MCP browser workflow (canonical)
-**Lock/unlock (critical):** `browser_lock` requires an existing tab — you cannot lock before `browser_navigate`. Correct order: `browser_navigate` (or verify via `browser_tabs`) → `browser_lock` → interactions → `browser_unlock` when fully done. If a tab exists, call `browser_lock` first.
+**Lock/unlock (critical):** `browser_lock` requires an existing tab. You cannot lock before `browser_navigate`. Correct order: `browser_navigate` (or verify via `browser_tabs`) → `browser_lock` → interactions → `browser_unlock` when fully done. If a tab exists, call `browser_lock` first.
**Pre-interaction:** Use `browser_tabs` (action: list) and `browser_snapshot` to get element refs before any click, type, or hover.
**Waiting:** Prefer short incremental waits (1–3s) with `browser_snapshot` checks between them instead of a single long wait.
-**Performance profiling:** `browser_profile_start`/`browser_profile_stop` for CPU profiling. Profile data in `~/.cursor/browser-logs/`. Read raw cpu-profile-*.json to verify findings; cross-reference with summary.
+**Performance profiling:** `browser_profile_start`/`browser_profile_stop` for CPU profiling. Profile data in `~/.cursor/browser-logs/`. Read raw cpu-profile-*.json to verify findings. Cross-reference with summary.
**Notes:** Native dialogs (alert/confirm/prompt) never block automation. Iframe content is not accessible. Use `browser_type` to append text, `browser_fill` to clear and replace. For nested scroll containers, use `browser_scroll` with `scrollIntoView: true` before clicking obscured elements.
diff --git a/web-browser/agents/browser-debugger.md b/web-browser/agents/browser-debugger.md
index 7911b8ba..6753d384 100644
--- a/web-browser/agents/browser-debugger.md
+++ b/web-browser/agents/browser-debugger.md
@@ -4,7 +4,7 @@ description: Browser debugging specialist. Use when reproducing browser issues,
model: fast
---
-# Browser Debugger
+# Browser debugger
Browser debugging specialist using MCP browser tools for navigation, snapshots, and network traces.
@@ -20,7 +20,7 @@ Use when reproducing browser issues, analyzing network/performance traces, or va
- **Pre-interaction**: Use `browser_tabs` (list) and `browser_snapshot` to get element refs before click, type, or hover.
- **Waiting**: Short waits (1–3s) with `browser_snapshot` checks between them instead of a single long wait.
- **Screenshots**: Use `take_screenshot_afterwards: true` in `browser_snapshot` when visual verification is needed.
-- **Logs**: Browser logs live in files; grep/read only relevant lines. Detect running dev servers and use correct ports.
+- **Logs**: Browser logs live in files. Grep/read only relevant lines. Detect running dev servers and use correct ports.
**Debug steps:**
diff --git a/web-browser/skills/analyze-web-performance/SKILL.md b/web-browser/skills/analyze-web-performance/SKILL.md
index 8052b10f..1bc6feb2 100644
--- a/web-browser/skills/analyze-web-performance/SKILL.md
+++ b/web-browser/skills/analyze-web-performance/SKILL.md
@@ -3,7 +3,7 @@ name: analyze-web-performance
description: Diagnose frontend performance bottlenecks using browser tools and reproducible metrics
---
-# Analyze Web Performance
+# Analyze web performance
## Trigger
@@ -19,11 +19,11 @@ Pages feel slow, interactions jank, or load times regress.
## Performance Profiling
-Use `browser_profile_start` and `browser_profile_stop` for CPU profiling with call stacks and timing data. Profile data is written to `~/.cursor/browser-logs/`: `cpu-profile-{timestamp}.json` (raw Chrome DevTools format) and `cpu-profile-{timestamp}-summary.md` (human-readable). When diagnosing performance, read the raw `.json` and cross-check with the summary; verify `profile.samples.length`, `profile.nodes[].hitCount`, and `profile.nodes[].callFrame.functionName` before making optimization recommendations.
+Use `browser_profile_start` and `browser_profile_stop` for CPU profiling with call stacks and timing data. Profile data is written to `~/.cursor/browser-logs/`: `cpu-profile-{timestamp}.json` (raw Chrome DevTools format) and `cpu-profile-{timestamp}-summary.md` (human-readable). When diagnosing performance, read the raw `.json` and cross-check with the summary. Verify `profile.samples.length`, `profile.nodes[].hitCount`, and `profile.nodes[].callFrame.functionName` before making optimization recommendations.
## MCP
-Lock before interactions; unlock when done. See canonical browser docs for full lock/unlock sequence.
+Lock before interactions. Unlock when done. See canonical browser docs for full lock/unlock sequence.
## Output
diff --git a/web-browser/skills/capture-browser-repro/SKILL.md b/web-browser/skills/capture-browser-repro/SKILL.md
index 3e335eae..46af7578 100644
--- a/web-browser/skills/capture-browser-repro/SKILL.md
+++ b/web-browser/skills/capture-browser-repro/SKILL.md
@@ -3,7 +3,7 @@ name: capture-browser-repro
description: Build a precise browser reproduction record for debugging and handoff
---
-# Capture Browser Repro
+# Capture browser repro
## Trigger
@@ -23,7 +23,7 @@ Use `browser_snapshot` with `take_screenshot_afterwards: true` for visual eviden
## MCP
-Lock before interactions; unlock when done. See canonical browser docs for full lock/unlock sequence.
+Lock before interactions. Unlock when done. See canonical browser docs for full lock/unlock sequence.
## Output
diff --git a/web-browser/skills/debug-with-browser-tools/SKILL.md b/web-browser/skills/debug-with-browser-tools/SKILL.md
index d631b2db..dbb7393a 100644
--- a/web-browser/skills/debug-with-browser-tools/SKILL.md
+++ b/web-browser/skills/debug-with-browser-tools/SKILL.md
@@ -3,7 +3,7 @@ name: debug-with-browser-tools
description: Investigate frontend issues with a structured DevTools and network-debug workflow
---
-# Debug with Browser Tools
+# Debug with browser tools
## Trigger
@@ -19,11 +19,11 @@ UI bugs, rendering issues, network failures, and browser-only regressions.
## MCP Notes
-Lock before interactions; unlock when done. See canonical browser docs for full lock/unlock sequence.
+Lock before interactions. Unlock when done. See canonical browser docs for full lock/unlock sequence.
- Use `browser_handle_dialog` before actions that trigger `confirm()` or `prompt()` when testing dialog behavior.
-- Iframe content is not accessible; scope work to elements outside iframes.
-- Use `browser_type` to append text; use `browser_fill` to clear and replace. Use `browser_scroll` with `scrollIntoView: true` before clicking elements that may be obscured in nested scroll containers.
+- Iframe content is not accessible. Scope work to elements outside iframes.
+- Use `browser_type` to append text. Use `browser_fill` to clear and replace. Use `browser_scroll` with `scrollIntoView: true` before clicking elements that may be obscured in nested scroll containers.
## Guardrails
diff --git a/web-browser/skills/network-trace-debug/SKILL.md b/web-browser/skills/network-trace-debug/SKILL.md
index 804a94a7..d68633a9 100644
--- a/web-browser/skills/network-trace-debug/SKILL.md
+++ b/web-browser/skills/network-trace-debug/SKILL.md
@@ -3,7 +3,7 @@ name: network-trace-debug
description: Trace and debug request/response failures with structured network analysis
---
-# Network Trace Debug
+# Network trace debug
## Trigger
@@ -21,7 +21,7 @@ Use `browser_network_requests` for request/response inspection to track API call
## MCP
-Lock before interactions; unlock when done. See canonical browser docs for full lock/unlock sequence.
+Lock before interactions. Unlock when done. See canonical browser docs for full lock/unlock sequence.
## Guardrails