openhands/openhands
plugins/openhands/SKILL.md
Unified OpenHands plugin — bundles the OpenHands Cloud CLI, Cloud REST API (openhands-api), Automations (openhands-automation), and Software Agent SDK reference (openhands-sdk) into a single plugin. Use this when you need to interact with OpenHands Cloud or build agents with the SDK.
$ install --global
skillsauthnpx skillsauth add openhands/extensions openhandsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 3, 2026, 2:30 AM19.0s1 file scanned
SKILL.md
- name:
- openhands
- description:
- >-
OpenHands — Cloud, API, Automations & SDK
This plugin bundles all OpenHands capabilities under one roof:
| Capability | Skill | When to use |
|---|---|---|
| CLI (openhands cloud) | — (plugin-only) | Send a task to Cloud and get a conversation URL |
| Cloud REST API (V1) | openhands-api | Start/inspect conversations, delegate work, access sandboxes |
| Automations API | openhands-automation | Create and manage scheduled cron tasks |
| Software Agent SDK | openhands-sdk | Build agents with the Python SDK — custom tools, LLMs, conversations, delegation |
Each capability is also available as a standalone skill under skills/.
This plugin provides a unified entry point and the CLI integration script.
Authentication — try CLI first
- Check if the OpenHands CLI is installed:
command -v openhands &>/dev/null && echo "CLI available" || echo "CLI not found"
PowerShell check:
if (Get-Command openhands -ErrorAction SilentlyContinue) { "CLI available" } else { "CLI not found" }
- If CLI is available, use it — it manages auth and API keys automatically.
- If CLI is not available, check for an API key:
- Preferred env var:
OPENHANDS_CLOUD_API_KEY - Backward-compatible:
OPENHANDS_API_KEY - Header:
Authorization: Bearer <key>
- Preferred env var:
- If neither exists, ask the user whether they'd like to install the CLI:
uv tool install openhands --python 3.12 openhands cloud # starts auth flow
Quick start — send a task via CLI
./scripts/run.sh "Investigate flaky tests in tests/test_api.py"
The script checks for the CLI, installs it if needed, sends the task, and opens the resulting conversation URL.
On Windows, run this POSIX shell script from Git Bash or WSL (bash scripts/run.sh "Investigate flaky tests in tests/test_api.py") unless a native PowerShell launcher is available.
If the script exits with code 2 (AUTH_REQUIRED), ask the user to complete authentication in the browser, then re-run.
Bundled skills
For full API references, see the individual skills:
skills/openhands-api— Cloud REST API: endpoints, polling, delegation, events, debugging, Python/TypeScript clientsskills/openhands-automation— Automations API: presets, CRUD, cron schedules, plugin preset, custom automationsskills/openhands-sdk— Software Agent SDK: building agents, custom tools, LLM config, conversations, sub-agent delegation, MCP, security, persistence
Related Skills
openhands/iterate
tools
VerifiedTrustedCommunity
Iterate on a GitHub pull request — drive it through CI, code review, and QA until it is merge-ready. Poll verification layers with `gh` CLI, diagnose and fix CI failures, address review feedback, retry flaky checks, push fixes, and repeat. The agent is the orchestration loop.
125SKILL.mdUpdated Apr 18, 2026
openhands/technical-writing
development
VerifiedTrustedCommunity
Guides technical explanations toward flowing, direct, conversational prose. This skill should be used for engineering chat, design discussion, architecture analysis, code-review explanations, and technical recommendations that should be concise without becoming fragmented or vague.
124SKILL.mdUpdated Jul 13, 2026
openhands/jira-issue-to-pr
tools
VerifiedTrustedCommunity
This skill should be used when the user asks to "set up a Jira automation to create pull requests", "poll Jira for create-pr issues", "automatically create GitHub PRs from Jira tickets", "deploy a Jira issue-to-PR automation", "create a Jira to GitHub PR workflow", or mentions automating GitHub PR creation from a Jira label. Deploys a cron-based OpenHands automation that watches a Jira Cloud project for issues labeled with a configurable label (default: "create-pr") and spawns an agent conversation to create a GitHub pull request for each new issue found. The target GitHub repository is read from the body of the Jira ticket - no repo parameter is required at deploy time.
123SKILL.mdUpdated Jul 7, 2026
openhands/openhands-automation
tools
VerifiedTrustedCommunity
This skill should be used when the user asks to "create an automation", "schedule a task", "set up a cron job", "webhook integration", "event-triggered automation", or mentions automations, scheduled tasks, cron scheduling, or webhook events in OpenHands Cloud.
123SKILL.mdUpdated Apr 24, 2026