AI Agent Skill

Teach your AI agent to Disco.

Disco publishes two files for AI agents: an install guide and a skill reference. Point your agent at the install guide first, then the skill reference takes over for everything after install.

Step 1: Install — point your agent at install.md

Copy this URL and paste it into your AI agent's chat. The install guide walks the agent through downloading Disco and saving the ForeFlight API key. Grok opens an editor (disco setup --editor) so the key never enters chat.

https://disco.aeronautic.ai/install.md

Or just tell your agent:

"Read https://disco.aeronautic.ai/install.md and install Disco for me."

Step 2: Use — skill.md is the command reference

Once Disco is installed, your agent reads skill.md for the full command and MCP tool reference. This is what the agent consults whenever you ask it to plan a flight, check weather, or look up a route.

https://disco.aeronautic.ai/skill.md

Grok Bot

Paste the install URL into the Bot chat and approve computer use. Grok Bot runs the installer on its computer, then save Disco as a skill.

Grok / Claude Code / Codex

Paste the install URL into chat, or run grok "Read …/install.md and install Disco for me." Same flow on Claude Code and Codex CLI.

OpenClaw

Same install line in an active OpenClaw session. Supported, not required — Grok Bot is the path we recommend.

Google Gemini CLI

Provide the install URL. Gemini reads the spec and follows the install and config instructions.

Any MCP-Compatible Agent

Both files are plain markdown. Any agent that can read a URL and run shell commands can install and use Disco.

What's in each file

install.md — run this first
Covers: 1. curl one-liner to install the disco CLI 2. Pointing the user at the ForeFlight key page if they don't have one 3. Saving the key via disco setup --editor (Grok) or disco setup --api-key "..." (hosts that already have the key) 4. Verifying connectivity with disco flights 5. Skill install for Grok, Claude Code, Codex, and Grok Bot 6. Troubleshooting
skill.md — reference for every call after install
Covers: 1. When to use this skill (intent patterns) 2. Full CLI command reference (flights, crew, passengers, aircraft, performance, documents, release, reschedule) 3. 40+ MCP tools organized by domain: dispatch, flight planning, weather, airports, navigation, NOTAMs, fusion data 4. Natural language → command mapping table 5. Behavior notes (timezones, ETD display, flag aliases)
View install.md View skill.md

What happens when your agent reads install.md

  1. The agent fetches install.md from the URL
  2. It runs curl -fsSL https://disco.aeronautic.ai/install.sh | bash to install the CLI
  3. It points you to dispatch.foreflight.com/tools/console/keys if you don't have a key
  4. Grok runs disco setup --editor so you paste the key in an editor, not in chat. Other hosts may still use disco setup --api-key
  5. It verifies the install by running disco flights
  6. For any subsequent request, it reads skill.md for the command and tool reference

The entire flow is hands-off once you give your agent the URL and paste the key where it asks you to (an editor, for Grok).