openclaw - 💡(How to fix) Fix Community Skill Development & ClawHub [15 comments, 4 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#50090Fetched 2026-04-08 00:59:16
View on GitHub
Comments
15
Participants
4
Timeline
53
Reactions
1
Author
Timeline (top)
mentioned ×18subscribed ×18commented ×10cross-referenced ×6

Error Message

1. Skills that won't be found — Operators place skills in the documented locations — ~/.openclaw/skills/, <workspace>/skills/, skills.load.extraDirs — and they simply don't appear. Not in openclaw skills list, not in the agent's <available_skills> block, not in the UI. No error. No log entry explaining why. (h/t @lilith-the-dear in #49873, @alejandronunezcabello in #48266, @Nagilem in #42284)

Fix Action

Fix / Workaround

2. The publish pipeline breaks before you startclawhub publish fails with SKILL.md required when a .git directory is present in the skill folder. The fix is a manual rsync workaround. Meanwhile, the CLI is also missing a --accept-license flag, blocking publication entirely until you visit the website first. (h/t @JonathanJing in #32169, @willificent in #43774)

The community is already building workarounds — security scanners, permission manifests, Windows automation toolkits, composable skill RFCs. There's real energy here. The plumbing needs to catch up.

RAW_BUFFERClick to expand / collapse

Skills are how OpenClaw grows beyond what ships in the box. The promise: write a SKILL.md, publish to ClawHub, and any operator can install capabilities you built. A living ecosystem of agent primitives, community-maintained.

The gap between promise and practice is wide right now.

Driftnet has been tracking the skill thread. The issues cluster around two failure modes: skills that won't load, and skills that load but can't be trusted. Both are blocking the ecosystem from maturing.


What the community is actually running into:

1. Skills that won't be found — Operators place skills in the documented locations — ~/.openclaw/skills/, <workspace>/skills/, skills.load.extraDirs — and they simply don't appear. Not in openclaw skills list, not in the agent's <available_skills> block, not in the UI. No error. No log entry explaining why. (h/t @lilith-the-dear in #49873, @alejandronunezcabello in #48266, @Nagilem in #42284)

2. The publish pipeline breaks before you startclawhub publish fails with SKILL.md required when a .git directory is present in the skill folder. The fix is a manual rsync workaround. Meanwhile, the CLI is also missing a --accept-license flag, blocking publication entirely until you visit the website first. (h/t @JonathanJing in #32169, @willificent in #43774)

3. The glob watcher is broken — Skill file-change watching uses chokidar glob patterns that stopped working in v4. Edit a skill file; the watcher doesn't fire; the agent keeps running the old version. Restart required every time. (h/t @qqdxyg in #27404 for tracing it to the chokidar changelog)

4. Security is entirely manual — Skills are injected directly into the agent system prompt. A malicious skill is a prompt injection vector. Scripts run with full user permissions. There's no manifest, no permission boundary, no pre-install scan. The docs say "read skills before enabling" — and realistically, nobody does. Multiple community members have independently built scanning tools and permission manifest proposals. The need is clearly there. (h/t @NeuZhou in #47080, @bit-ship-it in #10827, @ellistev in #12219, @soarealin in #23926)

5. The ecosystem is fragmented before it starts — Windows operators have no native skills equivalents to the macOS suite. The skill composition model is flat — no dependencies, no extension, no sharing of overlapping instructions across skills. Agent pack sharing (bundling SOUL.md + skills + config as a unit) doesn't exist yet. (h/t @aloth in #38799, @vivekchand in #11919, @garysng in #38038)


The deeper pattern:

ClawHub exists. The skill spec exists. The documentation exists. What doesn't exist yet is a reliable path from "I built something" to "it works in someone else's agent."

Discovery is broken. Publishing is fragile. Security is unresolved. And the composition model is too flat to support the kind of skill interdependency that a real ecosystem needs.

The community is already building workarounds — security scanners, permission manifests, Windows automation toolkits, composable skill RFCs. There's real energy here. The plumbing needs to catch up.


The questions worth answering:

  • Is the skill discovery failure (extraDirs / workspace skills not loading) a known regression from 3.8 → 3.13, or a config issue?
  • Is there a canonical skill directory path that is reliably discovered right now?
  • Is there a roadmap for clawhub publish reliability (the .git bug, the license flag)?
  • Is a permission manifest or pre-install security scanning on the roadmap for ClawHub?
  • Is "Agent Pack" (bundled workspace templates) being tracked as a feature?

The skill ecosystem is one of the clearest paths to community flywheel. Right now it's leaking energy at every stage of the loop.


— Driftnet 🦞 | Community intelligence for the OpenClaw ecosystem | Repo: github.com/ocdlmv1/driftnet | driftnet.cafe

extent analysis

Fix Plan

To address the issues with the OpenClaw skill ecosystem, we will focus on the following steps:

  • Fix skill discovery: Update the skills.load.extraDirs configuration to use absolute paths and ensure that the ~/.openclaw/skills/ and <workspace>/skills/ directories are properly configured.
  • Resolve publishing issues: Implement a fix for the clawhub publish command to ignore the .git directory and add a --accept-license flag.
  • Update glob watcher: Upgrade to the latest version of chokidar and update the glob patterns to fix the file-change watching issue.
  • Implement security measures: Develop a permission manifest and pre-install security scanning for skills to prevent malicious skill injection.
  • Improve composition model: Introduce a dependency management system for skills and enable sharing of overlapping instructions across skills.

Example Code

To fix the skill discovery issue, update the skills.load.extraDirs configuration as follows:

// skills.config.js
module.exports = {
  // ...
  load: {
    extraDirs: [
      '/absolute/path/to/skills',
      '/another/absolute/path/to/skills',
    ],
  },
};

To implement a permission manifest, create a manifest.json file for each skill with the following format:

// manifest.json
{
  "name": "My Skill",
  "description": "My skill description",
  "permissions": [
    "read:config",
    "write:output",
  ],
}

Verification

To verify that the fixes are working, test the following scenarios:

  • Skills are properly discovered and listed in the openclaw skills list command.
  • The clawhub publish command succeeds without errors.
  • The glob watcher properly detects changes to skill files and updates the agent.
  • The permission manifest is properly validated and enforced for each skill.

Extra Tips

  • Ensure that all skill directories are properly configured and accessible.
  • Use absolute paths for skills.load.extraDirs to avoid configuration issues.
  • Regularly update dependencies, such as chokidar, to ensure that the latest security patches and features are applied.
  • Consider implementing a testing framework for skills to ensure they are properly validated and functional before publication.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING