Files
cc-switch/docs/user-manual/en/3-extensions/3.3-skills.md
Jason bbed2a1fe1 docs: restructure user manual for i18n and add EN/JA translations
Reorganize docs/user-manual/ from flat structure to language subdirectories
(zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/,
fix image paths, add multilingual navigation README, and translate all 23
markdown files (~4500 lines each) to English and Japanese.
2026-03-03 08:40:52 +08:00

4.2 KiB

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

image-20260108010253926

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

image-20260108010308060

Search & Filter

CC Switch provides powerful search and filter features:

  • 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

image-20260108010324583

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

  • Deletes the local skill folder
  • Updates installation status

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