Summary

Adds an optional openhands skill under optional-skills/autonomous-ai-agents/ so the agent can delegate coding tasks to the OpenHands CLI alongside claude-code / codex / opencode. OpenHands is the model-agnostic member of that family — any LiteLLM-supported provider (OpenAI, Anthropic, OpenRouter, DeepSeek, Ollama, vLLM, etc.).

Closes #477.

Why a ground-truth rewrite of #19325

#19325 (by @xzessmedia / Tim Koepsel) was drafted with OpenHands itself, and the LLM hallucinated several flags that don't exist in the real CLI:

Rewrote from scratch against a verified install + a real --headless --json end-to-end run on openrouter/openai/gpt-4o-mini. Author credit preserved in the author: frontmatter (Tim Koepsel (xzessmedia), Hermes Agent) and via an AUTHOR_MAP entry in scripts/release.py. Original PR will be closed with credit + a link to this one.

Changes

Validation

Live install + end-to-end run in ~/scratch/openhands-spike/:

$ uv tool install openhands --python 3.12     # success
$ openhands --version                          # OpenHands CLI 1.16.0 (SDK v1.21.0)
$ OPENHANDS_SUPPRESS_BANNER=1 LLM_MODEL=openrouter/openai/gpt-4o-mini ... \
    openhands --headless --json --override-with-envs --exit-without-confirmation \
    -t 'Create a file hello.txt with the contents: Hello from OpenHands. Then list files.'
# → FileEditorAction (create) → TerminalAction (ls) → FinishAction. ~10s. Sub-cent.

$ ... --resume f46573d9-cfdb-45e4-92ca-189bde40019b -t 'Now read hello.txt'
# → FileEditorAction (view) → FinishAction with file contents. Resume verified.

Pitfalls landed in the SKILL because they hit during the spike — not because the upstream README mentioned them:

• LiteLLM bedrock/sagemaker warnings on every invocation (stderr noise, botocore not installed)
• Banner spam unless OPENHANDS_SUPPRESS_BANNER=1
• --override-with-envs mandatory in headless or the CLI ignores LLM_* env vars and hangs on first-run setup
• LiteLLM model slug double-prefix via OpenRouter (openrouter/anthropic/claude-sonnet-4.5, not anthropic/claude-sonnet-4-5)
• Resume ID has two forms (32-hex vs dashed UUID); the dashed form is what --resume wants
• --llm-approve is rejected in headless mode (argparse error)

Notes

• Description: 59 chars (under the 60-char hardline).
• Frontmatter follows current optional-skill convention: version: 0.1.0, license: MIT, platforms: [linux, macos], contributor-first author field.
• Auto-gen docs regen produced ~80 drift edits across unrelated skills (link-prefix migration + 2 missing siblings); discarded per skill-salvage scope discipline. Only the openhands row / page / sidebar entry is touched.

Infographic