docs: skills #6062

dianed-square · 2025-12-11T02:35:39Z

Summary

This PR documents the SKILLS.md support feature (Claude compatibility) in a new "Context Engineering" section with the using-goosehints topic.

Documentation updates:

documentation/docs/guides/context-engineering/_category_.json and documentation/docs/guides/context-engineering/index.mdx:
- New section
documentation/docs/getting-started/using-extensions.md:
- List Skills platform extension
documentation/docs/mcp/skills-mcp.md:
- New topic for the Skills platform extension
documentation/docs/guides/using-skills.md:
- New topic about creating and using skills
documentation/docs/guides/context-engineering/using-goosehints.md:
- Moved from documentation/docs/guides/using-goosehints.md

Updated links to using-goosehints topic:

documentation/docs/quickstart.md
documentation/docs/getting-started/providers.md
documentation/docs/troubleshooting/known-issues.md
documentation/docs/guides/environment-variables.md
documentation/docs/guides/tips.md
documentation/blog/2025-03-06-goose-tips/index.md
documentation/blog/2025-04-08-vibe-code-responsibly/index.md
documentation/blog/2025-05-20-goose-gets-a-drivers-license/index.md
documentation/blog/2025-06-02-goose-panther-mcp/index.md
documentation/blog/2025-06-05-whats-in-my-goosehints-file/index.md
documentation/blog/2025-07-28-streamlining-detection-development-with-goose-recipes/index.md
documentation/blog/2025-08-11-llm-tag-team-lead-worker-model/index.md
documentation/blog/2025-08-18-understanding-context-windows/index.md
documentation/blog/2025-11-17-migrate-app-with-ai-agent/index.md
documentation/blog/2025-12-10-stop-ai-agent-unwanted-changes/index.md
documentation/docusaurus.config.ts: Add redirect

Updated sidebar position:

documentation/docs/guides/goose-permissions.md
documentation/docs/guides/updating-goose.md

Type of Change

AI Assistance

This PR was created or reviewed with AI assistance

Testing

Manual testing

To see the specific tasks where the Asana app for GitHub is being used, see below:
- https://app.asana.com/0/0/1212347161105805

Copilot

Pull request overview

This PR adds comprehensive documentation for the Skills platform extension, which enables goose to use reusable instruction sets compatible with Claude Desktop's skill format. The documentation follows established patterns for MCP extension docs and accurately reflects the implementation.

Key changes:

New documentation for the Skills MCP extension with configuration and usage examples
Comprehensive guide on creating and using skills with multiple practical examples
Integration of Skills into the platform extensions list

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
documentation/docs/mcp/skills-mcp.md	New reference documentation for the Skills extension with configuration steps and deployment example
documentation/docs/guides/using-skills.md	New comprehensive guide covering skill creation, file structure, supporting files, and best practices
documentation/docs/getting-started/using-extensions.md	Added Skills to the platform extensions list alongside Chat Recall, Extension Manager, and Todo

github-actions · 2025-12-11T02:38:49Z

PR Preview Action v1.6.0
Preview removed because the pull request was closed.
2025-12-17 19:04 UTC

blackgirlbytes · 2025-12-11T20:43:57Z

documentation/docs/guides/using-skills.md

+- **Write for clarity** — Skills are instructions for goose. Use clear, direct language and numbered steps.
+- **Include verification steps** — Help goose confirm the workflow completed successfully.
+
+## Claude Compatibility


i feel like this section needs to be higher up because Claude skills are so popular. I'm thinking devs should immediately associate it with that.

blackgirlbytes

approving with a comment that claude compatibility should be one of the first things mentioned.

angiejones · 2025-12-11T21:21:04Z

documentation/docs/guides/using-skills.md

@@ -0,0 +1,266 @@
+---
+title: Using Skills
+sidebar_position: 41


should move higher up. maybe even consider a section that includes this with hints and any other guides that help with context engineering

Copilot

Pull request overview

Copilot reviewed 24 out of 24 changed files in this pull request and generated no new comments.

angiejones · 2025-12-17T17:01:47Z

documentation/docs/guides/context-engineering/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Context Engineering",
+  "position": 22,


move this way up. right after Managing Sessions

