mirror of
https://github.com/github/awesome-copilot.git
synced 2026-02-20 02:15:12 +00:00
fix(SKILL.md): enhance troubleshooting section with common errors and resolutions
This commit is contained in:
@@ -56,8 +56,19 @@ The skill reads an optional system prompt from `assets/SYSTEM_TEMPLATE`. This al
|
||||
|
||||
## Behavior and constraints
|
||||
|
||||
- Read the API key from `OPENROUTER_API_KEY` (no CLI flag).
|
||||
- Accept up to 3 input images via repeated `--input-image`.
|
||||
- `--filename` accepts relative paths (saves to current directory) or absolute paths.
|
||||
- If multiple images are returned, append `-1`, `-2`, etc. to the filename.
|
||||
- Print `MEDIA: <path>` for each saved image. Do not read images back into the response.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
If the script exits non-zero, check stderr against these common blockers:
|
||||
|
||||
| Symptom | Resolution |
|
||||
|---------|------------|
|
||||
| `OPENROUTER_API_KEY is not set` | Ask the user to set it. PowerShell: `$env:OPENROUTER_API_KEY = "sk-or-..."` / bash: `export OPENROUTER_API_KEY="sk-or-..."` |
|
||||
| `uv: command not found` or not recognized | macOS/Linux: <code>curl -LsSf https://astral.sh/uv/install.sh | sh</code>. Windows: <code>powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"</code>. Then restart the terminal. |
|
||||
| `AuthenticationError` / HTTP 401 | Key is invalid or has no credits. Verify at <https://openrouter.ai/settings/keys>. |
|
||||
|
||||
For transient errors (HTTP 429, network timeouts), retry once after 30 seconds. Do not retry the same error more than twice — surface the issue to the user instead.
|
||||
|
||||
Reference in New Issue
Block a user