From b0879659c5cc167ee79b45a330a62b5d79d7b195 Mon Sep 17 00:00:00 2001 From: nblog <503407184@qq.com> Date: Tue, 10 Feb 2026 10:03:49 +0800 Subject: [PATCH] fix(SKILL.md): enhance troubleshooting section with common errors and resolutions --- skills/nano-banana-pro-openrouter/SKILL.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/skills/nano-banana-pro-openrouter/SKILL.md b/skills/nano-banana-pro-openrouter/SKILL.md index 91272439..7eee2b41 100644 --- a/skills/nano-banana-pro-openrouter/SKILL.md +++ b/skills/nano-banana-pro-openrouter/SKILL.md @@ -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: ` 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: curl -LsSf https://astral.sh/uv/install.sh | sh. Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex". Then restart the terminal. | +| `AuthenticationError` / HTTP 401 | Key is invalid or has no credits. Verify at . | + +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.