Skip to main content

Skills Configuration

Skills-related config is located under skills in the config file.

Config Example​

skills:
  enabled: true
  roots:
    - /opt/company/skills

Config Fields​

FieldTypeDefaultDescription
enabledbooleantrueWhether to enable Skills
rootslist[]Additional skill directories beyond workspace.path/skills

Skills Loading Order​

  1. workspace.path/skills/ - workspace-local skills when include_defaults is enabled
  2. Custom skills.roots entries - additional configured directories

For the local starter created by mushroom-agent init, workspace.path defaults to ~/.mushroom_agent, so the default workspace skills directory is ~/.mushroom_agent/skills/.

Common Commands​

# List installed Skills
mushroom-agent skills list

# Show available Skills
mushroom-agent skills available

# Install a Skill
mushroom-agent skills install <name>

# Install from local directory
mushroom-agent skills install <name> --source ./skills-repo

# Install from Git repository
mushroom-agent skills install <name> --source owner/repo

# Install all skills from local directory
mushroom-agent skills install --source ./skills-repo --all

# Install all skills from Git repository
mushroom-agent skills install --source owner/repo --all