add cua-cli + cua-agent skills#28
Draft
dprevoznik wants to merge 4 commits into
Draft
Conversation
New `cua` plugin documenting both the `cua` CLI (`@onkernel/cua-cli`) and the `@onkernel/cua-agent` TS library (`CuaAgent` / `CuaAgentHarness`). Single skill covers one-shot subcommands, named sessions, transcripts, model selection across providers, library quick start, live-view handoff for manual login, and the Playwright escape hatch for deterministic actions against the underlying Kernel browser. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Browser config: CLI hardcodes stealth-on; library is the opt-out path. - Adding your own tools: drop unverified `tool()` helper, point at pi-agent-core's AgentTool shape instead. - Cross-origin section: tighten library escape-hatch sentence. - Quick reference: split the trailing TS example into its own ts fence. - Named-session relaunch tip: clarify "same profile as before". Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Skills are loaded into coding-agent context, and the two audiences are distinct: agents driving the cua binary from shell vs humans asking Claude to write TS apps on @onkernel/cua-agent. Mirrors the repo's existing CLI-vs-SDK split (kernel-agent-browser vs kernel-typescript-sdk). - cua-cli: shell-callable subcommands, named sessions, profile persistence, live-view handoff, Playwright escape hatch, debugging. - cua-agent: CuaAgent / CuaAgentHarness quick start, browser provisioning, extraTools, setModel switching, SDK escape hatch, subscribe-based debugging. Plugin manifest description and the kernel/skills README list both. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Drop the standalone `cua` plugin. The repo organizes skills by audience (shell-driving vs SDK-authoring), not by product, so cua-cli sits alongside kernel-agent-browser in kernel-cli, and cua-agent sits alongside kernel-typescript-sdk in kernel-sdks. Users who already install those plugins get the cua skills for free. - plugins/kernel-cli/skills/cua-cli/SKILL.md (moved) - plugins/kernel-sdks/skills/cua-agent/SKILL.md (moved) - plugins/cua/ deleted - README install snippets and skill tables updated - cross-skill links in both SKILL.md files updated to reference the new plugin locations Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds two cua skills, slotted into the existing audience-based plugins:
cua-cli(inkernel-cliplugin) — drive a Kernel browser from shell via thecuabinary. One-shot subcommands, named sessions, profile persistence, transcripts, live-view handoff, Playwright escape hatch.cua-agent(inkernel-sdksplugin) — build TS apps that embed Kernel cua's loop with@onkernel/cua-agent(CuaAgent/CuaAgentHarness). Quick start, browser provisioning,extraTools,setModelswitching, SDK escape hatch,subscribe()-based debugging.Audience matches sibling skills:
cua-clisits next tokernel-agent-browser(same shell-driving audience),cua-agentnext tokernel-typescript-sdk(same app-authoring audience). No new plugin needed — users who already installkernel-cli/kernel-sdksget the cua skills automatically.Layout
Install (unchanged):
Notes
@onkernel/cua-cli,@onkernel/cua-agent,@onkernel/cua-ai) — no links into the privatekernel/cuarepo.kernel/cua/skills/cua-cli/stays in place for now; a follow-up will retire it and point at this plugin.Test plan
/plugin install kernel-clisurfacescua-clialongside the existing CLI skills/plugin install kernel-sdkssurfacescua-agentalongside the existing SDK skillscua-cliauto-loads on prompts about driving the cua binary;cua-agentauto-loads on prompts about writing TS code on the libraryCuaAgentHarness) runs end-to-end withopenai:gpt-5.5🤖 Generated with Claude Code