#8873: fix: document skill loading locations in system prompt
agents
stale
Cluster:
Skill Enhancements and Fixes
to avoid user-defined-skills not loading
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
This PR updates the Skills section of the agent system prompt (`src/agents/system-prompt.ts`) to explicitly document where OpenClaw loads skills from (bundled installation skills, managed `~/.openclaw/skills/`, workspace `{workspace}/skills/`, plugin-provided skills, and `config.skills.load.extraDirs`).
This fits the codebase by aligning the system prompt guidance with the actual skill discovery paths implemented in the skills loader, which should reduce confusion when user-defined skills are not being picked up.
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge with minimal risk.
- Change is additive, limited to prompt text, and matches the actual skill-loading sources used by the implementation (bundled/managed/workspace/plugin/extraDirs). No runtime logic is modified.
- No files require special attention
<!-- greptile_other_comments_section -->
<sub>(2/5) Greptile learns from your feedback when you react with thumbs up/down!</sub>
**Context used:**
- Context from `dashboard` - CLAUDE.md ([source](https://app.greptile.com/review/custom-context?memory=fd949e91-5c3a-4ab5-90a1-cbe184fd6ce8))
- Context from `dashboard` - AGENTS.md ([source](https://app.greptile.com/review/custom-context?memory=0d0c8278-ef8e-4d6c-ab21-f5527e322f13))
<!-- /greptile_comment -->
Most Similar PRs
#3933: fix(skills): Make skill scripts executable
by jaysonsantos · 2026-01-29
84.9%
#9595: fix(skills): ignore .venv, __pycache__, and .openclaw to prevent FD...
by amoghacloud · 2026-02-05
82.5%
#9925: docs: warn about Python venv placement in skill directories
by kj9kj9qv4m-bit · 2026-02-05
82.0%
#5273: fix: skill frontmatter fixes + description improvements (35 skills)
by Terwox · 2026-01-31
81.3%
#14701: Agent: enforce execute-first replies and clarify whisper modes
by Swader · 2026-02-12
80.7%
#22306: Warn on malformed skill parsing failures in load path
by AIflow-Labs · 2026-02-21
80.2%
#22525: [Bug]: Session snapshot not reloading skills after gateway restart ...
by zwffff · 2026-02-21
80.2%
#15115: fix: pre-load skill docs in cron sessions to prevent hallucinated syn…
by joaolcorreia · 2026-02-13
79.9%
#19664: fix(skills): log skill YAML parsing diagnostics with skill name
by orchidsun · 2026-02-18
79.2%
#14023: fix: filter skills watcher to relevant file types to prevent FD exh...
by funmerlin · 2026-02-11
78.8%