* origin/main: (57 commits) docs: create/edit recipe button (#6145) fix(google): Fix 400 Bad Request error with Gemini 3 thought signatures (#6035) fix: we don't need to warn about tool count when in code mode (#6149) deps: upgrade agent-client-protocol to 0.9.0 (#6109) fix(providers): fix for gemini-cli on windows to work around cmd's multiline prompt limitations #5911 (#5966) More slash commands (#5858) fix: MCP UI not rendering due to CallToolResult structure change (#6143) fix: display shell output as static text instead of spinner (#6041) fix : Custom providers with empty API keys show as configured in desktop (#6105) Add .agents/skills and ~/.config/agent/skills to skills discovery paths (#6139) fix: use instructions for system prompt and prompt for user message in subagents (#6121) Fix compaction loop for small models or large input (#5803) feat: Centralize theme management with ThemeContext (#6137) OpenRouter & Xai streaming (#5873) fix: resolve mcp-hermit cleanup path expansion issue (#5953) feat: add goose PR reviewer workflow (#6124) perf: Avoid repeated MCP queries during streaming responses (#6138) Fix YAML serialization for recipes with special characters (#5796) Add more posthog analytics (privacy aware) (#6122) docs: add Sugar MCP server to extensions registry (#6077) ...

Copilot

Pull request overview

Copilot reviewed 24 out of 24 changed files in this pull request and generated no new comments.

…icing * 'main' of github.com:block/goose: (35 commits) docs: skills (#6062) fix: add conditional configuration for GOOSE_BIN_DIR in PATH (#5940) Update dependencies to help in Fedora packaging (#5835) fix: make goose reviewer less bad (#6154) docs: create/edit recipe button (#6145) fix(google): Fix 400 Bad Request error with Gemini 3 thought signatures (#6035) fix: we don't need to warn about tool count when in code mode (#6149) deps: upgrade agent-client-protocol to 0.9.0 (#6109) fix(providers): fix for gemini-cli on windows to work around cmd's multiline prompt limitations #5911 (#5966) More slash commands (#5858) fix: MCP UI not rendering due to CallToolResult structure change (#6143) fix: display shell output as static text instead of spinner (#6041) fix : Custom providers with empty API keys show as configured in desktop (#6105) Add .agents/skills and ~/.config/agent/skills to skills discovery paths (#6139) fix: use instructions for system prompt and prompt for user message in subagents (#6121) Fix compaction loop for small models or large input (#5803) feat: Centralize theme management with ThemeContext (#6137) OpenRouter & Xai streaming (#5873) fix: resolve mcp-hermit cleanup path expansion issue (#5953) feat: add goose PR reviewer workflow (#6124) ...

* 'main' of github.com:block/goose: (28 commits) Clean PR preview sites from gh-pages branch history (#6161) fix: make goose reviewer less sycophantic (#6171) revert /reply to previous behavior (replacing session history) when full conversation provided (#6058) chore: manually update version (#6166) Integrate pricing with canonical model (#6130) Regenerate canonical models when release branch is created. (#6127) fix: use correct parameter name in read_module handler (#6148) docs: blog for code mode MCP (#6126) test: add ACP integration test (#6150) docs: auto download updates (#6163) fix: respect default_enabled value of platform extensions (#6159) docs: skills (#6062) fix: add conditional configuration for GOOSE_BIN_DIR in PATH (#5940) Update dependencies to help in Fedora packaging (#5835) fix: make goose reviewer less bad (#6154) docs: create/edit recipe button (#6145) fix(google): Fix 400 Bad Request error with Gemini 3 thought signatures (#6035) fix: we don't need to warn about tool count when in code mode (#6149) deps: upgrade agent-client-protocol to 0.9.0 (#6109) fix(providers): fix for gemini-cli on windows to work around cmd's multiline prompt limitations #5911 (#5966) ... # Conflicts: # ui/desktop/src/api/sdk.gen.ts # ui/desktop/src/hooks/useAgent.ts

doc skills

babe855

dianed-square requested a review from a team as a code owner December 11, 2025 02:35

Copilot AI review requested due to automatic review settings December 11, 2025 02:35

Copilot started reviewing on behalf of dianed-square December 11, 2025 02:36 View session

Copilot AI reviewed Dec 11, 2025

View reviewed changes

condense and clarify

43dcc03

blackgirlbytes reviewed Dec 11, 2025

View reviewed changes

blackgirlbytes approved these changes Dec 11, 2025

View reviewed changes

angiejones reviewed Dec 11, 2025

View reviewed changes

new context-engineering section

6e185dd

Copilot AI review requested due to automatic review settings December 15, 2025 22:17

Copilot AI reviewed Dec 15, 2025

View reviewed changes

dianed-square requested a review from blackgirlbytes December 16, 2025 00:51

angiejones reviewed Dec 17, 2025

View reviewed changes

dianed-square added 2 commits December 17, 2025 09:05

move way up

97abf97

Copilot AI review requested due to automatic review settings December 17, 2025 17:15

Copilot started reviewing on behalf of dianed-square December 17, 2025 17:16 View session

Copilot AI reviewed Dec 17, 2025

View reviewed changes

angiejones approved these changes Dec 17, 2025

View reviewed changes

dianed-square merged commit 0051b33 into main Dec 17, 2025
25 checks passed

dianed-square deleted the docs/skills branch December 17, 2025 19:04

github-actions bot mentioned this pull request Dec 19, 2025

chore(release): release version 1.18.0 (minor) #6194

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: skills #6062

docs: skills #6062

Uh oh!

dianed-square commented Dec 11, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

github-actions bot commented Dec 11, 2025 •

edited

Loading

Uh oh!

blackgirlbytes Dec 11, 2025

Uh oh!

blackgirlbytes left a comment

Uh oh!

angiejones Dec 11, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

angiejones Dec 17, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

docs: skills #6062

docs: skills #6062

Uh oh!

Conversation

dianed-square commented Dec 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Type of Change

AI Assistance

Testing

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

github-actions bot commented Dec 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

blackgirlbytes Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

blackgirlbytes left a comment

Choose a reason for hiding this comment

Uh oh!

angiejones Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

angiejones Dec 17, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

dianed-square commented Dec 11, 2025 •

edited

Loading

github-actions bot commented Dec 11, 2025 •

edited

Loading