nav-pilot

Dispatch Navigator task docs to Pilot as labeled GitHub issues via gh CLI.

232|12|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/qf-studio/navigator --skill nav-pilot-qf-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nav-pilot
Source: https://github.com/qf-studio/navigator/tree/main/skills/nav-pilot
Command: npx skills add https://github.com/qf-studio/navigator --skill nav-pilot-qf-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Handing off a finished task specification to an autonomous execution agent requires manually creating a correctly labeled GitHub issue and tracking the result. This Skill automates that one-way handoff so the task doc is dispatched to Pilot without copy-pasting or losing the issue reference. ## Core Features & Use Cases - Task Doc Resolution: Locates the target task doc in .agent/tasks/ by explicit ID (e.g., TASK-07) or by picking the active task, extracting the H1 title for the issue. - Config-Driven Dispatch: Reads the pilot section of .agent/.nav-config.json for the label and target repo, then builds the correct gh issue create command with --body-file. - Pre-flight Confirmation & Dry-Run: Shows the exact repo, title, label, and command before any network call, and supports a dry-run mode that prints the command without executing. - Write-Back Tracking: Records the created issue URL under the doc's ## Refs section and updates the status to Dispatched. - Use Case: After authoring TASK-12 with nav-task, say "dispatch TASK-12 to Pilot" and the Skill creates the pilot-labeled issue and logs the URL back into the doc. ## Quick Start Tell the assistant to dispatch TASK-XX to Pilot after authoring the task doc with nav-task.

Frequently Asked Questions about nav-pilot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I dispatch a task doc to Pilot as a GitHub issue?

Say "dispatch TASK-XX to Pilot" after authoring the doc with nav-task. The Skill resolves the doc in .agent/tasks/, builds a gh issue create command with the pilot label and --body-file, confirms with you, then creates the issue and records the URL back into the doc.

How do I create a GitHub issue from a markdown file with gh CLI?

Use gh issue create with --title, --label, and --body-file pointing at the markdown file. The body file is passed by path rather than inlined, and gh prints the new issue URL on success.

Does nav-pilot validate the task spec before dispatching?

No, validation is intentionally out of scope. Spec checking is owned by Pilot's spec_validator on the receiving side; nav-pilot only resolves the doc, creates the labeled issue, and records the result.

What happens if the gh CLI is not authenticated or the label is missing?

If gh is not authenticated, the Skill tells you to run gh auth login. If the pilot label does not exist on the repo, it offers to run gh label create pilot. If no remote is found, it asks you to set pilot.repo in .nav-config.json.

Can I preview the dispatch command without creating the issue?

Yes, request a dry run and the Skill prints the exact gh issue create command and stops without executing. Every dispatch also shows a pre-flight confirmation with repo, title, label, and body file before any network call.

Can nav-pilot monitor Pilot workers or pull results back?

No, the handoff is one-way by design. Monitoring Pilot worker status and retrieving execution results are explicitly out of scope for this Skill.