# agent-experience Claude Code Skill

> Audits documentation readability for AI agents by running parallel onboarding tests

A Claude Code skill that stress-tests developer documentation and SDKs by spawning parallel Claude subagents to simulate real-world onboarding. The agents attempt installation and quickstart workflows across multiple languages, identifying friction points where LLMs get stuck. It outputs an HTML audit report featuring an overall grade, narrative findings, prioritized fixes, and individual agent execution traces.

## How it works

Flow shown in video: run /agent-experience in Claude Code → paste docs URL (example: https://docs.browserbase.com/welcome/introduction) → answer batched questions: parallel subagents (5/10), languages (TypeScript, Python), personas, exec mode, model (Sonnet/Opus/Haiku/mixed) → subagents attempt real onboarding (npm install, running quickstarts) → report: overall grade (Browserbase docs scored B 84/100), counts, narrative review, recommended fixes ranked by severity, what worked / what didn't, per-agent cards with tools, duration, status.

Findings example: hub pages lack runnable code; projectID should be explicit in quickstart; llms.txt underpromoted; playwright install chromium missing from Python quickstart.

Try at: https://www.skills.sh/browserbase/skills/agent-experience

## What it is for

- Audit developer documentation to evaluate how easily AI coding agents can navigate it
- Identify missing dependencies, unclear quickstart steps, or broken code snippets across Python and TypeScript
- Benchmark docs before and after publishing agent-specific resources like llms.txt

## Key points

- Invoked directly within Claude Code via the /agent-experience command
- Configurable test runs: set parallel subagent count (e.g., 5 or 10), target languages, and persona types
- Flexible execution models supporting Claude Sonnet, Opus, Haiku, or mixed setups
- Simulates real onboarding flows including package installations and quickstart script runs
- Generates detailed HTML audit reports with scores, severity-ranked fixes, and agent run traces

## Pricing

Free to install and run; requires Claude API usage via Claude Code.

## Details

- Type: Tip
- Category: [Development](https://xiry.app/topics/development.md)
- Open source: yes
- Platforms: Command line
- For: Developer advocates, technical writers, and software engineers building agent-facing tools and docs
- Tags: claude code, ai agents, documentation, dx, testing, benchmarking

## Why it was saved

- [@JaySahnan, 29 May 2026](https://x.com/JaySahnan/status/2060436658764517627): Reusable workflow worth trying on any docs site — the video shows the full flow and the report format (narrative review, fixes, per-agent traces). Launch tweet claims ~30% faster agent onboarding internally.

## Related

- [Playwright CLI](https://xiry.app/resources/playwright-cli): Command-line browser automation tool optimized for AI coding agents and testing. (GitHub repo, Open source)
- [agent-browser](https://xiry.app/resources/agent-browser): Browser automation CLI and engine purpose-built for AI agents (GitHub repo, Open source)
- [Remotion Agent Skills](https://xiry.app/resources/remotion-agent-skills): Agent skills enabling AI coding agents to create programmatic Remotion videos (GitHub repo, Open source)
- [Skills.sh](https://xiry.app/resources/skills-sh): Open directory and CLI for discovering and installing AI agent skills (Web app, Free)
- [agency-agents](https://xiry.app/resources/agency-agents): Curated library of specialized AI agent personas and workflows for Claude Code (GitHub repo, Open source)
- [Impeccable](https://xiry.app/resources/impeccable): Design vocabulary, rules, and skills for AI coding agents. (Web app, Free)

Updated 11 October 2026. Page: https://xiry.app/resources/agent-experience-claude-code-skill

Make your own library: Xiry takes your saved reels, tweets, Reddit bookmarks and Watch Later videos, makes them searchable and pulls the useful stuff out, like this library. It's invite-only for now; join the waitlist at https://xiry.app/#waitlist.