fix: reduce skill.md by 22% to prevent agents truncating docs (fixes #63)

`playwriter skill` output was ~58KB / 1302 lines. Agents (both Opus and
Sonnet) consistently truncated with `head` or skimmed, missing critical
sections like "working with pages" at line 606.

Reduced to 44KB / 1019 lines (−283 lines, −24%) by:

- Removing BAD examples from mistake sections, keeping only rules + correct patterns
- Removing duplicated sections: "checking page state" (duplicated interaction
  loop), "debugging web apps" (duplicated observation channels), "capabilities"
  list (obvious from rest of doc), "links that open new tabs" (duplicate of
  mistake #10)
- Condensing verbose sections: interaction feedback loop (removed ASCII diagram
  + Framer-specific 4-block example, replaced with compact generic example),
  getCleanHTML internals, recording prose, createDemoVideo (3 blocks → 1)
- Integrated debugging recipe (snapshot + logs + evaluate) into the feedback
  loop section as "deeper observation" examples
- Added explicit instruction in SKILL.md stub: "Do NOT pipe through head, tail,
  or any truncation command — read the entire output"
This commit is contained in:
Tommy D. Rossi
2026-03-07 09:25:10 +01:00
parent 4724383abc
commit 3a045c17d4
2 changed files with 60 additions and 343 deletions
+2
View File
@@ -21,6 +21,8 @@ This outputs the complete documentation including:
**Do NOT skip this step.** The quick examples below will fail without understanding timeouts, selector rules, and common pitfalls from the full docs.
**Read the ENTIRE output.** Do NOT pipe through `head`, `tail`, or any truncation command. The skill output must be read in its entirety — critical rules about timeouts, selectors, and common pitfalls are spread throughout the document, not just at the top.
## Minimal Example (after reading full docs)
```bash