Skip to content

Add Skills and Plugins documentation #339

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
juanmichelini wants to merge 17 commits into
base: main
Choose a base branch
from
Open

Add Skills and Plugins documentation #339

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
78a3340
Add comprehensive skills and plugins documentation
juanmichelini Feb 16, 2026
d261d29
Add reference to skill-creator skill in Creating New Skills guide
juanmichelini Feb 16, 2026
a201cec
Reorder Quick Start to emphasize skill-creator as easiest approach
juanmichelini Feb 16, 2026
80c73db
Merge branch 'main' into add-skills-plugins-documentation
juanmichelini Mar 5, 2026
8fec845
Merge branch 'main' into add-skills-plugins-documentation
juanmichelini Mar 6, 2026
9d22deb
Fix JSON syntax errors in docs.json
openhands-agent Mar 6, 2026
efd9fba
Address PR #339 review feedback: Add monitoring docs and remove super…
juanmichelini Mar 11, 2026
e748f80
Merge monitoring documentation and style updates
juanmichelini Mar 11, 2026
10d31ce
Merge branch 'main' into add-skills-plugins-documentation
juanmichelini Mar 12, 2026
41c007d
Delete DOCS_UPDATES.md
juanmichelini Mar 13, 2026
0a18c7e
Update adding.mdx
juanmichelini Mar 13, 2026
69bca81
Update overview/plugins.mdx
juanmichelini Mar 14, 2026
604f1b7
Update docs.json
juanmichelini Mar 14, 2026
7e194f2
Merge branch 'main' into add-skills-plugins-documentation
juanmichelini Mar 14, 2026
46c42cb
Remove duplicate navigation entries in docs.json
openhands-agent Mar 14, 2026
4a8f7ab
Merge branch 'main' into add-skills-plugins-documentation
juanmichelini Mar 23, 2026
779b144
Merge origin/main and fix plugin docs accuracy
openhands-agent Apr 3, 2026
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 docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,8 @@
"pages": [
"openhands/usage/customization/repository",
"openhands/usage/customization/hooks",
"overview/skills/repo"
"overview/skills/creating",
Copy link
Copy Markdown
Contributor

@all-hands-bot all-hands-bot Apr 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Suggestion: Navigation organization clarification.

The PR description states that "Creating New Skills" is located "under Tips and Tricks section", but it's actually placed under "Customization and Skills" (line 42-50). Meanwhile, the main "Skills" group is nested under "Essential Guidelines" (lines 57-66).

This organization might be intentional (separating how-to guides from reference material), but consider:

  1. If intentional: Update the PR description to accurately reflect "under Customization and Skills" instead of "under Tips and Tricks"
  2. If unintentional: Consider moving creating and monitoring into the main "Skills" group for better discoverability

Current structure:

  • Customization and Skills → creating, monitoring (how-to guides)
  • Essential Guidelines → Skills → overview, types, adding (reference)

Alternative structure:

  • Essential Guidelines → Skills → all skill-related pages grouped together

Either approach works, but the PR description should match the actual implementation.

"overview/skills/monitoring"
]
},
{
Expand All @@ -59,9 +60,11 @@
"overview/skills/repo",
"overview/skills/keyword",
"overview/skills/org",
"overview/skills/public"
"overview/skills/public",
"overview/skills/adding"
]
},
"overview/plugins",
{
"group": "Settings",
"pages": [
Expand Down
Loading
Loading