Skills (formerly Microagents)
Skills allow you to extend OpenHands prompts with information specific to your project and define how OpenHands should function. See Skills Overview for more information.Setup Script
You can add a.openhands/setup.sh file, which will run every time OpenHands begins working with your repository.
This is an ideal location for installing dependencies, setting environment variables, and performing other setup tasks.
For example:
Hooks
You can add a.openhands/hooks.json file to run custom shell scripts at key moments during agent execution — such as
blocking dangerous commands, enforcing linting before the agent finishes, or logging tool usage.
See the dedicated Hooks page for the full guide.
Pre-commit Script
You can add a.openhands/pre-commit.sh file to create a custom git pre-commit hook that runs before each commit.
This can be used to enforce code quality standards, run tests, or perform other checks before allowing commits.
For example: