goose/documentation/docs/mcp/summon-mcp.md
Rizel Scarlett 85ab108645
docs: add Summon extension tutorial and update Skills references (#7310)
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-18 18:02:08 +00:00

138 lines
4 KiB
Markdown

---
title: Summon Extension
description: Load skills and delegate tasks to subagents
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import { PlatformExtensionNote } from '@site/src/components/PlatformExtensionNote';
import GooseBuiltinInstaller from '@site/src/components/GooseBuiltinInstaller';
The Summon extension lets you load knowledge into goose's context and delegate tasks to [subagents](/docs/guides/subagents).
You can load different types of sources:
- [**Skills**](/docs/guides/context-engineering/using-skills) - Reusable instruction sets that teach goose specific workflows
- [**Recipes**](/docs/guides/recipes) - Automated task definitions with prompts and parameters
This is useful for teaching goose how to perform tasks and running work in parallel through subagents.
:::info
This extension is available in v1.25.0+.
:::
## Configuration
<PlatformExtensionNote/>
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
<GooseBuiltinInstaller
extensionName="Summon"
description="Load knowledge and delegate tasks to subagents"
/>
</TabItem>
<TabItem value="cli" label="goose CLI">
1. Run the `configure` command:
```sh
goose configure
```
2. Choose to `Toggle Extensions`
```sh
┌ goose-configure
◇ What would you like to configure?
│ Toggle Extensions
◆ Enable extensions: (use "space" to toggle and "enter" to submit)
// highlight-start
│ ● summon
// highlight-end
└ Extension settings updated successfully
```
</TabItem>
</Tabs>
## Example Usage
In this example, we'll create a custom skill that teaches goose a 90s web aesthetic, then use Summon to load that skill and delegate a subagent to build a retro homepage.
### Create a Skill
```markdown title=".agents/skills/retro/SKILL.md"
---
name: retro
description: Creates content with 90s web aesthetic
---
# Retro Web Guidelines
Channel the 90s internet:
1. Bright colors, especially neon
2. Comic Sans or pixel fonts
3. Animated GIF energy (use emojis as a substitute)
4. "Under construction" vibes
5. Visitor counters, guestbook mentions
6. Marquee-style excitement
```
### goose Prompt
```
Load the retro skill with summon. Then delegate a subagent to create an HTML page called my-site.html for a personal homepage.
```
### goose Output
```
─── load | summon ───────────────────────────────────────────
source: retro
# Loaded: retro (skill)
## retro (skill)
Creates content with 90s web aesthetic
### Content
# Retro Web Guidelines
Channel the 90s internet:
1. Bright colors, especially neon
2. Comic Sans or pixel fonts
3. Animated GIF energy (use emojis as substitute)
4. "Under construction" vibes
5. Visitor counters, guestbook mentions
6. Marquee-style excitement
---
This knowledge is now available in your context.
─── delegate | summon ───────────────────────────────────────
instructions: Create an HTML file called my-site.html for a personal homepage
using the 90s web aesthetic...
I've created your 90s-style personal homepage at `my-site.html`! 🌟
The page includes all the classic retro web elements:
- **Marquee tags** - Scrolling welcome message and bouncing text
- **Neon colors** - Hot pink, lime green, cyan, yellow on a navy blue background
- **Comic Sans font** - The quintessential 90s typeface
- **Visitor counter** - You're visitor #001337 with a blinking effect
- **"Under Construction" section** - With 🚧 emojis
- **About Me box** - With neon border styling
- **Favorite Links table** - Classic link collection
- **Guestbook section** - Sign and view options
- **Retro badges** - "Best viewed in Netscape Navigator 4.0"
- **Lots of emojis** - 🌟✨💫🔥⭐🌈🎉 throughout
Open it in your browser to experience the full nostalgic glory! 🎉
```
### Results
![Retro 90s Homepage](/img/summon-retro-site.png)