agent-experience agent skill by browserbase
Audits the developer experience of a product, SDK, or docs site by sending Claude subagents at it with only a tiny task prompt.
At a glance
| Publisher | Browserbase Official |
|---|---|
| Repository | browserbase/skills (18 listed skills) |
| Category | AI Agents and LLM Engineering |
| License | MIT |
| Last commit | September 1, 2026 (repository) |
| SKILL.md | 438 lines, 5,203 words |
| Bundled files | 6 files, including references, assets or templates |
| Quality score | 74/100 · C Passes all seven graded checks |
| Security scan | Not scanned |
| README badge | Get the listing badge and raise the score |
Before you install
Read from the skill's files at the directory's October 19, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.
- Bundled scripts: none.
- Credential names SKILL.md mentions:
BROWSERBASE_API_KEY,EXA_API_KEY,STRIPE_SECRET_KEY. - Tool permissions requested:
Read WebFetch Write Bash AskUserQuestion Agent(theallowed-toolsfield of SKILL.md). - License: MIT, an open-source or open-content license.
Install agent-experience
The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.
npx skills add https://github.com/browserbase/skills/tree/main/skills/agent-experiencetmp="$(mktemp -d)"
git clone --depth 1 https://github.com/browserbase/skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/agent-experience .claude/skills/
rm -rf "$tmp"python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
--repo browserbase/skills \
--path skills/agent-experiencebrowserbase/skills is third-party code. Read SKILL.md and any bundled scripts before you install it.
How the author describes it
Audit the developer experience of a product, SDK, docs site, or SKILL.md by dropping multiple Claude subagents at it with only a tiny task prompt and real tools (WebFetch, Bash, Write). Agents must discover the docs themselves, install deps, ask for credentials if needed, and attempt real execution. The skill captures each agent's trace — tool calls, retries, wall time, errors — and scores on Setup Friction, Speed, Efficiency, Error Recovery, and Doc Quality, then emits an HTML report with an A–F grade and concrete fixes. Use when the user asks to audit agent experience, test a skill, audit docs for agents, check if a SDK is agent-friendly, validate a SKILL.md, measure agent DX, or benchmark how painful onboarding is for an AI agent. Triggers: 'audit agent experience', 'test this skill', 'audit docs for agents', 'is my SDK agent-friendly', 'run a DX audit', 'agent experience test', 'test my docs', 'how do agents do with my product'.
From the description field of SKILL.md. Agents read this line to decide when to load the skill.
Compatibility, from SKILL.md
| Compatibility | Requires an agent harness with subagent (Agent tool), WebFetch, and Bash support, plus network access. No CLI install needed; audited products may require their own credentials at runtime. |
|---|
Sections in SKILL.md
- Core principle
- Workflow
- Step 1 — Identify the target and define the abstract goal
- Step 2 — Gather audit config via AskUserQuestion
- Step 2.5 — Credential auto-discovery (only if user picked Auto-discover)
- Step 3 — Safety check
- Step 4 — Generate tiny prompts (no checklist)
- Step 5 — Spawn N subagents in parallel
- Step 6 — Parse structured traces AND keep the full prose
- Step 6.25 — Annotate URL provenance per-WebFetch (inline in trace)
- Step 6.5 — Narrative cross-agent review (CRITICAL)
- Step 7 — Score the 5 Arena dimensions
- Step 8 — Synthesise findings
- Step 9 — Render the HTML report
- Step 10 — Save and surface
- Step 11 — Clean up workspaces
Files in the skill folder
LICENSE.txtSKILL.mdassets/report-template.htmlreferences/evaluation-rubric.mdreferences/prompt-variants.mdreferences/subagent-brief.md
Suede Skill Check: 74/100 · C
Report snapshot · · graded-v2
The rubric totals 100 points; published scores are capped at 99. Security scan: not scanned.
Source revision: 6811ca311633. Report version 74f4321f7503. Badge URLs follow the latest listing; save the report to keep this version.
Download report · Request a fresh review
What to review next
- Instruction depth: 1 of 7 points. 7 for a SKILL.md body of 500–3,000 words; 4 for 250–4,500; 1 for 100 or more.
- Description length: 1 of 5 points. 5 for 150–600 characters; 3 for 100–900; 1 for 50–1,024.
- Boundary clause: 0 of 4 points. 4 when the description says when not to use the skill (“Not for …”, “Do not use …”, “Use … instead”).
Add declarations and bundled files when they describe the skill’s actual needs. Update the source, then request a fresh review with the changed commit or PR.
agent-experience passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.
See the checks and points
| Check | Result |
|---|---|
| Frontmatter parses and declares a name and a description | Pass |
| Name uses lowercase letters, digits and hyphens, 64 characters or fewer | Pass |
| Name matches the skill's folder name | Pass |
| Description is between 50 and 1,024 characters | Pass |
| Description says when an agent should use the skill | Pass |
| SKILL.md body is 500 lines or fewer | Pass |
| A license is declared in the frontmatter or the repository | Pass |
| Repository has a commit in the last 12 months | Pass |
| Score component | Points |
|---|---|
| Structural checks | 56 of 56 |
| Description length | 1 of 5 |
| Boundary clause | 0 of 4 |
| Example request | 3 of 3 |
| Instruction depth | 1 of 7 |
| Reference files | 3 of 3 |
| Bundled scripts | 0 of 2 |
| Recent maintenance | 6 of 9 |
| Curated-list citations | 0 of 7 |
| Tool permissions declared | 2 of 2 |
| Compatibility declared | 2 of 2 |
Show the listing and raise the score
agent-experience is listed with 74/100 · C. This badge links to its Suede listing. Skills scoring 80–99 add a numeric and a letter quality shield; the largest open points for agent-experience are instruction depth (6), boundary clause (4) and description length (4). Send your repository and the points you want to raise, then request a fresh review after updating the skill.
[](https://skills.suedeai.ai/directory/browserbase/skills/agent-experience/)<a href="https://skills.suedeai.ai/directory/browserbase/skills/agent-experience/"><img src="https://skills.suedeai.ai/directory/badge.svg" alt="Suede Skills Directory: listed" height="20"></a>Where this skill is cited
browserbase/skills is listed from its publisher's official collection or a listing request.