Tools

MushroomAgent extends agent capabilities through tools and Skills. Tools are typed functions that agents can call, while Skills provide domain knowledge and operational guidance.

Tools, Skills

1. Tools are what agents call

   Tools are typed functions that agents can invoke, such as exec, read, web_fetch, web_search, media tools, memory tools, and delegation. MushroomAgent loads builtin tools from tools.* config and can also discover MCP tools.

2. Skills provide domain knowledge

   A Skill is a directory containing SKILL.md that provides operational procedures, best practices, and scripts for specific domains. The agent automatically matches and loads relevant Skills based on request context.

Built-in Tools

Tool	Purpose
read	Read workspace text and image files
exec	Execute shell commands with timeout and output limits
process	Manage longer-running background processes
web_fetch	Fetch web page or HTTP response content
web_search	Search the web through the configured backend
image_generation	Generate images through the configured provider
video_generation	Generate videos through VolcEngine Ark or Google provider settings
video_analyze / audio_analyze	Analyze media through configured provider settings
attach_artifact	Attach generated artifacts to the response context
memory_search / memory_add_file	Search memory and add local files to memory
skill_manage / skill_view	Create, edit, and inspect skills from allowed skill roots
delegate_task	Spawn child agents when delegation is explicitly enabled
manage_schedule	Scheduled tasks and reminders
skip_voice_reply / emit_ui_command	Voice/UI runtime helpers
update_identity_profile	Update identity profile data when enabled

Use the CLI to inspect the tools currently available for your local config:

mushroom-agent tools list

The current default builtin registry does not register separate write or api_request tools. Use exec / process for local automation, web_fetch / web_search for web access, and MushroomAgent's HTTP/WebSocket/Func service APIs for external integrations.

Skills

Skills are stored in the local skills root by default. For the starter created by mushroom-agent init, that resolves to ~/.mushroom_agent/skills/. Bundled skills can also be included when skills.include_bundled=true.

Learn more:

• Skills Overview
• Creating Skills
• Skills Config
• Skills Hub

Common commands:

mushroom-agent skills list           # list installed skills
mushroom-agent skills available      # show available skills
mushroom-agent skills install <name> # install a skill