Skip to main content

Creating Skills

This guide helps you create your first Skill.

Steps​

  1. Create Skill Directory

    Create a new folder in the skills directory:

    mkdir -p ~/.mushroom_agent/skills/hello-world

  2. Write SKILL.md

    Create SKILL.md with YAML frontmatter and instructions:

    ---
    name: hello_world
    description: A simple greeting skill. Use when user asks for a greeting.
    ---

    # Hello World Skill

    Use the `echo` tool to print "Hello from MushroomAgent skill!"

  3. Load Skill

    Restart MushroomAgent or start a new session to load the Skill:

    mushroom-agent skills list

  4. Test

    Send a message that should trigger the Skill to test it.

Directory Best Practices​

skill-name/
├── SKILL.md (required)
├── scripts/          # executable scripts (Python/Bash etc.)
├── references/       # reference documentation
└── assets/           # asset files

Best Practices​

  • Keep it concise - tell the agent what to do, not how to act as AI
  • Security first - if using exec, ensure the prompt doesn't allow arbitrary command injection from untrusted input
  • Organize with directories - put detailed reference docs in references/, don't stuff everything into SKILL.md