skill-copilot-provider
GitHub Copilot CLI as optional zero-cost provider via copilot -p programmatic mode
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- skill-copilot-provider
- description
- GitHub Copilot CLI as optional zero-cost provider via copilot -p programmatic mode
- disable-model-invocation
- true
02 资源文件 1
- 参考文档agents/openai.yaml177 B
03 SKILL.md 正文
Host: Codex CLI — This skill was designed for Claude Code and adapted for Codex. Cross-reference commands use installed skill names in Codex rather than
/octo:*slash commands. Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it. For host tool equivalents, seeskills/blocks/codex-host-adapter.md.
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
# 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:
COPILOT_GITHUB_TOKENenv var (highest priority — fine-grained PAT with "Copilot Requests" permission)GH_TOKENenv varGITHUB_TOKENenv var- OAuth token from system keychain (via
copilot login) - GitHub CLI (
gh) authentication fallback
Setup
Option 1: Interactive login (recommended for local dev)
copilot login
Option 2: Fine-grained PAT (recommended for CI/automation)
- Create a fine-grained PAT at https://github.com/settings/personal-access-tokens/new
- Enable the "Copilot Requests" permission
- Set the env var:
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
| Role | Agent Type | Use Case |
|---|---|---|
| General | copilot |
Broad research, code explanation, exploration |
| Research | copilot-research |
Research-focused exploration and analysis |
Dispatch
# Programmatic mode (non-interactive)
copilot -p "<prompt>" --no-ask-user
Provider Indicators
When Copilot is active in a multi-provider workflow:
Providers:
? Codex CLI - Implementation
? Antigravity CLI - Security review
? Copilot CLI - Research perspective
? Claude - Synthesis
Indicator legend:
- ? = Codex CLI
- ? = Antigravity CLI
- ? = Copilot CLI
- ? = Perplexity
- ? = Claude
Doctor Integration
The octopus doctor providers check reports Copilot availability and auth method:
Providers:
✓ Copilot CLI installed (auth: keychain)
When unauthenticated: ⚠ Copilot CLI installed but not authenticated
When missing: ℹ Copilot CLI not installed (optional)
Integration Notes
- Zero additional cost — Uses existing GitHub Copilot subscription (Pro, Pro+, Business, Enterprise)
- Premium request quota — Each
copilot -pprompt = 1 premium request from your monthly allowance - Graceful degradation — When unavailable, silently skip with no errors or warnings
- No provider cascade — If unavailable, the role is reassigned to another provider
- Model selection — Octopus uses Copilot's
autoselector by default; pinOCTOPUS_COPILOT_MODELto pass an explicit--modelvalue - Multi-model access — Copilot subscription includes access to Claude, GPT, and Gemini models
Example Workflows
Research with Copilot
? **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
? Discover Phase: Researching WebSocket authentication patterns
Providers:
? Codex CLI - Technical implementation analysis
? Antigravity CLI - Ecosystem research
? Copilot CLI - Research perspective
? Claude - Strategic synthesis
Copilot Unavailable (Graceful Degradation)
? **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
? Discover Phase: Researching WebSocket authentication patterns
Providers:
? Codex CLI - Technical implementation analysis
? Antigravity CLI - Ecosystem research
? Claude - Strategic synthesis
When Copilot is not detected, it is silently omitted from the provider list.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.