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.