Mandatory prerequisite: Before starting this skill, read and apply Common Skill Rules.

Search Adobe Developer Docs

Retrieve grounded answers from official Adobe developer documentation. This skill is a retriever — passages are fetched and returned for you to synthesize into a final answer. Do not answer from training knowledge alone.

When to invoke

• Any question about Adobe developer products, APIs, SDKs, or platform concepts
• Before starting a provisioning flow (credential creation, API subscription, I/O Events setup) — gather context first
• When the user explicitly asks to search Adobe documentation

Flow

Step 1 — Check if scoped to a specific product

Does the user mention a specific product (e.g. "search only App Builder docs", "look this up in Express Add-ons docs")?

• Yes → Call list_doc_collections to get available collection IDs. Match the user's product to a collectionId. Proceed to Step 2 with that collectionId.
• No → Proceed to Step 2 with no collectionId (searches all collections).

Step 2 — Retrieve passages

Call search_adobe_docs with:

• query: the user's question or topic as-is
• collectionId: from Step 1 (omit to search all)
• numberOfResults: 5 (default) — increase to 10 if the question is broad

Step 3 — Handle results

Results found:

Synthesize the answer from the returned passages. For each passage used, cite the source:

{Your synthesized answer}

Sources:
- {title} — {sourceUrl}
- {title} — {sourceUrl}

Zero results:

Tell the user no documentation was found and suggest rephrasing or broadening the query. If offering collection scopes, first reuse or call list_doc_collections and use only returned collection names; omit that suggestion if none are available:

No results found for "{query}". Try:
- Rephrasing with different keywords
- Using a broader search term
- Scoping to a specific collection (e.g. App Builder, Express Add-ons)

Then offer to retry with a rephrased query.

Rules

• Never answer Adobe documentation questions from training knowledge alone — always call search_adobe_docs first
• Always cite source URLs from the returned passages
• Synthesis happens here in the LLM — the tool only retrieves; do not ask the tool to generate answers
• If the user asks about a product not covered by any collection, tell them the available collections (from list_doc_collections) and suggest the closest match