القائمة
Use when taking screenshots, PDFs, or video recordings with agent-browser in a Laravel project. Applies to any visual capture command including screenshot, pdf, and record.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Run the project's verification commands before claiming work complete. Use ALWAYS when finishing a task, claiming work done, committing, or creating a PR. Blocks completion until all checks pass.
Create atomic GitHub issues with clear acceptance criteria. Use when breaking down work into single-iteration tasks that can be picked up and completed independently.
Create well-structured GitHub milestones. Use when planning new phases of work that group related issues together.
Background knowledge about npm native binary corruption in Docker sandboxes
Laravel invokable controller patterns with Inertia. Use when creating endpoints, adding pages, building CRUD, or when user asks to "create an endpoint", "add a controller", "build a page", "add a store action", "create show page".
Inertia.js page component patterns with TypeScript. Use when creating pages or when user asks to "create a page", "build a component".
| name | agent-captures |
| description | Use when taking screenshots, PDFs, or video recordings with agent-browser in a Laravel project. Applies to any visual capture command including screenshot, pdf, and record. |
| allowed-tools | Bash(agent-browser:*), Bash(mkdir:*), Bash(npm:run build), Bash(rm:public/hot) |
Save all agent-browser visual captures to storage/app/agent-captures/ instead of temp directories or the project root.
Always build frontend assets before previewing. The sandbox can't reach the host's Vite dev server, so pages that load JS/CSS via Vite will appear blank.
# If the host was running `npm run dev`, Laravel will try to use dev server URLs.
# Delete the hot file so Laravel falls back to the build manifest.
rm -f public/hot
# Build assets using the sandbox's Linux-native node_modules
npm run build
Why this is necessary:
@vite directive checks for public/hot — if it exists, it serves http://localhost:5173/... URLslocalhost:5173 inside the sandbox is the sandbox itself, not the host's Vite dev serverpublic/hot and building makes Laravel serve static assets from public/build/manifest.jsonnpm run dev will recreate public/hot when restarted — no lasting impactDo this every time, even if you think assets are already built. It's fast and avoids blank-page debugging.
Every agent-browser screenshot, pdf, or record command MUST save to storage/app/agent-captures/.
# Ensure the directory exists first
mkdir -p storage/app/agent-captures
# Screenshots
agent-browser screenshot storage/app/agent-captures/homepage.png
agent-browser screenshot --full storage/app/agent-captures/homepage-full.png
# PDFs
agent-browser pdf storage/app/agent-captures/checkout.pdf
# Video recordings
agent-browser record start storage/app/agent-captures/login-flow.webm
Never use:
agent-browser screenshot with no path (saves to /tmp)agent-browser screenshot ./something.png (saves to project root)storage/app/agent-captures/Your human partner reviews these captures. Files in /tmp disappear. Files in the project root create clutter and git noise. storage/app/agent-captures/ is:
Use descriptive names that tell your partner what they're looking at:
# Good - descriptive, scannable
storage/app/agent-captures/checkout-layout-bug.png
storage/app/agent-captures/dashboard-after-fix.png
storage/app/agent-captures/login-flow.webm
# Bad - generic, meaningless
storage/app/agent-captures/screenshot.png
storage/app/agent-captures/page1.png
storage/app/agent-captures/capture.pdf
Even for "quick" screenshots during debugging, use the same path. It takes zero extra effort:
# This is just as fast
agent-browser screenshot storage/app/agent-captures/checkout-bug.png
# And your partner can actually find it later
"Throwaway debug artifacts" is not a reason to skip the standard path. Your partner asked to see the screenshot — make it findable.