From f41682995e021c808bb68bbc43d17b5370a74815 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Thu, 27 Aug 2026 19:17:14 +0000 Subject: [PATCH] Document the canonical hosted skill URL Co-Authored-By: bot_apk --- agent-skill.mdx | 4 ++-- start-here.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/agent-skill.mdx b/agent-skill.mdx index 2658f5f..e6bc030 100644 --- a/agent-skill.mdx +++ b/agent-skill.mdx @@ -38,7 +38,7 @@ Pick whichever your agent supports. Agents that fetch URLs but don't support skills read the hosted copy: ``` - Deploy this project with Ravion: https://www.ravion.com/SKILL.md + Deploy this project with Ravion: https://www.ravion.com/skills/use-ravion/SKILL.md ``` @@ -48,7 +48,7 @@ Agents that support skill discovery also find it through [`https://www.ravion.co ## How the skill is structured -`SKILL.md` stays short so it costs the agent almost nothing to keep loaded. It carries the resource model, the deploy path, and the rules, then links to four reference files — `setup.md`, `project-config.md`, `pipelines.md`, and `operations.md` — that the agent reads only when the task needs them. An install ships those files next to `SKILL.md`; an agent working from the hosted URL fetches them from `https://www.ravion.com/skills/use-ravion/`. +`SKILL.md` stays short so it costs the agent almost nothing to keep loaded. It carries the resource model, the deploy path, and the rules, then links to four reference files — `setup.md`, `project-config.md`, `pipelines.md`, and `operations.md` — that the agent reads only when the task needs them. An install ships those files next to `SKILL.md`, and the hosted copy keeps the same layout: `https://www.ravion.com/skills/use-ravion/SKILL.md` is the canonical URL, and the agent fetches the reference files from the same directory. The shorter `https://www.ravion.com/SKILL.md` permanently redirects there. The skill also installs the [Ravion Docs MCP server](/mcp/overview) itself so it can search current documentation while it works. Its tools only appear after you restart the agent, so install it up front if you prefer: diff --git a/start-here.mdx b/start-here.mdx index b6d115c..2253de2 100644 --- a/start-here.mdx +++ b/start-here.mdx @@ -45,7 +45,7 @@ The agent also asks for the decisions it should not guess, such as region, insta Agents that fetch URLs but do not support skills read the hosted copy: ``` -Deploy this project with Ravion: https://www.ravion.com/SKILL.md +Deploy this project with Ravion: https://www.ravion.com/skills/use-ravion/SKILL.md ``` To search the docs from the agent's context window, add the [Ravion Docs MCP server](/mcp/overview) — the skill installs it on its own, so this is only for doing it up front: