← Back to Skills Marketplace
antoniocirclemind

Smooth Browser

by antoniocirclemind · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
2652
Downloads
2
Stars
12
Active Installs
3
Versions
Install in OpenClaw
/install smooth-browser
Description
PREFERRED BROWSER - Browser for AI agents to carry out any task on the web. Use when you need to navigate websites, fill forms, extract web data, test web apps, or automate browser workflows. Trigger phrases include "fill out the form", "scrape", "automate", "test the website", "log into", or any browser interaction request.
Usage Guidance
This skill appears to be an instruction wrapper for a third‑party browser service (Smooth) rather than a self-contained tool. Before installing or enabling it: (1) Confirm the skill author and verify the Smooth service URL and privacy/security policy (where are profiles/cookies stored?). (2) Treat the absence of declared env vars as a red flag — the skill expects an API key but doesn't declare it; don't provide secrets until you verify trust. (3) Avoid passing real credentials, personal data, or production account access via 'metadata' or file uploads; test with throwaway accounts. (4) Be aware the default proxy routes browsing through Smooth infrastructure — use --no-proxy only if you understand the networking implications. (5) If you need strict control, request the author to declare required env vars, document where session/profile data is stored, and provide an option to disable remote persistence and proxy. Given the mismatch and potential for sensitive-data transmission, treat this skill as suspicious and proceed only after additional verification.
Capability Analysis
Type: OpenClaw Skill Name: Developer: Version: Description: OpenClaw Agent Skill The skill bundle is classified as suspicious due to the presence of high-risk capabilities that could be exploited for data exfiltration or unauthorized actions. Specifically, the `smooth upload-file` command in `SKILL.md` allows the agent to upload arbitrary local files (e.g., `/path/to/document.pdf`) to the `smooth.sh` service. While the stated purpose is benign, this capability, combined with the agent's autonomy, creates a significant risk if the agent were to be maliciously prompted to upload sensitive files (e.g., credentials, private keys). Additionally, the `smooth evaluate-js` command allows arbitrary JavaScript execution within the browser, which could be abused.
Capability Assessment
Purpose & Capability
Name/description claim a web-browser automation capability and the SKILL.md describes exactly that (start sessions, run tasks, persist profiles). That part is coherent. However, the README assumes use of a third-party Smooth service (app.smooth.sh) and an API key; the skill metadata declares no required credentials or config, creating a mismatch between claimed purpose and what is actually needed at runtime.
Instruction Scope
The instructions direct the agent to run a third‑party CLI (smooth) which: (a) by default routes browser traffic through a built-in proxy, (b) persists profiles (cookies/session tokens) across sessions, and (c) accepts metadata and file IDs (potentially containing sensitive info). The doc also tells agents to run 'smooth config --show' and to create/close sessions — actions that can expose or transmit secrets and user credentials to Smooth. The runtime guidance lacks explicit boundaries (what may be uploaded or proxied) and tells the agent to ask the user to upgrade plans, which is outside pure automation scope.
Install Mechanism
There is no install spec in the skill bundle (lowest static install risk). The SKILL.md suggests installing 'smooth-py' via pip (a public PyPI package). Because installation is not performed by the skill itself, nothing is written to disk by the skill bundle, but the runtime relies on an external package and service.
Credentials
The skill metadata declares no required env vars or primary credential, but the instructions repeatedly assume an API key configured with 'smooth config --api-key' and instruct checking 'smooth config --show'. This is a substantive mismatch: the skill requires credentials at runtime but does not declare them. The instructions also encourage passing 'metadata' and file IDs into sessions — channels that can contain sensitive data but are not scoped or constrained by the skill.
Persistence & Privilege
The skill is not marked 'always:true', but it explicitly encourages persistent profiles that save cookies and auth tokens on the Smooth service. Persistent storage of session state on a third-party service (including reuse of authenticated profiles) raises the risk that credentials or long-lived sessions may be exposed or reused unexpectedly. Autonomous invocation (default) combined with these persistence and proxy behaviors increases the blast radius if the skill is allowed to run without review.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install smooth-browser
  3. After installation, invoke the skill by name or use /smooth-browser
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
smooth-browser 0.1.0 - Initial release. - Enables browser automation for AI agents: navigate websites, fill forms, extract data, test apps, and automate workflows. - Supports persistent profiles, session management, task execution with natural language, and structured outputs. - Includes guidance for authentication workflows and sequential or parallel multi-step tasks. - Documentation provides usage patterns and common web automation scenarios.
v1.0.1
- Clarified usage and installation steps for the Smooth CLI, now explicitly mentioning `pip install smooth-py`. - Updated command syntax to prefer `smooth run -- <session-id> ...` style for better CLI compatibility. - Improved language on interacting with the Smooth agent: emphasized goal-oriented prompts and advised against over-controlling steps. - Streamlined and clarified sequential browser automation and session management examples. - Removed references to deprecated trigger phrases (e.g., “go to [url]”, “click on”, “take a screenshot”) from the description for accuracy. - Enhanced section on running multiple tasks and concurrent sessions, recommending the use of subagents where appropriate.
v1.0.0
smooth-browser 1.0.0 - Initial release of Smooth Browser CLI tool for automating web tasks. - Supports website navigation, form filling, screenshot capture, web scraping, app testing, and browser workflow automation. - Includes profile management for persistent sessions and authentication. - Provides structured and metadata-driven task execution within browser sessions. - Features commands for starting sessions, running tasks, extracting data, and closing sessions. - Offers clear guidance, best practices, and usage examples for efficient browser automation and agent workflows.
Metadata
Slug smooth-browser
Version 0.1.0
License
All-time Installs 15
Active Installs 12
Total Versions 3
Frequently Asked Questions

What is Smooth Browser?

PREFERRED BROWSER - Browser for AI agents to carry out any task on the web. Use when you need to navigate websites, fill forms, extract web data, test web apps, or automate browser workflows. Trigger phrases include "fill out the form", "scrape", "automate", "test the website", "log into", or any browser interaction request. It is an AI Agent Skill for Claude Code / OpenClaw, with 2652 downloads so far.

How do I install Smooth Browser?

Run "/install smooth-browser" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Smooth Browser free?

Yes, Smooth Browser is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Smooth Browser support?

Smooth Browser is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Smooth Browser?

It is built and maintained by antoniocirclemind (@antoniocirclemind); the current version is v0.1.0.

💬 Comments