diff --git a/src/mcp_example/SKILL.md b/src/mcp_example/SKILL.md
index be43ee9..eb3760c 100644
--- a/src/mcp_example/SKILL.md
+++ b/src/mcp_example/SKILL.md
@@ -1,18 +1,18 @@
-# Example MCP Server — Skill Guide
+---
+name: mcp-example-service
+description: Provides knowledge of how to use MCP example most effectively. It's loaded into the agent's context when running the MCP.
+---
 
 ## Tools
 
+<!-- TODO: Add a row for each @mcp.tool() in server.py -->
 | Tool | Use when... |
 |------|-------------|
-| `list_items` | You need to browse or search items |
-| `get_item` | You have an item ID and need full details |
 
 ## Context Reuse
 
-- Use the `id` from `list_items` results when calling `get_item`
+<!-- TODO: Describe which tool outputs feed into subsequent tool calls -->
 
 ## Workflows
 
-### 1. Browse and Inspect
-1. `list_items` with a limit to get an overview
-2. For interesting items: `get_item` to get full details
+<!-- TODO: Add 2-3 multi-step workflows showing how to chain tools -->
diff --git a/tests/test_server.py b/tests/test_server.py
index 3c0dd32..b26f80c 100644
--- a/tests/test_server.py
+++ b/tests/test_server.py
@@ -35,8 +35,8 @@ async def test_skill_resource_readable(self, mcp_server):
         async with Client(mcp_server) as client:
             contents = await client.read_resource("skill://example/usage")
             text = contents[0].text if hasattr(contents[0], "text") else str(contents[0])
-            assert "list_items" in text
-            assert "get_item" in text
+            assert len(text.strip()) > 0
+            assert "## Tools" in text
 
     @pytest.mark.asyncio
     async def test_skill_content_matches_constant(self, mcp_server):