chore: release v1.25.0 with updated setup script, improved templates folder for all skills, agents, cursor-rules folders, and claude.md file

Author: vasu31dev

.claude/agents

@@ -1 +1 @@
-../agents
+../templates/agents

.claude/skills/vasu-playwright-utils

@@ -1 +1 @@
-../../skills/vasu-playwright-utils
+../../templates/skills/vasu-playwright-utils

.cursor/rules/playwright-agents.mdc

@@ -1 +1 @@
-../../cursor-rules/playwright-agents.mdc
+../../templates/cursor-rules/playwright-agents.mdc

.cursor/rules/project.mdc

@@ -1 +1 @@
-../../cursor-rules/project.mdc
+../../templates/cursor-rules/project.mdc

.cursor/rules/vasu-playwright-utils.mdc

@@ -1 +1 @@
-../../cursor-rules/vasu-playwright-utils.mdc
+../../templates/cursor-rules/vasu-playwright-utils.mdc

CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [1.25.0] - 2026-03-23
+
+### Added
+
+- **`templates/` directory:** All distributable assets (skills, agents, cursor rules, CLAUDE.md) consolidated under `templates/` for reliable npm publishing — no root-level `skills/`, `agents/`, or `cursor-rules/` directories needed.
+- **`templates/skills/playwright-cli/`:** Playwright CLI skill bundled in the package (SKILL.md + references: request-mocking, running-code, session-management, storage-state, test-generation, tracing, video-recording). Consumers no longer need a separate `npx @playwright/cli install --skills` step.
+- **`scripts/setup.js`:** Setup script moved from `bin/setup.js` to `scripts/setup.js`. New implementation copies all assets from `templates/` with no path rewriting at install time — cursor rule `@file` paths are pre-baked as `.claude/` paths in templates.
+- **`--force-claude` flag:** `npx vasu-pw-setup --force-claude` overwrites `CLAUDE.md` independently of `--force`, preserving customised project instructions by default.
+- **`sync:playwright-cli-skill` script:** `npm run sync:playwright-cli-skill` wipes and copies `.claude/skills/playwright-cli` → `templates/skills/playwright-cli` for maintainers to sync upstream skill updates before publishing.
+
+### Changed
+
+- **Cursor rules in `templates/`:** `@file` directives use `.claude/` paths directly, so no runtime path rewriting is needed during install.
+- **`templates/cursor-rules/playwright-agents.mdc`:** Updated inline locator reference from `` `skills/vasu-playwright-utils/references/locators.md` `` to `` `.claude/skills/vasu-playwright-utils/references/locators.md` ``.
+- **Dev symlinks:** `.claude/agents`, `.claude/skills/vasu-playwright-utils`, and all `.cursor/rules/*.mdc` symlinks updated to point into `templates/` instead of the former root-level directories.
+- **README:** Contributor symlink table updated to reflect `templates/` as source of truth; `--force-claude` flag documented; `sync:playwright-cli-skill` usage added.
+
 ## [1.24.2] - 2026-03-18
 
 ### Added

README.md

