CC-Switch/docs/user-manual/en/3-extensions/3.3-skills.md

3.3 Skills Management

Overview

Skills are reusable capability extensions that give AI tools specialized abilities in specific domains.

Skills exist as folders containing:

• Prompt templates
• Tool definitions
• Example code

Supported Applications

Skills are supported across all four applications:

• Claude Code
• Codex
• Gemini CLI
• OpenCode

Open the Skills Page

Click the Skills button in the top navigation bar.

Note: The Skills button is visible in all app modes.

Page Overview

Discover Skills

Pre-configured Repositories

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

Search & Filter

CC Switch provides powerful search and filter features:

Search Box

• Search by skill name
• Search by skill description
• Search by directory name
• Real-time filtering, results update as you type

Status Filter

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

Combined Use

Search and filter can be combined:

• Select "Installed" filter first
• Then enter keywords to search
• Results show the match count

Refresh List

Click the "Refresh" button to re-scan repositories for the latest skills.

Install Skills

Steps

1. Find the skill card you want to install
2. Click the "Install" button
3. Wait for installation to complete

Installation Location

Application	Install Directory
Claude	~/.claude/skills/
Codex	~/.codex/skills/
Gemini	~/.gemini/skills/
OpenCode	~/.opencode/skills/

Installation Contents

Installation copies the skill folder to your local machine:

~/.claude/skills/
└── skill-name/
    ├── README.md
    ├── prompt.md
    └── tools/
        └── ...

Uninstall Skills

Steps

1. Find the installed skill card
2. Click the "Uninstall" button
3. Confirm uninstallation

Uninstall Effect

• Automatic backup: Before deletion, the skill is backed up to ~/.cc-switch/skill-backups/
• Removes the skill from all app directories (Claude, Codex, Gemini, OpenCode)
• Removes the skill from the SSOT directory (~/.cc-switch/skills/)
• Deletes the skill record from the database

Restore from Backup

If you need to restore a previously uninstalled skill:

1. Open the Skills page
2. Click the Restore from Backup button
3. Select the backup you want to restore from the list (shows skill name and backup date)
4. The skill is restored and enabled for the current app

Delete Backups

To remove old skill backups:

1. In the restore dialog, find the backup you want to remove
2. Click the Delete button next to the backup entry
3. Confirm deletion — this cannot be undone

Repository Management

Open Repository Management

Click the "Repository Management" button at the top of the page.

Add Custom Repository

1. Click "Add Repository"
2. Fill in repository information:
   • Owner: GitHub username or organization name
   • Name: Repository name
   • Branch: Branch name (default: main)
   • Subdirectory: Subdirectory containing skills (optional)
3. Click "Add"

Repository Format

https://github.com/{owner}/{name}/tree/{branch}/{subdirectory}

Example:

Owner: anthropics
Name: claude-skills
Branch: main
Subdirectory: skills

Delete Repository

1. Find the repository in the repository list
2. Click the "Delete" button
3. Confirm deletion

After deleting a repository, its skills will not disappear from the list, but they can no longer be updated.

Skill Card Information

Each skill card displays:

Information	Description
Name	Skill name
Description	Function description
Source	Source repository
Status	Installed / Not Installed

Skill Updates

Automatic updates are not currently supported. To update a skill:

1. Uninstall the existing skill
2. Refresh the list
3. Reinstall

Empty Skill List

Possible causes:

• Network issues preventing GitHub access
• Incorrect repository configuration

Solutions:

• Check network connection
• Click "Refresh" to retry
• Verify repository configuration

Installation Failed

Possible causes:

• Network issues
• Insufficient disk space
• Permission issues

Solutions:

• Check network connection
• Check disk space
• Check directory permissions