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: Apr 30, 2026, 2:22 PM5.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"
- 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.
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/slack-standup-digest
tools
VerifiedTrustedCommunity
Create an automation that generates an async standup digest from Slack. Searches selected channels for messages since the previous workday, groups updates by project, highlights blockers and decisions, and posts a summary to a target channel.
108SKILL.mdUpdated Jun 5, 2026
openhands/research-brief
tools
VerifiedTrustedCommunity
Create an automation that writes a recurring research brief. Uses Tavily MCP for web research and Notion MCP to publish the final brief with executive summary, implications, and source citations.
108SKILL.mdUpdated Jun 5, 2026
openhands/linear-triage
tools
VerifiedTrustedCommunity
Create an automation that triages new Linear issues. Inspects the issue title, description, team, customer, priority, and recent related issues via Linear MCP. Suggests labels, priority, likely owner, duplicates, and posts a clarifying comment.
108SKILL.mdUpdated Jun 5, 2026
openhands/incident-retrospective
tools
VerifiedTrustedCommunity
Create an automation that drafts incident retrospectives. Gathers incident-channel messages from Slack, collects linked tickets and follow-ups from Linear, and publishes a retrospective draft to Notion with a timeline, impact summary, root-cause hypotheses, and action items.
108SKILL.mdUpdated Jun 5, 2026