docs: add Summon extension tutorial and update Skills references (#7310)
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
Rizel Scarlett
@@ -8,6 +8,10 @@ import TabItem from '@theme/TabItem';
|
||||
import { PlatformExtensionNote } from '@site/src/components/PlatformExtensionNote';
|
||||
import GooseBuiltinInstaller from '@site/src/components/GooseBuiltinInstaller';
|
||||
|
||||
:::caution Deprecated
|
||||
This extension has been deprecated and is only available in v1.16.0 - v1.24.0. For v1.25.0+, see the [Summon extension](/docs/mcp/summon-mcp).
|
||||
:::
|
||||
|
||||
The Skills extension loads *skills* — reusable sets of instructions that teach goose how to perform specific tasks or follow particular workflows.
|
||||
|
||||
goose automatically discovers skills at startup and uses them when relevant to your request. goose loads skills from `.agents/skills/` in your project directory and `~/.config/agents/skills/` globally, making skills portable across different AI coding agents. To learn about creating skills and how goose uses them, see [Using Skills](/docs/guides/context-engineering/using-skills).
|
||||
|
||||
@@ -0,0 +1,138 @@
|
||||
---
|
||||
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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user