GitHub readiness
This is a read-only capability check; do not create a test issue or PR.
Checks
- Identify the intended host and owner/repository from the request and local remote configuration. Report a sanitized repository URL, not credentials embedded in a remote. Do not assume github.com when an enterprise host is configured.
- Prefer an available GitHub connection. Read the target repository and relevant resource to verify access; inspect callable capabilities and repository permissions for the upcoming operation. Missing CLI is not failure when the connection suffices.
- When CLI is required, use command -v gh, gh auth status --hostname , and a read-only API call to the intended repository. Do not use auth token, --show-token, dump environment variables, or start login/refresh as a side effect of this check.
- Report the identity/host when available, repository match, read access and write permission evidence. Classic OAuth scopes are only one credential model: a fine-grained or GitHub App token cannot be judged from a missing "repo" scope. A readable repository alone does not prove permission to create a release or PR.
- Reuse the successful check during this session unless account, host, repository, operation or an authentication failure changes the evidence.
Result
- PASS: the selected path supports the requested operation, with evidence.
- PARTIAL: reading works but required write capability or repository selection is unverified; name the uncertainty and the narrow next check.
- FAIL: no usable path reaches the intended resource; report the actual failure and recovery step. Do not claim access was restored until a subsequent read succeeds.
Example
"File a bug using our GitHub connection" → check that repository and issue creation capability; do not require installing gh when the connection already supports it.
Closed decisions and open decisions
The target repository/host is a closed decision when specified. Resolve conflicting remotes or missing operation permissions before a write.
Do not
Do not print tokens, request broader access speculatively, mutate authentication, or conflate a missing tool with a missing GitHub capability.
Copilot integration
This skill is the durable entrypoint for Copilot hosts that load agent skills. The matching prompt file is an optional VS Code shortcut. Read repository instructions before edits; use the tools actually exposed by the host, including connected GitHub access when available. A prompt or skill does not itself grant additional permissions.