Guide
Troubleshooting
When something feels broken, use this page to identify whether the issue is discovery, activation, input, output, or navigation.
MCP problems
1
Tool not selected
Make the tool name and description more specific and less vague.
2
Bad input
Check the schema and reject missing or malformed fields before execution.
3
Wrong output
Return structured data instead of prose when the model needs to continue the workflow.
Skill problems
1
Does not activate
Rewrite the description using the user verbs and task shape from the actual request.
2
Activates too often
Add a clear "do not use" boundary and narrow the scope.
3
Output is vague
Add templates, examples, or assertions for the required format.
Site problems
Language resetsMake sure the language choice survives route changes and refreshes.
Broken highlightCheck the exact active route instead of matching a broad section name.
Search emptyUse the site index and surface results from real content paths.
Nothing happensIf a control is visible, it should navigate, open a panel, or explain itself.