From 72f443d5cc34ba8fc586c64a29f29b7405dd2cee Mon Sep 17 00:00:00 2001 From: Paul Lange Date: Fri, 2 Oct 2026 11:28:47 +0200 Subject: [PATCH 1/3] docs(ai): say what the docs assistant can't do and where to run the Celopedia install --- build/agents/celopedia.mdx | 4 ++-- build/agents/use-docs-with-ai.mdx | 4 +++- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/build/agents/celopedia.mdx b/build/agents/celopedia.mdx index edf4ed319c..bfe722e008 100644 --- a/build/agents/celopedia.mdx +++ b/build/agents/celopedia.mdx @@ -25,14 +25,14 @@ Go from "what should I build?" to a live app without tab-hopping through docs. ## Install Celopedia -Add it to your coding assistant with one command: +Add it to your coding assistant by running this command in your terminal: ```bash npx skills add celo-org/celopedia-skills ``` - Restart your coding assistant afterward if it doesn't discover new skills mid-session. Celopedia works with file-based skill environments including Codex, Claude Code, and OpenClaw — see the [GitHub repository](https://github.com/celo-org/celopedia-skills) for tool-specific install notes. + The command has to run in a terminal. Pasting it into a chat, including the **Ask AI** assistant on these docs, won't install it. Restart your coding assistant afterward if it doesn't discover new skills mid-session. Celopedia works with file-based skill environments including Codex, Claude Code, and OpenClaw — see the [GitHub repository](https://github.com/celo-org/celopedia-skills) for tool-specific install notes. ## Try it diff --git a/build/agents/use-docs-with-ai.mdx b/build/agents/use-docs-with-ai.mdx index 9f62f163d5..73bb719f41 100644 --- a/build/agents/use-docs-with-ai.mdx +++ b/build/agents/use-docs-with-ai.mdx @@ -199,7 +199,9 @@ Both files are generated from the live site, so they never go stale. ## Ask a question in the docs -Every page has an **Ask AI** button in the bottom-right corner. It answers from the documentation and links the pages it used, so you can check the source rather than take the answer on trust. +Every page has an **Ask AI** button in the bottom-right corner that opens the Celo Docs Assistant. It answers from the documentation and links the pages it used, so you can check the source rather than take the answer on trust. + +The assistant can only search these docs, and it refuses questions unrelated to Celo. It can't see your wallet or account, send transactions, install skills or run commands, and it doesn't read live chain data; for that, use the [Celo MCP Server](/build-on-celo/build-with-ai/mcp/celo-mcp). It searches the same content as the MCP server above, which means answers reflect the docs as currently published — not a model's training data. From e2a55003385e2880f7b0351f4ea466f8ad86433e Mon Sep 17 00:00:00 2001 From: Paul Lange Date: Fri, 2 Oct 2026 14:29:26 +0200 Subject: [PATCH 2/3] docs(ai): say where to run the Celopedia install and clarify the assistant wording --- build/agents/celopedia.mdx | 4 ++-- build/agents/use-docs-with-ai.mdx | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/build/agents/celopedia.mdx b/build/agents/celopedia.mdx index bfe722e008..ca2d6dd3ad 100644 --- a/build/agents/celopedia.mdx +++ b/build/agents/celopedia.mdx @@ -25,14 +25,14 @@ Go from "what should I build?" to a live app without tab-hopping through docs. ## Install Celopedia -Add it to your coding assistant by running this command in your terminal: +Run this in a terminal, from the root of the project you want to use it in: ```bash npx skills add celo-org/celopedia-skills ``` - The command has to run in a terminal. Pasting it into a chat, including the **Ask AI** assistant on these docs, won't install it. Restart your coding assistant afterward if it doesn't discover new skills mid-session. Celopedia works with file-based skill environments including Codex, Claude Code, and OpenClaw — see the [GitHub repository](https://github.com/celo-org/celopedia-skills) for tool-specific install notes. + The command has to run in a terminal. The **Ask AI** assistant on these docs can't run it. Celopedia works with file-based skill environments including Codex, Claude Code, and OpenClaw. Claude Code needs an extra step after this command, described in the [repository README](https://github.com/celo-org/celopedia-skills#claude-code). Restart your coding assistant afterward if it doesn't discover new skills mid-session. ## Try it diff --git a/build/agents/use-docs-with-ai.mdx b/build/agents/use-docs-with-ai.mdx index 73bb719f41..5b4123f3ca 100644 --- a/build/agents/use-docs-with-ai.mdx +++ b/build/agents/use-docs-with-ai.mdx @@ -203,7 +203,7 @@ Every page has an **Ask AI** button in the bottom-right corner that opens the Ce The assistant can only search these docs, and it refuses questions unrelated to Celo. It can't see your wallet or account, send transactions, install skills or run commands, and it doesn't read live chain data; for that, use the [Celo MCP Server](/build-on-celo/build-with-ai/mcp/celo-mcp). -It searches the same content as the MCP server above, which means answers reflect the docs as currently published — not a model's training data. +The assistant searches the same content as the docs MCP server above, which means answers reflect the docs as currently published — not a model's training data. If an answer arrives without any links, the assistant offers a **Try a more thorough answer** button, which re-runs the question against a stronger model. @@ -244,5 +244,5 @@ You can also skip the menu: **append `.md` to any docs URL** to get the Markdown - Spotted something wrong on a page? Ask your assistant to use the `submit_feedback` tool — it reports the problem straight to the docs team. You can also [open an issue](https://github.com/celo-org/docs/issues). + Spotted something wrong on a page? Ask your coding assistant (with the docs MCP server connected) to use the `submit_feedback` tool — it reports the problem straight to the docs team. You can also [open an issue](https://github.com/celo-org/docs/issues). From b3f9b5cb53e76fc127831bc05e114e89a92be7d9 Mon Sep 17 00:00:00 2001 From: Paul Lange Date: Wed, 7 Oct 2026 07:09:56 +0200 Subject: [PATCH 3/3] docs(ai): link the Celo MCP Server at its build/agents path The old /build-on-celo/ path only resolves through a redirect since the Build tab move. --- build/agents/use-docs-with-ai.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build/agents/use-docs-with-ai.mdx b/build/agents/use-docs-with-ai.mdx index 5b4123f3ca..b0cae8c582 100644 --- a/build/agents/use-docs-with-ai.mdx +++ b/build/agents/use-docs-with-ai.mdx @@ -201,7 +201,7 @@ Both files are generated from the live site, so they never go stale. Every page has an **Ask AI** button in the bottom-right corner that opens the Celo Docs Assistant. It answers from the documentation and links the pages it used, so you can check the source rather than take the answer on trust. -The assistant can only search these docs, and it refuses questions unrelated to Celo. It can't see your wallet or account, send transactions, install skills or run commands, and it doesn't read live chain data; for that, use the [Celo MCP Server](/build-on-celo/build-with-ai/mcp/celo-mcp). +The assistant can only search these docs, and it refuses questions unrelated to Celo. It can't see your wallet or account, send transactions, install skills or run commands, and it doesn't read live chain data; for that, use the [Celo MCP Server](/build/agents/mcp/celo-mcp). The assistant searches the same content as the docs MCP server above, which means answers reflect the docs as currently published — not a model's training data.