Add comprehensive Skills and Plugins documentation#339
Open
juanmichelini wants to merge 3 commits intomainfrom
Open
Add comprehensive Skills and Plugins documentation#339juanmichelini wants to merge 3 commits intomainfrom
juanmichelini wants to merge 3 commits intomainfrom
Conversation
- Update keyword.mdx example to use github skill instead of yummy example - Add context management note explaining github/gitlab skills triggering - Create Adding New Skills guide explaining /add-skill action and storage locations - Create Creating New Skills guide with best practices for scope, naming, triggers, and content - Create Plugins overview explaining plugin structure and comparison with skills - Update docs.json navigation to include new pages in appropriate sections - Add cross-references between related documentation pages for better user flow Co-authored-by: openhands <openhands@all-hands.dev>
- Add Tip callout in Quick Start section mentioning skill-creator - Explain that users can ask OpenHands to 'create a skill' for guided assistance - Helpful for new users learning best practices Co-authored-by: openhands <openhands@all-hands.dev>
- Move skill-creator to be the first and primary method - Present manual approach as alternative for those who prefer it - Make it clear that skill-creator is the recommended starting point - Better reflects that guided creation is simpler than manual setup Co-authored-by: openhands <openhands@all-hands.dev>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Overview
This PR adds comprehensive documentation for Skills and Plugins, improving the user experience across all skill levels (new, experienced, and power users).
Changes
1. Updated Keyword Skills Example
2. Added "Adding New Skills" Page
/add-skillactionoverview/skills/adding.mdx(under Skills section)3. Added "Creating New Skills" Page
overview/skills/creating.mdx(under Tips and Tricks)4. Added Plugins Overview Page
overview/plugins.mdx(same level as Skills in Common Features)5. Updated Navigation Structure
6. Enhanced Cross-References
User Flow Analysis
New Users (don't know the terms yet)
Experienced Users (trying things out, want to scratch an itch)
Power Users (want to do things properly)
Tone and Style
All new content maintains consistency with existing docs:
Checklist