craft-rpa

Record real browser interactions and network traffic, then convert sessions into RPA-ready markdown traces.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/SilentFlower/flower-trellis --skill craft-rpa-silentflower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: craft-rpa
Source: https://github.com/SilentFlower/flower-trellis/tree/main/enhancements/common/.common/.claude/skills/craft-rpa
Command: npx skills add https://github.com/SilentFlower/flower-trellis --skill craft-rpa-silentflower

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes scripts (resource) components.

What problem does it solve? Manually documenting real browser workflows for RPA migration is slow and error-prone: engineers must capture clicks, form inputs, network requests, and page states across complex SPAs and strict-CSP sites, then translate them into automation steps for tools like UiPath, Power Automate, Selenium, or Playwright. ## Core Features & Use Cases - Browser Flow Recording: Launch a real Chrome session via Playwright, capture interactions, Fetch/XHR requests with full headers and bodies, navigation, and errors into per-session JSONL files. - AI Page Perception and Control: Observe pages (text, ARIA snapshot, interactive elements, screenshots) and execute click/fill/type/press/select/check actions through a unified control API with ambiguity detection. - Trace Conversion and Refinement: Convert session.jsonl into a lossless markdown trace, then refine it into an RPA draft with business step naming, selector sets, and noise annotation. - Use Case: Record an Oracle registration flow once, generate trace.md with all selectors and network assertions, then hand the refined rpa-draft.md to engineers building the UiPath or Playwright automation. ## Quick Start Ask the AI to start recording a browser session for a target URL, perform the workflow, then stop and convert the session into an RPA trace document.

Frequently Asked Questions about craft-rpa

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

FAQPage Schema
How do I record a browser session for RPA automation?▼

Run the skill's run.sh start command with a target URL to launch a Chrome session that captures interactions, network requests, and navigation into a timestamped session.jsonl file. Stop with run.sh stop, then run run.sh craft to convert the recording into a markdown trace.

How to capture XHR and fetch requests with Playwright?▼

The recorder uses Playwright BrowserContext request, requestfinished, and requestfailed events to capture Fetch/XHR across the main page, cross-origin iframes, and observable Service Workers. Full headers and text bodies up to 20 MiB per direction are stored in the session JSONL.

Can AI control the browser during recording?▼

Yes, the control API supports observe, click, fill, type, press, select, check, and uncheck actions against the live recording browser. Targets use one locator strategy such as selector, role, text, label, placeholder, or testId, and ambiguous matches return an AMBIGUOUS_TARGET error with candidates.

Does this work on WSL2 or headless Linux environments?▼

WSL2 requires WSLg so the browser window can display; verify with echo $DISPLAY. For headless verification only, set CRAFT_RPA_HEADLESS=true, and use CRAFT_RPA_USE_SYSTEM_CHROME=false with npx playwright install chromium if system Chrome is unavailable.

What are the limitations of browser flow recording for RPA?▼

It is not suited for unattended CI testing, parallel multi-machine recording, or anti-bot evasion. The generated trace.md is a mechanical translation for human or AI refinement into RPA steps, not an executable replay script.

Why does the recorder show zero events in the Dashboard?▼

Zero events usually mean the inject script or Playwright binding failed to install, or port 7777 is occupied by another process. Check run.sh logs for boot and fatal messages, or set CRAFT_RPA_PORT to a free port and restart.