Skip to content

docs: Add documentation of skills to the CLI section #156

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
neubig wants to merge 6 commits into
base: main
Choose a base branch
from
Open

docs: Add documentation of skills to the CLI section #156

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
84e522b
docs: Clarify CLI skills documentation and add troubleshooting guide
openhands-agent Dec 7, 2025
dba9f1b
docs: Simplify CLI skills section and link to comprehensive docs
openhands-agent Dec 7, 2025
f01d7f9
docs: Refactor CLI skills documentation
openhands-agent Dec 7, 2025
e5c94c3
Update openhands/usage/run-openhands/cli-settings.mdx
neubig Dec 7, 2025
77a72a7
Address xingyaoww's review comments
openhands-agent Dec 19, 2025
7f1ba3d
Merge branch 'main' into openhands-workspace-rb86hg75
neubig Dec 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions overview/skills.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Each skill file may include frontmatter that provides additional information. In

| Platform | Support Level | Configuration Method | Implementation | Documentation |
|----------|---------------|---------------------|----------------|---------------|
| **CLI** | ✅ Full Support | `.openhands/skills/` directory | File-based markdown | This guide |
| **CLI** | ✅ Full Support | `~/.openhands/skills/` (user-level) and `.openhands/skills/` (repo-level) | File-based markdown | [CLI Settings](/openhands/usage/run-openhands/cli-settings#skills-configuration) |
| **SDK** | ✅ Full Support | Programmatic `Skill` objects | Code-based configuration | [SDK Skills Guide](/sdk/guides/skill) |
| **Local GUI** | ✅ Full Support | `.openhands/skills/` + UI | File-based with UI management | [Local Setup](/openhands/usage/run-openhands/local-setup) |
| **OpenHands Cloud** | ✅ Full Support | Cloud UI + repository integration | Managed skill library | [Cloud UI](/openhands/usage/cloud/cloud-ui) |
Expand All @@ -60,10 +60,13 @@ Each skill file may include frontmatter that provides additional information. In

<Tabs>
<Tab title="CLI">
- File-based configuration in `.openhands/skills/` directory
- File-based configuration in two locations:
- `~/.openhands/skills/` - User-level skills (all conversations)
- `.openhands/skills/` - Repository-level skills (current directory)
- Markdown format for skill definitions
- Manual file management required
- Supports both general and keyword-triggered skills
- See [CLI Skills Configuration](/openhands/usage/run-openhands/cli-settings#skills-configuration) for details
</Tab>
<Tab title="SDK">
- Programmatic `Skill` objects in code
Expand Down