skills installed to the wrong path - cc-switch

Quick fix

Older cc-switch installs skills into ~/.claude/skills/skills, which Claude Code ignores. Upgrade, or move the contents up to ~/.claude/skills/.

Symptom

Error outputCopy

安装完后发现 claude code 不识别，后来发现安装在了 ~/.claude/skills/skills 目录下，手动向上移了一层目录到 ~/.claude/skills 下正常了。

English translation

After installing, Claude Code did not recognise it. It turned out to be installed under ~/.claude/skills/skills; moving it up one level to ~/.claude/skills fixed it.

Cause

When installing skills from a skill repository, cc-switch parses the repository path and builds a target directory. Older versions treated the `skills` in the repository path as a target level too, installing codex/gemini skills into `~/.claude/skills/skills/` rather than the `~/.claude/skills/` Claude Code actually scans — hence not being recognised after install. #265 and #267 from the same period also report Claude/Gemini skill installs failing, which maintainers confirmed as fixed in the next version.

Moving the contents of `~/.claude/skills/skills/` up by hand does let Claude Code activate the skill temporarily, but cc-switch cannot track the moved location. For a Gemini CLI skill symlink, `~/.gemini/skills/` is the correct user-level skills directory for the Gemini CLI cc-switch manages, and should not be moved to the Antigravity `~/.gemini/config/skills/`.

Fix

1. 1

   Upgrade to a fixed version. Maintainers confirmed in #382, #265, and #267 that "the new version fixes this" or "the next minor version will fix it" — reinstall the affected skills after upgrading.

2. 2

   Stopgap (only if you cannot upgrade): move the contents of `~/.claude/skills/skills/` into `~/.claude/skills/`. After a manual move, cc-switch may no longer recognise the skill, so reinstall it once you have upgraded.

3. 3

   If you use the Gemini CLI, keep the symlink at `~/.gemini/skills/`. Do not move it to `~/.gemini/config/skills/`, because the Gemini CLI does not scan that path and Antigravity is not an app cc-switch manages.

Affected Versions

ToolClaude Code / Codex / Gemini CLI

Version3.8.2（受影响报告版本）

PlatformsWindowsmacOS

Source Issues

This page is distilled from 4 real issues

• #265Claude Skills 怎安装失败？
• #267gemini skills 安装失败
• #382skills 安装路径不对
• #5744[Bug] 全局技能软链接创建路径有误：软链接生成在 ~/.gemini/skills 而非 ~/.gemini/config/skills

FAQ

The skill activates after moving it by hand, but cc-switch no longer recognises it. What now?

A side effect of the manual move. Upgrade to a fixed version and reinstall through cc-switch, rather than maintaining `~/.claude/skills/` by hand.

Why is the Gemini skill symlink at `~/.gemini/skills/` rather than `~/.gemini/config/skills/`?

cc-switch manages the Gemini CLI, whose user-level Skills directory is `~/.gemini/skills/`, with `~/.agents/skills/` also supported. `~/.gemini/config/skills/` is an Antigravity directory, and Antigravity is not managed by cc-switch.

Installing codex/gemini skills reports an install failure outright. What now?

Those reports relate to the same batch of path and packaging problems, which maintainers confirmed fixed in a later version. Upgrade and retry.

Related problems

cc-switch crashes immediately after openingNo confirmed fix. Reinstalling does not help. Collect debug logs and wait for an official fix.1 issues mergedshow 0 skills from cc-switchUpgrade cc-switch to v3.17.0 and re-toggle the skill state to fix Windows Hermes Desktop reading the LOCALAPPDATA path.1 issues mergedTest script: error, no result returnedMiniMax changed the balance query API response shape, breaking the old parser. Upgrade cc-switch to v3.16.2+, or use a custom template for now.5 issues merged