Skip to content

yashvisal/school-agent / .agents/skills/agentation-self-driving

agentation-self-driving

Verified

Autonomous 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.

FileKindSize
SKILL.mdskill md10.9 KB
references/two-session-workflow.mdmarkdown2.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
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall