agent
The skywatch agent subcommand manages the Claude Code subagent file that enables natural-language aviation weather briefing inside Claude Code.
Commands
Section titled “Commands”| Command | Description | Example |
|---|---|---|
install | Copy the subagent file to ~/.claude/agents/ | skywatch agent install |
install
Section titled “install”skywatch agent installCopies skywatch.md from inside the gem to ~/.claude/agents/skywatch.md, creating the directory if it does not exist.
| Flag | Description |
|---|---|
--yes / -y | Overwrite an existing file without prompting |
Behavior
Section titled “Behavior”If ~/.claude/agents/skywatch.md already exists, the command prompts:
~/.claude/agents/skywatch.md exists. Overwrite? [y/N]Enter y or yes to overwrite, or any other input to skip. Use --yes (or -y) to bypass the prompt in scripts or CI:
skywatch agent install --yesAfter install, the command prints:
Installed: /Users/<you>/.claude/agents/skywatch.mdRestart Claude Code (or open a new session) to pick up the agent.After install
Section titled “After install”Restart Claude Code or open a new session. The agent activates automatically — no configuration file changes are needed.
See the Claude Code agent page for example interactions, AIM 7-1-5 section coverage, and notes on what the agent does and does not provide.
Custom agent directory
Section titled “Custom agent directory”The install destination can be overridden via the SKYWATCH_AGENTS_DIR environment variable:
SKYWATCH_AGENTS_DIR=/custom/path skywatch agent install