Skip to content

Skills not loading in agent context from ~/.openclaw/workspace/skills/ #43735

Description

@che1404

Bug Report

Description

The OpenClaw agent context is not loading all available skills from ~/.openclaw/workspace/skills/ directory. Only a subset of skills appear in the initial context under <available_skills>, causing agents to be unaware of existing skills.

Steps to Reproduce

  1. Create multiple skills in ~/.openclaw/workspace/skills/
  2. Start an agent session
  3. Check the <available_skills> section in agent context
  4. Compare with actual directory contents: ls ~/.openclaw/workspace/skills/

Expected Behavior

All skills with valid SKILL.md files in the workspace skills directory should be loaded and listed in the agent's initial context.

Actual Behavior

Only a partial subset of skills are loaded. In my case:

Loaded in context (partial list):

  • design-md
  • react-components
  • shadcn-ui
  • asc
  • astro-mcp
  • etc.

Missing from context but present in filesystem:

  • colegio-vizcaya
  • alexia
  • athletic-club
  • bob-bizkaia
  • cafeterapp
  • irakai-facturas
  • irakai-sync
  • myfooderplan-build
  • whatsapp
  • etc.

Impact

Agents are unaware of available skills, leading to:

  • Manual directory scanning required (ls ~/.openclaw/workspace/skills/)
  • Poor user experience when asking about available tools
  • Inconsistent skill discovery

Environment

  • OpenClaw 2026.3.8 (3caab92)
  • macOS (Darwin 25.3.0 arm64)
  • Runtime: agent=main
  • All missing skills have valid SKILL.md files

Workaround

Manually scan the skills directory when needed:

ls ~/.openclaw/workspace/skills/

Suggestion

The skill loading mechanism should:

  1. Scan all subdirectories in ~/.openclaw/workspace/skills/
  2. Validate each has a SKILL.md file
  3. Load descriptions into agent context
  4. Or provide a dynamic skill discovery command

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions