Document the canonical hosted agent-skill URL

[devin-ai-integration]

Summary

Requested by Brandon Bayer.

The URL-only install snippet advertised https://www.ravion.com/SKILL.md, which sits at a different path from the four reference files the skill links to. ravionhq/flightcontrol#7106 makes https://www.ravion.com/skills/use-ravion/SKILL.md the canonical 200 (matching the ravionhq/skills layout) and 308-redirects /SKILL.md, /skill.md, /skill, /skills/use-ravion and /skills/use-ravion/ to it.

This points the snippet in agent-skill.mdx and start-here.mdx at the canonical URL and notes that the short /SKILL.md form permanently redirects, so the old copy-pasted prompt keeps working.

Depends on ravionhq/flightcontrol#7106 deploying first. Please don't merge until then.

Link to Devin session: https://app.devin.ai/sessions/95f39333bd6e4338a2a42a32895acba6
Open in Devin Desktop: https://app.devin.ai/desktop/session/95f39333bd6e4338a2a42a32895acba6?variant=devin

Greptile Summary

Updates the URL-only installation instructions to use the canonical hosted agent-skill path and documents continued compatibility through the short URL’s permanent redirect.

• Replaces https://www.ravion.com/SKILL.md with https://www.ravion.com/skills/use-ravion/SKILL.md in both installation snippets.
• Clarifies that the skill and its reference files share a directory and that the former URL redirects to the canonical path.

Confidence Score: 5/5

The documentation change appears safe to merge after its explicitly stated hosting dependency has deployed.

The two pages consistently use the new canonical URL, and the only identified availability risk is already covered by the PR’s explicit deployment-order requirement.

Important Files Changed

Filename	Overview
agent-skill.mdx	Updates the URL-only snippet and explains the canonical hosted layout and legacy redirect.
start-here.mdx	Points the introductory URL-only workflow at the canonical hosted skill URL.

_{Reviews (1): Last reviewed commit: "Document the canonical hosted skill URL" | Re-trigger Greptile}

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment, CI, and merge conflict monitoring

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Ravion	🟢 Ready	View Preview	Aug 27, 2026, 7:19 PM

[devin-ai-integration]

Closing per Brandon: the docs should keep advertising the short https://www.ravion.com/SKILL.md URL, which stays live as a 308 alias to the canonical file after ravionhq/flightcontrol#7106.