awesome-bookmarks/goose
3
0
Fork 0
mirror of https://github.com/block/goose.git synced 2026-07-17 12:56:20 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: add Summon extension tutorial and update Skills references (#7310)

Browse Source 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
Rizel Scarlett
2026-02-18 13:02:08 -05:00
committed by GitHub
parent e2d174ac1d
commit 85ab108645
7 changed files with 155 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/docs/getting-started/using-extensions.md
+1 -1
View File
@@ -39,7 +39,7 @@ Platform extensions are built-in extensions that provide global features like co
- [Chat Recall](/docs/mcp/chatrecall-mcp): Search conversation content across all your session history
- [Code Execution](/docs/mcp/code-execution-mcp): Execute JavaScript code for tool discovery and tool calling
- [Extension Manager](/docs/mcp/extension-manager-mcp): Discover, enable, and disable extensions dynamically during sessions (enabled by default)
- [Skills](/docs/mcp/skills-mcp): Load and use agent skills from various project and global skill directories (enabled by default)
- [Summon](/docs/mcp/summon-mcp): Load skills and recipes, and delegate tasks to subagents (enabled by default)
- [Todo](/docs/mcp/todo-mcp): Manage task lists and track progress across sessions (enabled by default)
### Toggling Built-in Extensions
documentation/docs/guides/context-engineering/using-skills.md
+2 -2
View File
@@ -7,7 +7,7 @@ sidebar_label: Using Skills
Skills are reusable sets of instructions and resources that teach goose how to perform specific tasks. A skill can range from a simple checklist to a detailed workflow with domain expertise, and can include supporting files like scripts or templates. Example use cases include deployment procedures, code review checklists, and API integration guides.
:::info
This functionality requires the built-in [Skills extension](/docs/mcp/skills-mcp) to be enabled (it's enabled by default).
This functionality requires the built-in [Summon extension](/docs/mcp/summon-mcp), available in v1.25.0+.
:::
When a session starts, goose adds any skills that it discovers to its instructions. During the session, goose automatically loads a skill when:
@@ -282,4 +282,4 @@ import skillsvsmcp from '@site/blog/2025-12-22-agent-skills-vs-mcp/skills-vs-mcp
duration: '4 min read'
}
]}
/>
/>
documentation/docs/mcp/skills-mcp.md
+4
View File
@@ -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* &mdash; 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).
documentation/docs/mcp/summon-mcp.md
+138
View File
@@ -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
![Retro 90s Homepage](/img/summon-retro-site.png)
documentation/docs/tutorials/playwright-skill.md
+5 -5
View File
@@ -52,13 +52,13 @@ npx skills add https://github.com/microsoft/playwright-cli --skill playwright-cl
6. You'll get a confirmation of the installation, choose `Yes` to proceed
### Enable Skills Extension
In goose, enable the [Skills extension](/docs/mcp/skills-mcp) to load Agent Skills within sessions.
### Enable Summon Extension
In goose, enable the [Summon extension](/docs/mcp/summon-mcp) to load Agent Skills within sessions.
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
<GooseBuiltinInstaller
extensionName="Skills"
extensionName="Summon"
/>
</TabItem>
<TabItem value="cli" label="goose CLI">
@@ -77,7 +77,7 @@ In goose, enable the [Skills extension](/docs/mcp/skills-mcp) to load Agent Skil
│
◆ Enable extensions: (use "space" to toggle and "enter" to submit)
// highlight-start
│ ● skills
│ ● summon
// highlight-end
|
└ Extension settings updated successfully
@@ -224,6 +224,6 @@ Getting started with the Playwright CLI agent skill is easy and opens up powerfu
## Resources
- [Skills Extension Documentation](/docs/mcp/skills-mcp)
- [Summon Extension Documentation](/docs/mcp/summon-mcp)
- [Using Skills Guide](/docs/guides/context-engineering/using-skills) - Learn how to create and use skills with goose
- [Playwright CLI GitHub](https://github.com/microsoft/playwright-cli)
documentation/docs/tutorials/remotion-video-creation.md
+5 -5
View File
@@ -20,12 +20,12 @@ Remotion is free for individuals and small teams, but requires a [commercial lic
## Configuration
Enable the [Skills extension](/docs/mcp/skills-mcp) to allow goose to load and use Agent Skills.
Enable the [Summon extension](/docs/mcp/summon-mcp) to allow goose to load and use Agent Skills.
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
<GooseBuiltinInstaller
extensionName="Skills"
extensionName="Summon"
/>
</TabItem>
<TabItem value="cli" label="goose CLI">
@@ -44,7 +44,7 @@ Enable the [Skills extension](/docs/mcp/skills-mcp) to allow goose to load and u
│
◆ Enable extensions: (use "space" to toggle and "enter" to submit)
// highlight-start
│ ● skills
│ ● summon
// highlight-end
|
└ Extension settings updated successfully
@@ -72,8 +72,8 @@ End with 'Deployed to production 🚀'
### goose Output
```
─── load_skill | skills ───────────────────────────────────────
name: remotion-best-practices
─── load | summon ───────────────────────────────────────
source: remotion-best-practices
reading ~/.agents/skills/remotion-best-practices/rules/animations.md
documentation/static/img/summon-retro-site.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 655 KiB