yashvisal/school-agent / .agents/skills/agentation-self-driving
agentation-self-driving
VerifiedAutonomous design critique mode using the Agentation annotation toolbar. Use when the user asks to "critique this page," "add design annotations," "review the UI," "self-driving mode," "auto-annotate," or wants an AI agent to autonomously add design feedback annotations to a web page via the browser. Requires the Agentation toolbar to be installed on the target page and agent-browser skill to be available.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.9 KB |
| references/two-session-workflow.md | markdown | 2.4 KB |
references/two-session-workflow.md
View on GitHub# Two-Session Self-Driving Workflow
Full autonomous design review: one agent critiques, another fixes.
## Prerequisites
- Agentation toolbar installed on the target page
- MCP server running and connected (toolbar shows "MCP Connected")
- `agent-browser` skill installed
## Setup
### Terminal 1 — The Critic (this skill)
```bash
claude
> /agentation-self-driving
```
This session opens the headed browser, scans the page, and adds design annotations. The user watches the browser as the agent navigates and critiques.
### Terminal 2 — The Fixer
```bash
claude
> Watch for agentation annotations and fix each one. Use agentation_watch_annotations
> in a loop. For each annotation: read the target code, make the fix, then call
> agentation_resolve with a summary of what you changed.
```
This session blocks on `agentation_watch_annotations`, receives each annotation as it's created by Terminal 1, and edits the codebase to address the feedback.
## How It Connects
1. Critic adds annotation → auto-sent via MCP webhook
2. Fixer's `agentation_watch_annotations` unblocks with the new annotation
3. Fixer reads the annotation (element path, CSS selectors, feedback text)
4. Fixer greps the codebase using the selectors/component names
5. Fixer makes changes, then calls `agentation_resolve` with a summary
6. Fixer loops back to `agentation_watch_annotations`
## Flow Diagram
```
Browser (visible) Terminal 1 (Critic) Terminal 2 (Fixer)
───────────────── ─────────────────── ──────────────────
User watches cursor → Scrolls, clicks elements Blocking on watch...
Annotation dialog → Fills critique, clicks Add
Annotation auto-sends → Receives annotation
Reads code, makes fix
Resolves annotation
Moves to next element → Blocking on watch...
```
## Tips
- Start the Fixer session first so it's ready when annotations arrive
- The Critic can add annotations faster than the Fixer processes them — that's fine, they queue up
- If the page hot-reloads from Fixer's changes, the Critic may need to re-expand the toolbar
- Both sessions share the same MCP server via `.mcp.json` in the project
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |