Skip to content

Conversation

@xingyaoww
Copy link
Contributor

Overview

This PR updates the SDK skill documentation to reflect the new load_public_skills feature added in OpenHands/software-agent-sdk#1248.

Changes

Updated Example Code

  • Synced the example code in skill.mdx with the latest version from 03_activate_skill.py
  • Added comments explaining AgentContext capabilities
  • Included the public skill test case

New Documentation Section: "Loading Public Skills"

Added comprehensive documentation covering:

Automatic Loading via AgentContext

  • How to enable public skills with load_public_skills=True
  • Explanation of the automatic cloning/updating process
  • Skill precedence rules (explicit skills take precedence)

Programmatic Loading

  • Manual loading with load_public_skills() function
  • Examples of combining public skills with custom skills
  • More granular control over skill loading

Custom Skills Repository

  • Support for loading skills from custom repositories
  • Custom branch specification

How It Works

  • Git-based caching mechanism explained
  • First run vs. subsequent runs behavior
  • Offline mode fallback

Related PRs

Benefits

This documentation helps users:

  1. Access the latest community skills without waiting for SDK updates
  2. Understand the caching mechanism for efficient skill loading
  3. Configure custom skill repositories if needed
  4. Properly handle skill precedence and merging

@xingyaoww can click here to continue refining the PR

Add comprehensive documentation for the new load_public_skills feature:
- Update example code to reflect the latest version
- Add new section 'Loading Public Skills' with subsections:
  - Automatic loading via AgentContext
  - Programmatic loading for manual control
  - Custom skills repository support
  - Explanation of git-based caching mechanism
- Document skill precedence rules
- Add note about exploring the public skills repository

Related to OpenHands/software-agent-sdk#1248

Co-authored-by: openhands <openhands@all-hands.dev>
@enyst
Copy link
Collaborator

enyst commented Nov 26, 2025

@OpenHands Investigate this PR a bit and explain to me what happens here: normally the examples/ directory example script from the SDK is automatically sync here in docs. But that's not the case here, the contents of the script included in the mdx are different I think. Clone yourself software-agent-sdk from the same org and verify.
What's up and how do we fix it?

@openhands-ai
Copy link

openhands-ai bot commented Nov 26, 2025

I'm on it! enyst can track my progress at all-hands.dev

• Updated sdk/guides/skill.mdx to match examples/01_standalone_sdk/03_activate_skill.py from software-agent-sdk@8e296334
• Ran sync script against local agent-sdk checkout to ensure exact parity
• Also refreshed other SDK guide code blocks that had drifted during the same sync run

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

@enyst enyst left a comment

Choose a reason for hiding this comment

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

Interesting amount of changes, we were behind. Let's merge this to catch up quick, and will propose a fix.

@enyst
Copy link
Collaborator

enyst commented Nov 27, 2025

Quick look on deployment looks good.

@enyst enyst merged commit 07c45a4 into main Nov 27, 2025
2 checks passed
@enyst enyst deleted the add-load-public-skills branch November 27, 2025 08:44
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