fix(wix-headless): correct broken SDK docs-search kbName#299
Open
gonengar wants to merge 1 commit into
Open
Conversation
`DOCS_SEARCH.md` documented `SDK_KB_ID` as a valid kbName for the
docs-search endpoint, but it returns HTTP 400
`{"error":"KB name is not provided"}`. The working values are
`SDK_METHODS_KB_ID` (method reference) and `SDK_DOCS_KB_ID` (guide
articles). Since SDK lookups are the bulk of Path B wiring work, the
broken value errored out exactly where the endpoint matters most and
trained agents to fall back to web search.
Verified live: REST_METHODS_KB_ID, SDK_METHODS_KB_ID, HEADLESS_KB_ID,
SDK_DOCS_KB_ID all return HTTP 200.
Applied to both the skill root and the plugins/wix/ mirror.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This was referenced May 29, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
references/shared/DOCS_SEARCH.mddocumentedSDK_KB_IDas a validkbNamefor the docs-search endpoint. It isn't — the endpoint returns:SDK lookups are the bulk of Path B (existing-project SDK wiring) work, so the broken value errored out exactly where the docs-search endpoint matters most — and the recipe's "if it errors, fall back" framing then trained agents to bail to web search instead of using the docs API.
Fix
Replace
SDK_KB_IDwith the working values:SDK_METHODS_KB_ID— SDK method referenceSDK_DOCS_KB_ID— SDK guide articlesApplied to both the skill root and the
plugins/wix/mirror.Verification
All documented KB names tested live against
https://www.wixapis.com/mcp-docs-search/v1/search:REST_METHODS_KB_IDSDK_METHODS_KB_IDHEADLESS_KB_IDSDK_DOCS_KB_IDgrep -rn SDK_KB_ID skills/ plugins/→ no matches remaining.Follow-up (not in this PR)
This is the correctness half of a larger diagnosis on why agents skip the docs endpoints. A follow-up will raise the endpoint's prominence (precedence steer in
DOCS_SEARCH.md+SKILL.md, and decision-time pointers in the per-verticalINSTRUCTIONS.mdfiles) so docs-search is tried before web search.🤖 Generated with Claude Code