Skyvern/skyvern/cli/skills/README.md

80 lines
2.3 KiB
Markdown

# Skyvern Skills Package
AI-powered browser automation skills for coding agents. Bundled with `pip install skyvern`.
## Quick Start
```bash
pip install skyvern
# Recommended local self-hosted path:
skyvern quickstart # or: skyvern init
# choose local
# choose Claude Code during the MCP step
# You can also configure Claude Code later:
skyvern setup claude-code
```
The local wizard path writes project-local `.mcp.json`, pins the MCP command to
your active Python interpreter, and installs these skills into
`.claude/skills/` automatically. `skyvern setup claude-code` does the same
setup later if you skipped it during `quickstart` / `init`.
## What's Included
### qa
QA test your frontend changes in a real browser. Reads your `git diff`, generates
targeted browser tests, runs them against your local dev server, and reports
pass/fail with screenshots. Invoke with `/qa` in Claude Code.
### skyvern
CLI reference covering all browser automation capabilities:
- Browser session lifecycle (create, navigate, close)
- AI actions: act, extract, validate, screenshot
- Precision primitives: click, type, hover, scroll, select, press-key, wait
- One-off tasks with run-task
- Credential management and secure login flows
- Workflow CRUD, execution, monitoring, and cancellation
- Block schema discovery and validation
- Debugging with screenshot + validate loops
### smoke-test
CI-oriented smoke testing via Skyvern browser tools. Reads your `git diff`, generates
3-8 targeted smoke tests, runs each one via Skyvern browser tools (navigate, act,
validate, screenshot), and reports a pass/fail table as a PR comment. Invoke with
`/smoke-test` in Claude Code.
### testing
Deployment health check for verifying Skyvern installations.
## Structure
```
qa/
SKILL.md Diff-driven frontend QA testing
smoke-test/
SKILL.md CI-oriented smoke testing via Skyvern browser tools
skyvern/
SKILL.md Main skill file (CLI-first, all capabilities)
references/ 17 deep-dive reference files
examples/ Workflow JSON examples
testing/
SKILL.md Deployment health checking
```
## Manual Install
If you prefer to install skills without running setup:
```bash
skyvern skill copy --output .claude/skills
skyvern skill copy --output .agents/skills
```
## Validate
```bash
python scripts/validate_skills_package.py
```