Troubleshooting
Common errors and how to resolve them.
- 401 or "Run prompter login"
- Your license token is missing or expired. Run `prompter login` again with an `anvil_sk_...` key from Settings. Verify with `prompter whoami`.
- An expected skill doesn't appear
- The registry filters skills by your account tier. Run `prompter whoami` to confirm the tier, then check the pricing page if that skill needs full CLI access.
- "Change must have at least one delta"
- The `changes/<id>/specs/` directory is empty or its files lack an operation prefix. Every delta file needs an `## ADDED Requirements` heading (or MODIFIED/REMOVED/RENAMED).
- "Requirement must have at least one scenario"
- Scenarios must use four hashes: `#### Scenario: Name`. Bullets or bold text are silently missed by the parser.
- Spec detail disappears after archiving
- A MODIFIED block replaces the entire requirement. Copy the old requirement in full — header and all its scenarios — then edit it, rather than writing only the new part.
- The registry is unreachable
- Prompter falls back to the cache in ~/.prompter/cache/skills (24-hour TTL). If you run your own instance, make sure PROMPTER_REGISTRY_URL points at the right address.
Last updated: May 16, 2026