# Flight Planner

> Plan multi-leg flights with wind-optimized timing and calendar integration. Use when asked to plan a flight, create a flight plan, or schedule a flying mission. Takes a route (e.g., "HSV to JWN to HMP to HSV"), calculates times with winds aloft, and creates calendar entries.

- Skill: `probichaux/flight-planner` (Agent Skill)
- Install (CLI): `npx skillmds@latest add probichaux/flight-planner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/probichaux/flight-planner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: probichaux (https://skillmd.com/u/probichaux)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/probichaux/flight-planner

---


# Flight Planner

End-to-end flight planning: route → winds → timing → calendar.

## Workflow

When asked to plan a flight:

1. **Parse the route** — Extract airport sequence (e.g., "HSV to JWN to HMP to HSV")

2. **Calculate each leg** — Use `flight_time.py` for each leg:
   ```bash
   ~/clawd/skills/flight-time/scripts/flight_time.py KDEP KARR --altitude ALT --tas TAS --json
   ```

3. **Optimize altitude** — Check multiple altitudes (4000, 6000, 8000, 10000) for the longest leg and pick the best ground speed. Note the recommendation.

4. **Add ground time** — 30 minutes at each intermediate stop (pickup/dropoff)

5. **Build timeline** — Start from requested departure time, sequence all legs and ground stops

6. **Ask about attendees** — Before creating calendar entry, ask:
   > "Should anyone be invited to this flight?"

7. **Create calendar entry** — Use `m365cal.py create` with:
   - Subject: Route summary (e.g., "Flight: HSV-JWN-HMP-HSV")
   - Duration: Total block time
   - Body: Full timeline and leg details
   - Attendees: As specified

## Default Parameters

- **TAS**: 185 kt
- **Fuel burn**: 24 gph
- **Altitude**: 6000 ft (optimize from there)
- **Ground time**: 30 min per stop

## Example Output Format

```
✈️ FLIGHT PLAN: HSV-JWN-HMP-HSV
Date: Jan 29, 2026 | Depart: 12:00

LEG 1: HSV → JWN
• 93 nm | TC 357° | 0:35
• Winds 300°@48kt (tailwind)

LEG 2: JWN → HMP  
• 210 nm | TC 142° | 2:23
• Winds 320°@52kt (headwind)
• ⚠️ Better at 8000ft: 2:03

[... more legs ...]

TIMELINE
12:00 Depart HSV
12:35 Arrive JWN (30 min ground)
13:05 Depart JWN
[...]

TOTALS: 446 nm | 3:44 flight | 4:44 block | ~90 gal

Should anyone be invited to this flight?
```

## Dependencies

- `~/clawd/skills/flight-time/scripts/flight_time.py` — Time/wind calculations
- `~/clawd/skills/m365-calendar/scripts/m365cal.py` — Calendar integration