docs: add unknown-skill troubleshooting for Claude Code#232
docs: add unknown-skill troubleshooting for Claude Code#232marcelsafin wants to merge 2 commits intoHKUDS:mainfrom
Conversation
|
@maintainers Could you switch requested reviewer to Codex for this PR? Copilot review is currently unavailable on our side. |
marcelsafin
left a comment
marcelsafin
left a comment
There was a problem hiding this comment.
Codex review pass completed.
Result: No blocking issues found in this PR.
Checked:
- EN/CN docs are consistent on command compatibility and fallback forms
- Troubleshooting flow is actionable and ordered
- Scope remains docs-only with no behavior change
Residual risk: very low.
|
@codex review |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 2736e19a1b
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
|
@codex address that feedback. Please align the CN quickstart so |
|
To use Codex here, create an environment for this repo. |
|
Addressed the previous Codex feedback in the latest commit. @codex review |
|
To use Codex here, create an environment for this repo. |
|
@codex review |
|
Codex Review: Didn't find any major issues. 👍 ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
|
@codex review latest head ( |
|
Codex Review: Didn't find any major issues. Keep it up! ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
|
@maintainers Status update: Codex feedback for this PR is addressed and thread is resolved ( |
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| If you still see `Unknown skill: cli-anything`: | ||
| 1. Reload plugin commands: `/reload-plugins` | ||
| 2. Verify install state: `/plugin list` (confirm `cli-anything` is present) |
There was a problem hiding this comment.
Troubleshooting step 2 uses /plugin list, but this repo’s plugin docs consistently use /help cli-anything as the verification mechanism (e.g., cli-anything-plugin/QUICKSTART.md). Consider replacing or supplementing /plugin list with /help cli-anything to avoid depending on a potentially unsupported Claude Code command.
| 2. Verify install state: `/plugin list` (confirm `cli-anything` is present) | |
| 2. Verify install state: `/help cli-anything` (confirm the CLI-Anything help/commands appear) |
| - 如果报错 `Unknown skill: cli-anything`，请改用 `/cli-anything:cli-anything` 重试。 | ||
| - 其他辅助命令保持 `:子命令` 形式（例如 `/cli-anything:refine`）。 | ||
|
|
||
| 如果仍然出现 `Unknown skill: cli-anything`： | ||
| 1. 重新加载插件命令：`/reload-plugins` | ||
| 2. 检查安装状态：`/plugin list`（确认存在 `cli-anything`） | ||
| 3. 重新安装市场插件： | ||
| - `/plugin marketplace add HKUDS/CLI-Anything` | ||
| - `/plugin install cli-anything` | ||
| 4. 依次重试两种入口： |
There was a problem hiding this comment.
“如果报错 Unknown skill: cli-anything，请改用 /cli-anything:cli-anything 重试” 这条建议很可能无效：两种写法都引用同一个 skill 名称 cli-anything。若提示 Unknown skill，更可行的排查是确认插件已安装并被加载（reload/验证安装），而不是切换入口形式。
| - 如果报错 `Unknown skill: cli-anything`，请改用 `/cli-anything:cli-anything` 重试。 | |
| - 其他辅助命令保持 `:子命令` 形式（例如 `/cli-anything:refine`）。 | |
| 如果仍然出现 `Unknown skill: cli-anything`： | |
| 1. 重新加载插件命令：`/reload-plugins` | |
| 2. 检查安装状态：`/plugin list`（确认存在 `cli-anything`） | |
| 3. 重新安装市场插件： | |
| - `/plugin marketplace add HKUDS/CLI-Anything` | |
| - `/plugin install cli-anything` | |
| 4. 依次重试两种入口： | |
| - 旧版本如主入口不可用，可尝试兼容写法 `/cli-anything:cli-anything`。 | |
| - 在插件已正常安装并加载后，其他辅助命令使用 `:子命令` 形式（例如 `/cli-anything:refine`）。 | |
| 如果出现 `Unknown skill: cli-anything`，更可能是插件未安装或未加载成功，请按以下步骤排查： | |
| 1. 重新加载插件命令：`/reload-plugins` | |
| 2. 检查安装状态：`/plugin list`（确认存在 `cli-anything`） | |
| 3. 重新安装市场插件： | |
| - `/plugin marketplace add HKUDS/CLI-Anything` | |
| - `/plugin install cli-anything` | |
| 4. 完成上述检查后，再重试命令： |
| 2. 检查安装状态：`/plugin list`（确认存在 `cli-anything`） | ||
| 3. 重新安装市场插件： | ||
| - `/plugin marketplace add HKUDS/CLI-Anything` | ||
| - `/plugin install cli-anything` | ||
| 4. 依次重试两种入口： |
There was a problem hiding this comment.
排查步骤里使用了 /plugin list 来确认插件存在，但仓库内的插件文档（如 cli-anything-plugin/QUICKSTART.md）使用的是 /help cli-anything 作为验证方式。建议改为或补充 /help cli-anything，避免依赖可能不存在的 Claude Code 命令。
| 2. 检查安装状态：`/plugin list`（确认存在 `cli-anything`） | |
| 3. 重新安装市场插件： | |
| - `/plugin marketplace add HKUDS/CLI-Anything` | |
| - `/plugin install cli-anything` | |
| 4. 依次重试两种入口： | |
| 2. 先验证插件是否已加载：`/help cli-anything` | |
| 3. 如果仍无法识别，再重新安装市场插件： | |
| - `/plugin marketplace add HKUDS/CLI-Anything` | |
| - `/plugin install cli-anything` | |
| 4. 安装后再次验证：`/help cli-anything` | |
| 5. 依次重试两种入口： |
| Command compatibility across Claude Code versions: | ||
| - Use `/cli-anything` as the primary entrypoint. | ||
| - If your build reports `Unknown skill: cli-anything`, retry with `/cli-anything:cli-anything`. | ||
| - Auxiliary commands keep the `:subcommand` form (e.g. `/cli-anything:refine`). |
There was a problem hiding this comment.
The suggested workaround “if you see Unknown skill: cli-anything, retry with /cli-anything:cli-anything” is likely ineffective because both forms still reference the same skill name (cli-anything). If the skill is unknown, the actionable fix is to ensure the plugin is installed/loaded (reload plugins, verify via help/installation steps) rather than changing the entry form.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| 如果仍然出现 `Unknown skill: cli-anything`： | ||
| 1. 重新加载插件命令：`/reload-plugins` | ||
| 2. 检查安装状态：`/plugin list`（确认存在 `cli-anything`） |
There was a problem hiding this comment.
第 2 步使用了 /plugin list 来检查安装状态，但仓库内其他 Claude Code 插件文档（如 cli-anything-plugin/QUICKSTART.md）用的是 /help cli-anything 来验证插件是否已加载。为避免用户执行可能不存在/不稳定的命令，建议把这里的校验方式改为 /help cli-anything（或与现有文档保持一致的检查）。
| 2. 检查安装状态：`/plugin list`（确认存在 `cli-anything`） | |
| 2. 检查插件是否已加载：`/help cli-anything`（能看到帮助即表示已加载） |
| - If your build reports `Unknown skill: cli-anything`, retry with `/cli-anything:cli-anything`. | ||
| - Auxiliary commands keep the `:subcommand` form (e.g. `/cli-anything:refine`). | ||
|
|
||
| If you still see `Unknown skill: cli-anything`: | ||
| 1. Reload plugin commands: `/reload-plugins` | ||
| 2. Verify install state: `/plugin list` (confirm `cli-anything` is present) | ||
| 3. Reinstall from marketplace: | ||
| - `/plugin marketplace add HKUDS/CLI-Anything` | ||
| - `/plugin install cli-anything` | ||
| 4. Retry both entry forms: | ||
| - `/cli-anything ./gimp` | ||
| - `/cli-anything:cli-anything ./gimp` |
There was a problem hiding this comment.
The guidance “If you see Unknown skill: cli-anything, retry with /cli-anything:cli-anything” is misleading: both forms still reference the same skill name (cli-anything), so this won’t resolve an unknown skill error. Consider rewording to: use /cli-anything:cli-anything only for older builds where /cli-anything isn’t recognized after confirming the plugin is installed/loaded; otherwise focus troubleshooting on installation/reload steps.
| - If your build reports `Unknown skill: cli-anything`, retry with `/cli-anything:cli-anything`. | |
| - Auxiliary commands keep the `:subcommand` form (e.g. `/cli-anything:refine`). | |
| If you still see `Unknown skill: cli-anything`: | |
| 1. Reload plugin commands: `/reload-plugins` | |
| 2. Verify install state: `/plugin list` (confirm `cli-anything` is present) | |
| 3. Reinstall from marketplace: | |
| - `/plugin marketplace add HKUDS/CLI-Anything` | |
| - `/plugin install cli-anything` | |
| 4. Retry both entry forms: | |
| - `/cli-anything ./gimp` | |
| - `/cli-anything:cli-anything ./gimp` | |
| - On some older builds, if `/cli-anything` itself is not recognized after you have confirmed the plugin is installed and loaded, try the legacy entry form `/cli-anything:cli-anything`. | |
| - Auxiliary commands keep the `:subcommand` form (e.g. `/cli-anything:refine`). | |
| If you see `Unknown skill: cli-anything`, focus on plugin installation/loading first: | |
| 1. Reload plugin commands: `/reload-plugins` | |
| 2. Verify install state: `/plugin list` (confirm `cli-anything` is present) | |
| 3. Reinstall from marketplace if needed: | |
| - `/plugin marketplace add HKUDS/CLI-Anything` | |
| - `/plugin install cli-anything` | |
| 4. After confirming the plugin is available, retry the entry command: | |
| - Preferred: `/cli-anything ./gimp` | |
| - Older builds only: `/cli-anything:cli-anything ./gimp` |
|
@copilot apply changes based on the comments in this thread |
Description
Document command compatibility and troubleshooting for
Unknown skill: cli-anythingwhen using Claude Code, including reload/reinstall verification flow in both EN and CN READMEs.Fixes #19
Type of Change
For New Software CLIs (in-repo)
<SOFTWARE>.mdSOP document exists at<software>/agent-harness/<SOFTWARE>.mdSKILL.mdexists atskills/cli-anything-<software>/SKILL.mdSKILL.mdexists atcli_anything/<software>/skills/SKILL.mdcli_anything/<software>/tests/test_core.pyare present and pass without backendcli_anything/<software>/tests/test_full_e2e.pyare presentREADME.mdincludes the new software (with link to harness directory)registry.jsonincludes an entry withsource_url: null(see Contributing guide)repl_skin.pyinutils/is an unmodified copy from the pluginFor New Software CLIs (standalone repo)
pip install <package-name>or apip install git+https://...URLSKILL.mdexists in the external reporegistry.jsonentry includessource_urlpointing to the external reporegistry.jsonentry includesskill_mdwith full URL to the external SKILL.mdinstall_cmdinregistry.jsonworks (tested locally)For Existing CLI Modifications
python3 -m pytest cli_anything/<software>/tests/test_core.py -vpython3 -m pytest cli_anything/<software>/tests/test_full_e2e.py -vregistry.jsonentry is updated if version, description, or requirements changedGeneral Checklist
--jsonflag is supported on any new commandsfeat:,fix:,docs:,test:)Test Results