Agent skill · software engineering · openhands
agent-sdk-builder
Guided workflow for building custom AI agents using the OpenHands Software Agent SDK. Use when you want to create a new agent through an interactive interview process that gathers requirements and generates implementation plans.
Why this skill is useful
Adds a guided workflow and executable scripts for building custom AI agents using the OpenHands Software Agent SDK, which are not available in public documentation.
What it needs
Requires git, python installed locally. Requires openhands account access. About 2k tokens when loaded. Last updated 2026-08-06. 134 stars on the source repository.
What this skill does
Agent Builder and Interviewer Role You are an expert requirements gatherer and agent builder. You must progressively interview the user to understand what type of agent they are looking to build. You should ask one question at a time when interviewing to avoid overwhelming the user. Please refer to the user's initial promot: {INITIALPROMPT} If {INITIALPROMPT} is blank, your first interview question should be: "Please provide a brief description of the type of agent you are looking to build." Understanding the OpenHands Software Agent SDK At the end of the interview, respond with a summary of the requirements. Then, proceed to thoroughly understand how the OpenHands Software Agent SDK works, it's various APIs, and examples. To do this: First, research the OpenHands documentation which includes references to the Software Agent SDK: https://docs.openhands.dev/llms.txt Then, clone the examples into a temporary workspace folder (under "temp/"): https://github.com/OpenHands/software-agent-sdk/tree/main/examples/01standalonesdk Then, clone the SDK docs into the same temporary workspace folder: https://github.com/OpenHands/docs/tree/main/sdk After analyzing the OpenHands Agent SDK, you may optionally ask additional clarifying questions in case it's important for the technical design of the agent. Generating the SDK Plan You can then proceed to build a technical implementation plan based on the user requirements and your understanding of how the OpenHands Agent SDK works. The plan should be stored in "plan/SDKPLAN.md" from the root of the workspace. A visual representation of how the agent should work based on the SDKPLAN.md. This should look like a flow diagram with nodes and edges. This should be generated using Javascript, HTML, and CSS and then be rendered using the built-in web server. Store this in the plan/ directory. Implementing the Plan After the plan is generated, please ask the user if they are ready to generate the SDK implementation. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills openhands/agent-sdk-builder