Skip to content

Document the canonical hosted agent-skill URL #70

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
devin-ai-integration wants to merge 1 commit into from
Closed

Document the canonical hosted agent-skill URL #70

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions agent-skill.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

</Tab>
Expand All @@ -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:

Expand Down
2 changes: 1 addition & 1 deletion start-here.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Loading