docs/user-manual/en/3-extensions/3.3-skills.md
Skills are reusable capability extensions that give AI tools specialized abilities in specific domains.
Skills exist as folders containing:
Skills are supported across all four applications:
Click the Skills button in the top navigation bar.
Note: The Skills button is visible in all app modes.
CC Switch comes pre-configured with the following GitHub repositories:
| Repository | Description |
|---|---|
| Anthropic Official | Official skills provided by Anthropic |
| ComposioHQ | Community-maintained skill collection |
| Community Picks | Curated high-quality skills |
CC Switch provides powerful search and filter features:
Use the dropdown menu to filter by installation status:
| Option | Description |
|---|---|
| All | Show all skills |
| Installed | Show only installed skills |
| Not Installed | Show only uninstalled skills |
Search and filter can be combined:
Click the "Refresh" button to re-scan repositories for the latest skills.
| Application | Install Directory |
|---|---|
| Claude | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ |
| Gemini | ~/.gemini/skills/ |
| OpenCode | ~/.opencode/skills/ |
Installation copies the skill folder to your local machine:
~/.claude/skills/
└── skill-name/
├── README.md
├── prompt.md
└── tools/
└── ...
~/.cc-switch/skill-backups/~/.cc-switch/skills/)If you need to restore a previously uninstalled skill:
To remove old skill backups:
Click the "Repository Management" button at the top of the page.
https://github.com/{owner}/{name}/tree/{branch}/{subdirectory}
Example:
Owner: anthropics
Name: claude-skills
Branch: main
Subdirectory: skills
After deleting a repository, its skills will not disappear from the list, but they can no longer be updated.
Each skill card displays:
| Information | Description |
|---|---|
| Name | Skill name |
| Description | Function description |
| Source | Source repository |
| Status | Installed / Not Installed |
Starting from v3.13.0, Skills support automatic update detection and batch updates — no more uninstall-and-reinstall.
CC Switch compares installed skills with the remote repository version using SHA-256 content hashes. Whenever the remote has any content changes, the corresponding local skill card automatically shows an "Update available" indicator.
For a skill with an available update:
When multiple skills need updating:
Tip: Regularly click the Refresh button to trigger a remote scan so update detection stays current.
Starting from v3.13.0, the source storage location for skills can be switched between two locations:
| Location | Description |
|---|---|
| CC Switch built-in | Default location ~/.cc-switch/skills/, managed by CC Switch |
~/.agents/skills | A shared directory conforming to community agent tool conventions, better for cross-tool collaboration |
Select the target storage location from the settings or management menu in the Skills panel. The switch does not lose skill state — CC Switch smoothly migrates existing skills to the new location.
⚠️ Distinction: The "Storage Location Switch" here manages the source storage of skills. In contrast, 1.5 Personalization → Skill Sync Method controls how skills are distributed to each app's directory (symlink vs. copy). The two settings work together.
v3.13.0 integrates skills.sh public registry search so you can discover community skills directly inside CC Switch.
v3.13.0 also fixes broken link and empty description handling for skills.sh, so community skill metadata is displayed more reliably.
Possible causes:
Solutions:
Possible causes:
Solutions:
Possible causes:
Solutions: