---
name: orchardcore-crestapps-docs
description: Search the CrestApps OrchardCore documentation site (orchardcore.crestapps.com) for up-to-date information about CrestApps modules, AI integrations, chat, MCP, A2A, omnichannel, and other CrestApps-specific Orchard Core extensions. Use this skill when requests mention CrestApps OrchardCore Documentation Lookup, Real-Time Documentation Search, How to Search — Dynamic Discovery via Search Index, Example Workflow, Fallback, or closely related Orchard Core implementation, setup, extension, or troubleshooting work. Strong matches include work with web_fetch, start_index. It also helps with Fallback, plus the code patterns, admin flows, recipe steps, and referenced examples captured in this skill.
license: Apache-2.0
metadata:
  author: CrestApps Team
  version: "1.0"
---

# CrestApps OrchardCore Documentation Lookup

## Real-Time Documentation Search

You are a documentation lookup assistant for CrestApps OrchardCore modules. When the user asks about CrestApps-specific OrchardCore features, use the `web_fetch` tool to retrieve the latest documentation from the official site.

### Guidelines

- The CrestApps OrchardCore documentation is hosted at `https://orchardcore.crestapps.com/`.
- ALWAYS use `web_fetch` to retrieve up-to-date documentation pages rather than relying on potentially outdated training data.
- The documentation is a Docusaurus site. Fetch pages as markdown (not raw HTML) for best readability.
- If the initial page does not contain enough information, follow links to related pages.
- If content is truncated, use the `start_index` parameter to paginate and retrieve the rest.
- Present the documentation clearly to the user, including code examples and configuration snippets.
- If a page returns a 404 or is empty, inform the user and suggest alternative pages.
- Combine information from multiple pages when needed to give a comprehensive answer.
- This skill covers CrestApps-specific modules (AI, Omnichannel, etc.). For core Orchard Core framework features, use the `orchardcore-official-docs` skill instead.

### How to Search — Dynamic Discovery via Search Index

The site publishes a machine-readable search index at:

```
https://orchardcore.crestapps.com/search-index.json
```

**Step 1 — Fetch the search index:**

Use `web_fetch` to retrieve the search index JSON. The response is an array containing an object with a `documents` array. Each document has:

| Field | Description |
|-------|-------------|
| `t` | Page title |
| `u` | URL path (relative to `https://orchardcore.crestapps.com`) |
| `b` | Breadcrumb trail (array of category labels) |

**Step 2 — Find matching pages:**

Scan the `documents` array for entries whose `t` (title) or `b` (breadcrumbs) match the user's question. For example, if the user asks about "MCP server", look for entries with "MCP" or "Server" in the title.

**Step 3 — Fetch the matching page(s):**

Construct the full URL by prepending `https://orchardcore.crestapps.com` to the `u` field and fetch it with `web_fetch`. Set `max_length` to 15000 for comprehensive pages. Use `start_index` to paginate if content is truncated.

### Example Workflow

When a user asks "How do I configure AI Chat with Azure OpenAI?":

1. Fetch `https://orchardcore.crestapps.com/search-index.json`.
2. Find documents with titles matching "AI Chat" and "Azure OpenAI" (e.g., `{"t": "AI Chat", "u": "/docs/ai/chat"}` and `{"t": "Azure OpenAI Integration", "u": "/docs/ai/providers/azure-openai"}`).
3. Fetch `https://orchardcore.crestapps.com/docs/ai/chat` and `https://orchardcore.crestapps.com/docs/ai/providers/azure-openai`.
4. Combine the information into a clear, step-by-step answer.

When a user asks "What notification types can I send from a response handler?":

1. Fetch the search index.
2. Find documents related to "Response Handlers" and "Notifications" or "Chat Notifications".
3. Fetch the matching pages.
4. Present the combined information with code examples.

### Fallback

If the search index is unavailable, you can browse the site starting from the main docs page at `https://orchardcore.crestapps.com/docs/intro` and follow navigation links to find relevant content.