fix(skills): remove broken default skills hub#306
Merged
cft0808 merged 1 commit intoApr 27, 2026
Conversation
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
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.
Summary
Issue: #297 — official skills hub URL returns 404
Type: Bug Fix
Severity: Medium
This PR removes the unavailable
openclaw-ai/skills-hubrepository from the default skill import path. The defaultimport-official-hubcommand now only imports a verified reachable default skill (mmx_cli), while users who maintain their own Skills Hub can still opt in withOPENCLAW_SKILLS_HUB_BASEor~/.openclaw/skills-hub-url.Closes #297.
Root Cause
The default import path in
scripts/skill_manager.pygenerated six URLs fromhttps://raw.githubusercontent.com/openclaw-ai/skills-hub/main. That repository currently returns 404, so bothadd-remoteexamples andimport-official-hubattempted to download unavailable files.Source -> Sink:
scripts/skill_manager.pydefault hub base ->OFFICIAL_SKILLS_HUBentries ->import_official_hub()->add_remote()->_download_file()_download_file()Fix Description
Changed files:
scripts/skill_manager.py:221— removed the broken built-in hub base and mirror fallbacks.scripts/skill_manager.py:225— added custom hub discovery viaOPENCLAW_SKILLS_HUB_BASEor~/.openclaw/skills-hub-url.scripts/skill_manager.py:240— kept only verifiedmmx_clias a default built-in skill.scripts/skill_manager.py:271— keptimport-official-hubcompatible, but defaulted each skill to its own recommended agents when--agentsis omitted.README.md:553— replaced brokencode_reviewexamples with the reachablemmx_cliURL.docs/remote-skills-guide.md:160— documented default skills and custom hub configuration.docs/remote-skills-quickstart.md— updated quickstart examples away from the 404 source.tests/test_skill_manager.py— added regression coverage for default URLs, custom hub opt-in, and recommended-agent import behavior.Rationale:
<base>/<skill>/SKILL.mdlayout explicitly.Test Results
python3 tests/test_skill_manager.pypython3 -m py_compile scripts/skill_manager.py tests/test_skill_manager.pyOPENCLAW_HOME=/tmp/edict-issue-297-openclaw python3 scripts/skill_manager.py import-official-hub --agents menxiammx_cliskillgit diff --checkrg ... openclaw-ai/skills-hub ...Manual verification before the fix:
curl -I https://github.com/openclaw-ai/skills-hubreturnedHTTP/2 404.curl -I https://raw.githubusercontent.com/openclaw-ai/skills-hub/main/code_review/SKILL.mdreturnedHTTP/2 404.curl -I https://raw.githubusercontent.com/MiniMax-AI/cli/main/skill/SKILL.mdreturnedHTTP/2 200.Disprove Analysis
是否已有其他地方修复
Checked current open PRs before implementing. PR #298 and PR #299 do not touch remote skills. The earlier merged PR #287 added
mmx_cli, but did not remove the brokenopenclaw-ai/skills-hubdefaults or documentation references.影响范围
Affected path is limited to remote skill import defaults and docs. Direct
add-remote --source <url>continues to work for any valid HTTPS URL. Existing local remote skills already installed under~/.openclaware not migrated or deleted.边界情况
When
--agentsis omitted, the command now imports each default/custom skill to its own recommended agents instead of building one combined agent list for every skill. If a user setsOPENCLAW_SKILLS_HUB_BASEor~/.openclaw/skills-hub-url, the legacy skill names are restored using<base>/<skill_name>/SKILL.md.已知局限
This PR does not introduce a replacement official Skills Hub. It intentionally keeps only verified reachable defaults and leaves custom hub selection explicit.
Checklist