diff --git a/documentation/docs/guides/context-engineering/using-skills.md b/documentation/docs/guides/context-engineering/using-skills.md
index feee50fd882d..0d6a11149e02 100644
--- a/documentation/docs/guides/context-engineering/using-skills.md
+++ b/documentation/docs/guides/context-engineering/using-skills.md
@@ -19,9 +19,8 @@ When a session starts, goose adds any skills that it discovers to its instructio
 
 You can also ask goose what skills are available.
 
-:::tip Other goose features that support reuse
-- [.goosehints](/docs/guides/context-engineering/using-goosehints): Best for general preferences, project context, and repeated instructions like "Always use TypeScript"
-- [recipes](/docs/guides/recipes/session-recipes): Shareable configurations that package instructions, prompts, and settings together
+:::info Claude Compatibility
+goose skills are compatible with Claude Desktop and other [agents that support Agent Skills](https://agentskills.io/home#adoption).
 :::
 
 ## Skill Locations
@@ -255,6 +254,11 @@ Always verify webhook signatures. See `src/webhooks/square.js` for our handler p
 
 </details>
 
+:::tip Other goose features that support reuse
+- [.goosehints](/docs/guides/context-engineering/using-goosehints): Best for general preferences, project context, and repeated instructions like "Always use TypeScript"
+- [recipes](/docs/guides/recipes/session-recipes): Shareable configurations that package instructions, prompts, and settings together
+:::
+
 ## Best Practices
 
 - **Keep skills focused** — One skill per workflow or domain. If a skill is getting long, consider splitting it.