gm3dmo/the-power/troubleshoot

Claude Code and agent skill by gm3dmo/the-power

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

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.

Install

npx vskill@latest install gm3dmo/the-power/troubleshoot

SKILL.md

Troubleshoot

Diagnose and resolve common issues when working with the-power scripts.

Known issues

SSL certificate verification failures (macOS Python)

configure.py fails with SSL: CERTIFICATE_VERIFY_FAILED.

Fix: Go to your Python.framework directory and run Install Certificates.command.

Self-signed certificates on GHES

curl fails with "SSL certificate problem: self signed certificate".

Fix: Set in .gh-api-examples.conf:

curl_custom_flags="--insecure"
base64 encoding breaks scripts

Always use `python3 base64encode.py` for base64 encoding. Never use native base64 CLI tools — they behave inconsistently across platforms. See #70.

Chrome storage issues with smee.io

Fix: Chrome > Developer Tools > Application > Storage. Clear smee entries.

HTTP error diagnosis

401 Unauthorised
CauseFix
Bad tokenRe-generate and update config
Expired tokenGenerate a new PAT
Wrong hostnameToken was created on a different instance
403 Forbidden
CauseFix
Insufficient scopeAdd required scopes (admin:org, repo, delete_repo)
SSO not authorisedAuthorise the token for SSO access
IP restrictionsCheck org/enterprise IP allow list
404 Not Found
CauseFix
Wrong org/repo nameCheck for typos
Resource does not existCreate it first
Insufficient permissionsGitHub returns 404 instead of 403 for private resources
422 Unprocessable Entity
CauseFix
Validation errorCheck required fields in the JSON payload (tmp/ directory)
Resource already existsChange name or delete the existing one
Invalid field valuesCheck API docs for valid enum values

Diagnostic scripts

ScriptPurpose
./get-authenticated-user.shConfirm token is valid
./get-an-organization.shVerify target org exists
./get-rate-limit-status-for-the-authenticated-user.shCheck rate limits
Note: check-a-token.sh often returns 401 on GHES even with a valid
token. Use get-authenticated-user.sh instead.

GHES admin API issues

  • Site admin endpoints (/admin/) require site-admin privileges.
  • Management console API uses a separate password, not a PAT.
  • If admin endpoints return 404/403, confirm the token user is a site admin.

Config verification

bash
cat .gh-api-examples.conf | grep -E '^(hostname|org|repo|team_slug)='

Check for:

  • hostname matches target instance
  • org and team_slug match existing resources
  • curl_custom_flags includes --insecure if needed for self-signed certs

Boundaries

  • Do not display the full GITHUB_TOKEN value. Show only the first

8 characters when confirming configuration.

  • Do not modify `.gh-api-examples.conf` without user consent.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
217
Repository forks
46
7-day trend score
27

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 7 Jun 2026, 4 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/gm3dmo/the-power/troubleshoot/badge)](https://verified-skill.com/skills/gm3dmo/the-power/troubleshoot)

Something wrong with this skill or its page? Tell us.