参照/Reference

Troubleshooting

GitHub rate limit errors (403 / 429)

Direct GitHub installs (repo, tree, blob, raw) use the GitHub API. Without a token, GitHub applies strict rate limits per IP. Configure a KENJI_GITHUB_TOKEN to raise the limit. See GitHub Tokens.

Registry unavailable

If kenji search or kenji install fails to reach the registry, run kenji doctor to check network connectivity to the Kenji API.

Skill already installed

If a skill already exists in the target directory, Kenji will not overwrite it. Pass --force to overwrite:

shell
$ kenji install kenji/react-debug --force

Stack install partially failed

Stack installs continue past individual failures. If some skills are missing after kenji stack install, run kenji list to see what was installed, then reinstall missing skills individually.

Case sensitivity

Skill names and registry lookups are case-insensitive. If a skill was installed as ReactDebug, kenji use reactdebug will find it.

Community skill prompt

Community registry installs require confirmation. If you are running in a non-interactive environment, pass --force to skip the prompt.