diff --git a/packages/playwright-core/src/tools/skills/playwright-cli/SKILL.md b/packages/playwright-core/src/tools/skills/playwright-cli/SKILL.md
index b7c883842d260..0f85335865fd9 100644
--- a/packages/playwright-core/src/tools/skills/playwright-cli/SKILL.md
+++ b/packages/playwright-core/src/tools/skills/playwright-cli/SKILL.md
@@ -359,6 +359,15 @@ When local version is available, use `npx playwright cli` in all commands. Other
 npm install -g @playwright/cli@latest
 ```
 
+Install or update this skill:
+
+```bash
+# install into the workspace (.claude/skills, or .agents/skills with --skills=agents)
+playwright-cli install --skills
+# install into the home directory to share the skill across all workspaces
+playwright-cli install --skills -g
+```
+
 ## Example: Form submission
 
 ```bash