diff --git a/browser_tests/AGENTS.md b/browser_tests/AGENTS.md
index b5cbe18c4..839471f35 100644
--- a/browser_tests/AGENTS.md
+++ b/browser_tests/AGENTS.md
@@ -5,6 +5,8 @@ See `@docs/guidance/playwright.md` for Playwright best practices (auto-loaded fo
 ## Directory Structure
 
 - `assets/` - Test data (JSON workflows, fixtures)
+- `fixtures/` - ComfyPage, ComfyMouse, and component fixtures
+- `helpers/` - Shared test utilities
 - Tests use premade JSON workflows to load desired graph state
 
 ## After Making Changes
@@ -12,3 +14,9 @@ See `@docs/guidance/playwright.md` for Playwright best practices (auto-loaded fo
 - Run `pnpm typecheck:browser` after modifying TypeScript files in this directory
 - Run `pnpm exec eslint browser_tests/path/to/file.ts` to lint specific files
 - Run `pnpm exec oxlint browser_tests/path/to/file.ts` to check with oxlint
+
+## Skill Documentation
+
+A Playwright test-writing skill exists at `.claude/skills/writing-playwright-tests/SKILL.md`.
+
+The skill documents **meta-level guidance only** (gotchas, anti-patterns, decision guides). It does **not** duplicate fixture APIs - agents should read the fixture code directly in `browser_tests/fixtures/`.