Merge pull request #1406 from RizgarOzan/docs/skill-custom-tool-fallback

docs(skill): say where to look when a tool is not in the tool list

Author: Scriptwonder

.claude/skills/unity-mcp-skill/SKILL.md

@@ -27,6 +27,11 @@ Before applying a template:
 5. Verify results         → read_console, manage_camera(action="screenshot"), resources
 ```
 
+**If a tool you need is not in your tool list, it is not necessarily missing.** Check these before troubleshooting the connection:
+
+- **Project custom tools** (C# `[McpForUnityTool]`): with project-scoped tools enabled on the server, they are *not* callable by name. List them via `mcpforunity://custom-tools` and run them with `execute_custom_tool(tool_name="...", parameters={...})`. With it disabled, they are registered as ordinary tools and appear in your list.
+- **Disabled tool groups**: over HTTP, a session starts with only the `core` group enabled. Over stdio, all groups start enabled and are then synced to the tool toggles in the Unity editor, so a tool can still be hidden. `manage_tools(action="list_groups")` shows the groups, `manage_tools(action="activate", group="...")` enables one.
+
 ## Critical Best Practices
 
 ### 1. After Writing/Editing Scripts: Wait for Compilation and Check Console

unity-mcp-skill/SKILL.md

@@ -27,6 +27,11 @@ Before applying a template:
 5. Verify results         → read_console, manage_camera(action="screenshot"), resources
 ```
 
+**If a tool you need is not in your tool list, it is not necessarily missing.** Check these before troubleshooting the connection:
+
+- **Project custom tools** (C# `[McpForUnityTool]`): with project-scoped tools enabled on the server, they are *not* callable by name. List them via `mcpforunity://custom-tools` and run them with `execute_custom_tool(tool_name="...", parameters={...})`. With it disabled, they are registered as ordinary tools and appear in your list.
+- **Disabled tool groups**: over HTTP, a session starts with only the `core` group enabled. Over stdio, all groups start enabled and are then synced to the tool toggles in the Unity editor, so a tool can still be hidden. `manage_tools(action="list_groups")` shows the groups, `manage_tools(action="activate", group="...")` enables one.
+
 ## Critical Best Practices
 
 ### 1. After Writing/Editing Scripts: Wait for Compilation and Check Console