@@ -123,6 +123,12 @@ To update after upgrading the library, run the command again with `--force`:
 npx vasu-pw-setup --force
 ```
 
+`--force` overwrites skills, agents, and cursor rules. To also overwrite `CLAUDE.md` (which is normally preserved), add `--force-claude`:
+
+```bash
+npx vasu-pw-setup --force --force-claude
+```
+
 ### How skills and agents are invoked
 
 - **Claude Code** auto-discovers `.claude/skills/` and `.claude/agents/`. `CLAUDE.md` instructs the agent to use `playwright-cli` and `vasu-playwright-utils` skills when writing tests, and to follow agent workflows (Planner / Generator / Healer) when asked to plan, generate, or fix tests.
@@ -132,17 +138,27 @@ To test: ask the agent to "write a test case to login for https://example.com" (
 
 ### For contributors
 
-Skills, agents, and cursor rules are pre-installed via symlinks — edit the source directories and changes are reflected everywhere:
+All distributable assets live under `templates/`. Symlinks make them available to Claude Code and Cursor during local development — edit the source in `templates/` and changes are reflected everywhere:
 
-| Symlink                                   | Source of truth                          |
-| ----------------------------------------- | ---------------------------------------- |
-| `.claude/skills/vasu-playwright-utils`    | `skills/vasu-playwright-utils/`          |
-| `.claude/agents`                          | `agents/`                                |
-| `.cursor/rules/playwright-agents.mdc`     | `cursor-rules/playwright-agents.mdc`     |
-| `.cursor/rules/vasu-playwright-utils.mdc` | `cursor-rules/vasu-playwright-utils.mdc` |
+| Symlink                                   | Source of truth                                    |
+| ----------------------------------------- | -------------------------------------------------- |
+| `.claude/skills/vasu-playwright-utils`    | `templates/skills/vasu-playwright-utils/`          |
+| `.claude/skills/playwright-cli`           | `templates/skills/playwright-cli/`                 |
+| `.claude/agents`                          | `templates/agents/`                                |
+| `.cursor/rules/playwright-agents.mdc`     | `templates/cursor-rules/playwright-agents.mdc`     |
+| `.cursor/rules/vasu-playwright-utils.mdc` | `templates/cursor-rules/vasu-playwright-utils.mdc` |
+| `.cursor/rules/project.mdc`               | `templates/cursor-rules/project.mdc`               |
 
 `.cursor/rules/project.mdc` loads `CLAUDE.md` into Cursor so both Claude Code and Cursor share the same project instructions.
 
+#### Syncing `playwright-cli` skill into `templates/`
+
+After refreshing the skill locally (e.g. `npx skills update microsoft/playwright-cli --skill playwright-cli -a claude-code` so `.claude/skills/playwright-cli` is current), sync it into templates and commit:
+
+```bash
+npm run sync:playwright-cli-skill
+```
+
 ## Issues and Feedback
 
 If you encounter any issues or have feedback, please [Raise an Issue](https://github.com/vasu31dev/playwright-ts-lib/issues) on GitHub.

bin/setup.js

@@ -1,6 +1,6 @@
 {
   "name": "vasu-playwright-utils",
-  "version": "1.24.2",
+  "version": "1.25.0",
   "description": "Playwright Typescript Library with reusable utilities",
   "main": "./dist/src/vasu-playwright-lib/index.js",
   "types": "./dist/src/vasu-playwright-lib/index.d.ts",
@@ -40,27 +40,23 @@
     "access": "public"
   },
   "bin": {
-    "vasu-pw-setup": "./bin/setup.js"
+    "vasu-pw-setup": "scripts/setup.js"
   },
   "files": [
     "dist",
     "src",
     "eslint.config.base.mjs",
-    "skills",
-    "agents",
-    "cursor-rules",
-    "bin",
+    "scripts",
     "templates"
   ],
   "engines": {
     "node": ">=20.0.0"
   },
   "dependencies": {
     "@eslint/js": "^9.39.4",
-    "@playwright/cli": "^0.1.1",
     "@types/node": "^25.5.0",
-    "@typescript-eslint/eslint-plugin": "^8.57.1",
-    "@typescript-eslint/parser": "^8.57.1",
+    "@typescript-eslint/eslint-plugin": "^8.57.2",
+    "@typescript-eslint/parser": "^8.57.2",
     "cross-env": "^10.1.0",
     "dotenv": "^17.3.1",
     "eslint": "^9.39.4",
@@ -81,12 +77,9 @@
   "peerDependencies": {
     "@playwright/test": ">=1.58.2"
   },
-  "overrides": {
-    "playwright": "^1.58.2"
-  },
   "scripts": {
-    "ncu:check": "npx npm-check-updates --reject \"eslint,@eslint/js\" --dep prod,dev,optional,peer && npx npm-check-updates \"eslint,@eslint/js\" --target minor --deep peer",
-    "ncu:update": "npx npm-check-updates --reject \"eslint,@eslint/js\" --dep prod,dev,optional,peer -u && npx npm-check-updates \"eslint,@eslint/js\" --target minor --deep peer -u",
+    "ncu:check": "npx npm-check-updates --reject \"eslint,@eslint/js,typescript\" --dep prod,dev,optional,peer && npx npm-check-updates \"eslint,@eslint/js\" --target minor --deep peer && npx npm-check-updates typescript --target minor",
+    "ncu:update": "npx npm-check-updates --reject \"eslint,@eslint/js,typescript\" --dep prod,dev,optional,peer -u && npx npm-check-updates \"eslint,@eslint/js\" --target minor --deep peer -u && npx npm-check-updates typescript --target minor -u",
     "clean": "rimraf dist",
     "prebuild": "npm run clean",
     "build": "tsc -p tsconfig.build.json",
@@ -110,7 +103,8 @@
     "prepare": "husky",
     "format": "cross-env prettier --write 'src/**/*.ts' 'tests/**/*.ts' 'test-setup/**/*.ts' 'playwright.config.ts' '**/*.json' '**/*.md' '!package-lock.json' '!dist/**/*' '!build/**/*'",
     "postinstall": "playwright install chromium",
-    "setup": "node bin/setup.js"
+    "setup": "node scripts/setup.js",
+    "sync:playwright-cli-skill": "rm -rf templates/skills/playwright-cli && cp -r .claude/skills/playwright-cli templates/skills/playwright-cli"
   },
   "husky": {
     "hooks": {