Center Start here on the Ravion agent skill

[devin-ai-integration]

Summary

Start here duplicated the whole agent workflow (concepts → config → dry run → approve → pipelines → CI) in prose that agents had to be spoon-fed by the reader. That workflow now lives in the hosted use-ravion agent skill at https://www.ravion.com/SKILL.md (see ravionhq/flightcontrol#7034), so this page keeps only the steps a human must do — sign up, connect AWS, connect a Git repo, install Docs MCP, install and sign in to the CLI — plus installing the skill, and then hands off:

Deploy this project to AWS with Ravion.

with a URL fallback for agents that fetch but don't support skills: Deploy this project with Ravion: https://www.ravion.com/SKILL.md.

New agent-skill.mdx documents the hosted skill: npx skills add https://www.ravion.com/SKILL.md, the /.well-known/agent-skills/index.json discovery endpoint, the ravionhq/skills repo and Claude Code plugin marketplace, the prompt CTA, what the skill covers, and pairing it with Docs MCP. Added to the Introduction group right after start-here.

Link to Devin session: https://app.devin.ai/sessions/595684384d7a472b8b6c468cd7437e64
Requested by: @flybayer

Greptile Summary

The PR centers the onboarding flow on Ravion’s hosted agent skill while retaining the human-owned setup steps.

• Adds an Agent skill page covering installation, discovery, usage, scope, and Docs MCP pairing.
• Adds the page to the Introduction navigation.
• Replaces the duplicated agent workflow in Start here with skill-based and URL-based handoffs.

Confidence Score: 5/5

The PR appears safe to merge, with no concrete changed-code defect identified.

The new page is correctly registered, its internal links and commands align with existing documentation, and the streamlined Start here flow retains installation and fallback instructions.

Important Files Changed

Filename	Overview
agent-skill.mdx	Adds a well-formed documentation page whose frontmatter, links, commands, and formatting follow repository conventions.
docs.json	Registers the new agent-skill page in the Introduction navigation at the intended location.
start-here.mdx	Simplifies onboarding by retaining human setup and delegating agent-specific deployment workflows to the hosted skill.

_{Reviews (1): Last reviewed commit: "Center Start here on the Ravion agent sk..." | Re-trigger Greptile}

[mintlify]

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

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

[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