Skip to content

Conversation

@jpshackelford
Copy link
Contributor

This PR adds comprehensive documentation for the new skill packages feature introduced in the Agent SDK.

Changes

  • Added with complete documentation covering:
    • Installing skill packages
    • Discovering and inspecting packages
    • Loading skills from packages (configuration-based and programmatic)
    • Package manifest format
    • Creating custom packages
    • Integration with AgentContext

Related PRs

This documentation resolves the failing check in PR #1399 which requires all examples to be documented.

This adds comprehensive documentation for the new skill packages feature,
covering installation, loading, configuration, and package creation.

Related to: OpenHands/software-agent-sdk#1399

Co-authored-by: openhands <openhands@all-hands.dev>

Prerequisites:
1. Install a skill package:
pip install openhands-simple-code-review
Copy link
Collaborator

Choose a reason for hiding this comment

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

Do we want to recommend pip, or maybe we should stick to uv?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Definitely stick to uv.

3. Or use the package loading functions directly in code.

For more information on creating skill packages, see:
https://github.com/OpenHands/package-poc
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think this repository is super-secret 😅
404 here.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

oops. That repo is being carved up with its parts landing in our existing public projects so that reference shouldn't be there for sure.

…o references

- Changed all pip install commands to uv pip install
- Removed references to private OpenHands/package-poc repository

Co-authored-by: openhands <openhands@all-hands.dev>
Copy link
Contributor Author

✅ Review comments addressed:

  1. Changed pip to uv: All installation commands now use uv pip install instead of pip install
  2. Removed private repository references: All references to the package-poc repository have been removed

Changes were made in both the auto-synced code block and the documentation sections outside it.

Copy link
Contributor Author

📝 Note: The changes in the auto-synced code block (lines 12-256) will need the corresponding source file updated:

examples/01_standalone_sdk/31_use_skill_packages.py in the agent-sdk repository

The same changes should be made there:

  • Change pip install to uv pip install
  • Remove references to the private package-poc repository

This will ensure the changes persist when the code sync workflow runs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants