copilot

name: copilot description: Hand off a task to GitHub Copilot. allowed-tools: - Bash(gh agent-task create:) - Bash(gh agent-task list:) - Bash(gh agent-task view:) - Bash(bash .claude/skills/copilot/poll.sh ) - Bash(bash .claude/skills/copilot/approve.sh ) - Bash(gh api:)

Examples

# Create a task with an inline description
gh agent-task create "<task description>"

# Create a task from a markdown file
gh agent-task create -F task-desc.md

gh agent-task create may print a queued message instead of a session URL (e.g., job <job-id> queued. View progress: https://github.com/copilot/agents). This means the task was created successfully but may stay queued for minutes or longer. Wait and then run gh agent-task list to check if a session has started.

Post-creation

Print both the session URL and the PR URL (strip /agent-sessions/... from the session URL).

Example:

Polling for completion

Once Copilot starts working, poll in the background until Copilot finishes. The script automatically finds the latest session for the PR:

bash .claude/skills/copilot/poll.sh "<owner>/<repo>" <pr_number>

Sending feedback

If the PR needs changes, batch all feedback into a single review with @copilot in each comment so they're addressed in one session:

gh api repos/<owner>/<repo>/pulls/<pr_number>/reviews --input - <<'EOF'
{
  "event": "COMMENT",
  "comments": [
    {
      "path": "<file_path>",
      "line": <line_number>,
      "side": "RIGHT",
      "body": "@copilot <comment>",
      // ... more params
    },
    // ... more comments
  ]
}
EOF

After sending feedback, Copilot starts a new session, typically within ~10 seconds. Wait at least 15 seconds before polling so the new session gets picked up.

Approving workflows

Copilot commits require approval to trigger workflows for security reasons, while maintainer commits do not. Once the PR is finalized, run the approve script:

bash .claude/skills/copilot/approve.sh "<owner>/<repo>" <pr_number>