feat: add well-known skills discovery endpoint

2026-02-04 19:20:33 +01:00
parent 0b60fe844e
commit a718299b73
3 changed files with 119 additions and 0 deletions
@@ -0,0 +1,11 @@
+{
+  "skills": [
+    {
+      "name": "playwriter",
+      "description": "Control the user own Chrome browser via Playwriter extension with Playwright code snippets in a stateful local js sandbox via playwriter cli. Automate web interactions, take screenshots, inspect accessibility trees, debug & profile web applications. Run `playwriter skill` command to read the complete up to date skill",
+      "files": [
+        "SKILL.md"
+      ]
+    }
+  ]
+}
@@ -0,0 +1,30 @@
+---
+name: playwriter
+description: Control the user own Chrome browser via Playwriter extension with Playwright code snippets in a stateful local js sandbox via playwriter cli. Automate web interactions, take screenshots, inspect accessibility trees, debug & profile web applications. Run `playwriter skill` command to read the complete up to date skill
+---
+
+## REQUIRED: Read Full Documentation First
+
+**Before using playwriter, you MUST run this command:**
+
+```bash
+playwriter skill
+```
+
+This outputs the complete documentation including:
+- Session management and timeout configuration
+- Selector strategies (and which ones to AVOID)
+- Rules to prevent timeouts and failures
+- Best practices for slow pages and SPAs
+- Context variables, utility functions, and more
+
+**Do NOT skip this step.** The quick examples below will fail without understanding timeouts, selector rules, and common pitfalls from the full docs.
+
+## Minimal Example (after reading full docs)
+
+```bash
+playwriter session new
+playwriter -s 1 -e "await page.goto('https://example.com')"
+```
+
+If `playwriter` is not found, use `npx playwriter@latest` or `bunx playwriter@latest`.