# Skill Copilot Provider

GitHub Copilot CLI as optional zero-cost provider via copilot -p programmatic mode

- Repository: https://github.com/nyldn/claude-octopus (4351 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nyldn/claude-octopus --skill skill-copilot-provider -g -a claude-code -y`
Codex: `npx skills add nyldn/claude-octopus --skill skill-copilot-provider -g -a codex -y`
Cursor: `npx skills add nyldn/claude-octopus --skill skill-copilot-provider -g -a cursor -y`
Gemini CLI: `npx skills add nyldn/claude-octopus --skill skill-copilot-provider -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add nyldn/claude-octopus`

## Description

GitHub Copilot CLI as optional zero-cost provider via copilot -p programmatic mode

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# GitHub Copilot Provider Skill

## Overview

GitHub Copilot CLI (GA since Feb 2026) serves as an optional provider in the Claude Octopus
multi-LLM ecosystem. Integration uses the official `copilot -p` programmatic mode, not
reverse-engineered API endpoints.

**Core principle:** Copilot supplements existing providers for research and exploration at
zero additional cost (uses existing GitHub Copilot subscription). Each prompt counts as one
premium request against your subscription quota.

**Agent types:** `copilot` (general), `copilot-research` (research-focused)

---

## Detection

```bash
# Check copilot CLI is available
if ! command -v copilot &>/dev/null; then
  # Copilot CLI not installed, silently skip
  return 0
fi
```

**Graceful degradation:** When Copilot CLI is unavailable or unauthenticated, silently skip.
Other providers continue to operate normally.

---

## Authentication

Copilot CLI checks credentials in this precedence order:

1. `COPILOT_GITHUB_TOKEN` env var (highest priority, fine-grained PAT with "Copilot Requests" permission)
2. `GH_TOKEN` env var
3. `GITHUB_TOKEN` env var
4. OAuth token from system keychain (via `copilot login`)
5. GitHub CLI (`gh`) authentication fallback

### Setup

**Option 1: Interactive login (recommended for local dev)**
```bash
copilot login
```

**Option 2: Fine-grained PAT (recommended for CI/automation)**
1. Create a fine-grained PAT at https://github.com/settings/personal-access-tokens/new
2. Enable the "Copilot Requests" permission
3. Set the env var:
```bash
export COPILOT_GITHUB_TOKEN="github_pat_..."
```

**Option 3: Reuse existing `gh` auth**
If `gh auth login` is already configured, Copilot CLI will use it automatically.

**Note:** Classic PATs (`ghp_*`) are NOT supported. Use fine-grained PATs (`github_pat_*`).

---

## Available Roles

The rest: https://github.com/nyldn/claude-octopus/blob/HEAD/.claude/skills/skill-copilot-provider/SKILL.md