@syngy/webskill-devtools

Local devtools for BotWorks web skill packages.

Every package must include package.json.name in @scope/package format. Each segment is 1-100 chars using lowercase letters, numbers, ., _, or -. BotWorks uses that name as the globally unique publish identity.

Generated web skill packages use npm scripts:

npm install
npm run check
npm run run -- --url https://example.com --tool check_current_page --args '{}'

Direct CLI usage:

npm exec --package @syngy/webskill-devtools -- webskill-devtools check .
npm exec --package @syngy/webskill-devtools -- webskill-devtools run . --url https://example.com --tool check_current_page --args '{}'

Commands

webskill-devtools check .
webskill-devtools run . --url https://example.com --tool check_current_page --args '{}'

check validates the package manifest, entry document, declared scripts, and script entrypoint. run launches a local browser, opens the target URL, injects context.pageTool, and executes the declared script in the page context.

Local Target Refs

Use data-webskill-ref in local HTML fixtures:

<input data-webskill-ref="query">

Then scripts can call:

await context.pageTool.element.fill({ ref: "query" }, "hello")