web-spec-explorer

Drive a browser to document web UI behavior into structured specs.

Updated Feb 27, 2025
One-click install
npx skills add https://github.com/tuanemuy/dotfiles --skill web-spec-explorer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-spec-explorer
Source: https://github.com/tuanemuy/dotfiles/tree/main/config/claude/skills/web-spec-explorer
Command: npx skills add https://github.com/tuanemuy/dotfiles --skill web-spec-explorer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the discovery and documentation of web service specifications by driving a browser to surface UI behavior and user flows.

Core Features & Use Cases

  • Automates multi-agent exploration (scout, explorer, flow) to map site structure, pages, and user interactions.
  • Produces a structured spec under spec/ that captures screens, forms, controls, and navigation.
  • Supports phased analysis for both public and authenticated services, focusing on UI/UX flows rather than API details.

Quick Start

Provide the target URL and scope, then run the skill to generate a structured spec in spec/.

Frequently Asked Questions about web-spec-explorer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically document web service specifications from UI behavior?

You can automatically document web service specifications by driving a browser to surface UI behavior and user flows. This approach extracts page structures, forms, controls, and navigation to produce a structured spec under spec/.

Can I map user flows and page structures on authenticated sites?

Yes, you can map user flows and page structures on both publicly accessible and authenticated sites. The phased analysis focuses on UI/UX interactions rather than API details to capture the complete user experience.

How does phased web exploration work for discovering site navigation and forms?

Phased web exploration works by running multi-agent workflows—scout, explorer, and flow—to systematically map site structure, pages, and user interactions. It applies strict session handling and safety constraints to avoid submitting real data.

What is the best way to generate structured web specs without manual inspection?

The best way to generate structured web specs without manual inspection is automating browser exploration to capture screens and controls. You provide the target URL and scope, then the automation produces the spec in spec/.

Are there limitations when using agent browsers to extract UI controls and navigation?

Yes, limitations include avoiding submitting real data during extraction due to safety constraints, and the focus is strictly on UI/UX flows rather than capturing backend API details or request/response specifications.