菜单
Diagnose and fix common issues in the-power GitHub API test environment. Covers SSL/certificate errors, token and authentication problems, HTTP error codes, rate limits, GHES admin API issues, and configuration verification.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Clean up GitHub resources created by the-power test environment scripts. Delete repositories, teams, members, rulesets, webhooks, environments, and other resources. Suspend or unsuspend users on GHES.
Configure the-power for a target GitHub instance. Run configure.py to generate .gh-api-examples.conf with hostname, token, org, repo, and other settings. Covers interactive and non-interactive setup, GHES vs dotcom differences, curl flags for self-signed certs, and GitHub App configuration.
Create a fully populated test organisation on a GitHub instance using the-power's build-all.sh script. Includes users, teams, repos, PRs, branch protection, and more. Requires .gh-api-examples.conf to be configured first.
Create a test repository using the-power's build-testcase scripts. Covers the full decision matrix of 30+ testcase scripts for repos with PRs, issues, workflows, secret scanning, rulesets, runners, and more.
Find the right the-power script by category, keyword, or goal. Covers all ~980 scripts organised by operation type with safety labels for destructive, GHES-only, and bulk operations.
Execute any the-power script with guided parameter input. Covers prerequisites, working directory, output interpretation, HTTP status codes, error patterns, and debugging techniques.
| name | troubleshoot |
| description | Diagnose and fix common issues in the-power GitHub API test environment. Covers SSL/certificate errors, token and authentication problems, HTTP error codes, rate limits, GHES admin API issues, and configuration verification. |
| keywords | ["troubleshoot","debug","error","fix","SSL","certificate","token","rate limit",401,403,404,422] |
Diagnose and resolve common issues when working with the-power scripts.
configure.py fails with SSL: CERTIFICATE_VERIFY_FAILED.
Fix: Go to your Python.framework directory and run
Install Certificates.command.
curl fails with "SSL certificate problem: self signed certificate".
Fix: Set in .gh-api-examples.conf:
curl_custom_flags="--insecure"
Always use python3 base64encode.py for base64 encoding. Never use
native base64 CLI tools — they behave inconsistently across platforms.
See #70.
Fix: Chrome > Developer Tools > Application > Storage. Clear smee entries.
| Cause | Fix |
|---|---|
| Bad token | Re-generate and update config |
| Expired token | Generate a new PAT |
| Wrong hostname | Token was created on a different instance |
| Cause | Fix |
|---|---|
| Insufficient scope | Add required scopes (admin:org, repo, delete_repo) |
| SSO not authorised | Authorise the token for SSO access |
| IP restrictions | Check org/enterprise IP allow list |
| Cause | Fix |
|---|---|
| Wrong org/repo name | Check for typos |
| Resource does not exist | Create it first |
| Insufficient permissions | GitHub returns 404 instead of 403 for private resources |
| Cause | Fix |
|---|---|
| Validation error | Check required fields in the JSON payload (tmp/ directory) |
| Resource already exists | Change name or delete the existing one |
| Invalid field values | Check API docs for valid enum values |
| Script | Purpose |
|---|---|
./get-authenticated-user.sh | Confirm token is valid |
./get-an-organization.sh | Verify target org exists |
./get-rate-limit-status-for-the-authenticated-user.sh | Check rate limits |
Note:
check-a-token.shoften returns 401 on GHES even with a valid token. Useget-authenticated-user.shinstead.
/admin/) require site-admin privileges.cat .gh-api-examples.conf | grep -E '^(hostname|org|repo|team_slug)='
Check for:
hostname matches target instanceorg and team_slug match existing resourcescurl_custom_flags includes --insecure if needed for self-signed certs.gh-api-examples.conf without user consent.