A Kane CLI skill is a markdown instruction file that teaches an AI coding agent how to use
kane-cli: when to invoke it, how to build commands, how to parse NDJSON output, how to present results, and how to handle failures. Install the skill once, and your agent handles browser automation tasks automatically whenever you ask.
Skills work on top of Agent Mode (--agent flag). The skill tells the agent to always use --agent, parse the NDJSON stream, and present structured results back to you.
Skills are plain markdown files. Review and customize them by editing the installed file after download.
Install
The quickest way to install the Kane CLI skill globally for all supported agents (Claude Code, Codex CLI, and Gemini CLI) in one command:Install by Agent
- Claude Code
- Codex CLI
- Gemini CLI
The Kane CLI skill for Claude Code is a Project-level install (available only in this project):After installing, Claude Code automatically loads the skill. No restart required.What Claude can do with this skill:
SKILL.md file placed in your skills directory.Global install (available in all projects):- Recognize when your request involves a browser and invoke
kane-cliautomatically - Build properly structured
kane-cli run --agentcommands - Parse the NDJSON output and present structured results with step counts, duration, extracted values, and assertion results
- Inspect failure logs and screenshots to diagnose issues
- Run multiple browser tests in parallel using sub-agents
- Suggest bug reports for agent failures, linked to the GitHub repo
First-Time Auth in Agent Contexts
OAuth login opens a browser window: AI agents cannot complete this flow. Use Basic Auth instead:kane-cli whoami.
How Skills Work
When you ask your AI agent to test something on the web, the skill:- Checks
kane-cliis installed (kane-cli --version) - Verifies authentication (
kane-cli whoami) - Builds a
kane-cli run --agent --headlesscommand from your request - Parses the NDJSON stream, waits for
run_end - Presents structured results: status, steps, duration, extracted values, assertion results
- If failed: inspects
run_dirlogs and screenshots to diagnose the issue - Rates the run and suggests a bug report for low-quality agent failures
Skill File Locations
| Agent | Global | Project-level |
|---|---|---|
| Claude Code | ~/.claude/skills/kane-cli/SKILL.md | .claude/skills/kane-cli/SKILL.md |
| Codex CLI | ~/.codex/AGENTS.md (appended section) | AGENTS.md (appended section) |
| Gemini CLI | ~/.gemini/skills/kane-cli/SKILL.md | .gemini/skills/kane-cli/SKILL.md |