webmcp-gen
Create, compile, and validate site-specific WebMCP init scripts from a target URL and desired tool capability
Install / Use
npx skills add browserbase/skills --skill webmcp-genInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of webmcp-gen
webmcp-gen scores 86/100 on our quality scale, 2349th of 4,698 Development & Engineering skills we index (top 50%).
Its SKILL.md is 4.3 KB long, split into 6 sections with 10 code examples: a solid amount of guidance for an agent.
With 3,731 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so webmcp-gen is actively maintained.
- Our last check on 2026-11-03 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
webmcp-gen compared with similar skills
All 4 of these similar skills score higher than webmcp-gen; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| webmcp-gen (this skill)by browserbase | 86 | 3.7k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install webmcp-gen?
- Run
npx skills add browserbase/skills --skill webmcp-gen. The install tabs above show the steps for each supported agent. - Which AI agents does webmcp-gen work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is webmcp-gen safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is webmcp-gen still maintained?
- The repository was last updated about 2 months ago, so webmcp-gen is actively maintained.
Skill content
View source on GitHubname: webmcp-gen
description: Create, compile, and validate site-specific WebMCP init scripts from a target URL and desired tool capability. Use when the user wants to author WebMCP tools for a website, produce a webmcp.init.js artifact, or test WebMCP registration and invocation through Stagehand.
compatibility: "Requires Node 18+ and Chrome/Chromium with WebMCP testing flags. Run pnpm install in the skill directory to install the Stagehand dependency. Page exploration uses the browse CLI (npm install -g browse)."
license: MIT
allowed-tools: Bash Read Grep Edit Write
WebMCP Gen
Author website-specific WebMCP tools by writing a manifest, compiling it to an init script, and validating that Chrome registers and invokes the tools.
This skill does not call a nested agent. You are responsible for exploring the page, writing manifest.json, and iterating based on validation output.
Setup check
From the skill directory, install dependencies if they are not already installed:
cd skills/webmcp-gen
pnpm install
This installs the pinned Stagehand package plus the TypeScript toolchain (tsx,
typescript, @types/node) used to run the generated stagehand-example.ts.
Workflow
- Pick an artifact slug with exactly one slash:
<domain>/<task>
Example:
example.com/page-context
- Scaffold the artifact:
node scripts/scaffold.mjs example.com/page-context --url https://example.com
- Explore the target page with the
browseCLI:
browse open https://example.com --local
browse snapshot
browse get title
browse get url
browse get text body
browse get html body
Prefer browse snapshot, page text, and DOM inspection over screenshots unless visual layout matters. Use browse stop when exploration is complete.
-
Edit
artifacts/<domain>/<task>/manifest.json. The manifest is the source of truth. -
Compile:
node scripts/compile.mjs artifacts/example.com/page-context
- Generate a runnable Stagehand example (
stagehand-example.ts) and run it withtsx:
node scripts/generate-stagehand-example.mjs artifacts/example.com/page-context
npx tsx artifacts/example.com/page-context/stagehand-example.ts
- Validate:
node scripts/validate.mjs artifacts/example.com/page-context
- If validation fails, inspect
eval.jsonandeval-report.md, patchmanifest.json, then compile and validate again.
Manifest contract
{
"domain": "example.com",
"task": "page-context",
"url": "https://example.com",
"generatedAt": "2026-06-04T00:00:00.000Z",
"tools": [
{
"name": "example_com_page_context",
"description": "Returns page context.",
"inputSchema": {
"type": "object",
"properties": {},
"required": []
},
"implementation": {
"kind": "dom",
"source": "return { success: true, title: document.title, url: location.href };"
},
"fixtureInput": {}
}
]
}
Authoring rules
implementation.sourceis inserted insideasync (input) => { ... }; write JavaScript statements, not a full function wrapper.- Return a JSON-serializable object.
- WebMCP code runs inside the browser page. Use browser-native APIs:
document,location,navigator, and same-originfetch. - Do not use Playwright, Puppeteer, Stagehand, XPath helpers, or agent/browser commands inside
implementation.source. document.querySelectorandquerySelectorAllmust receive valid browser CSS selectors only.- To find visible text, use
Array.from(document.querySelectorAll(...)).find((el) => (el.textContent || "").includes("...")). - Do not include API keys, bearer tokens, cookies, localStorage secrets, or user credentials.
- Do not use
evalornew Function. - Avoid destructive actions unless the user explicitly asked for them.
- Make implementations defensive: check for missing elements and return structured
{ success: false, error: "..." }responses. - Generated init scripts register WebMCP tools only in the top frame.
Output layout
artifacts/<domain>/<task>/
manifest.json
webmcp.init.js
stagehand-example.ts
eval.json
eval-report.md
To turn the example into a standalone project, scaffold a Stagehand app with
npx create-browser-app and drop the generated webmcp.init.js into it (load it
with page.addInitScript({ path: "webmcp.init.js" })).
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
