Skip to content
CC Switch WikiUnofficial Community Wiki

Skill description still shows old content in Claude Code

Quick fix

After manually editing SKILL.md, Claude Code reads the new content, but cc-switch does not refresh the installation-time metadata snapshot in its skill list.

Symptom

Section titled “Symptom”
Error output
the description is still the old one

Cause

Section titled “Cause”

In the reported environment, after manually changing the SKILL.md frontmatter description in the skill storage directory, the file synced to ~/.claude/skills/ was updated and Claude Code loaded the new description. However, the skill list and description and content_hash in cc-switch.db retained the snapshot from installation or import. As a result, the displayed skill description can differ from the description actually in effect.

This issue is still open and does not provide a confirmed refresh mechanism or fixed version. The reporter suggested reparsing SKILL.md when starting or opening the Skills page, or warning about external changes when the disk file differs from content_hash.

Fix

Section titled “Fix”

  1. There is currently no metadata refresh procedure confirmed in the issue. After manually editing SKILL.md, use the content of the synced file actually loaded by Claude Code as the source of truth, and note that the cc-switch skill list may still show the old description.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
Version3.20.3（报告中出现问题的版本）
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 1 real issues

FAQ

Section titled “FAQ”

(No FAQ yet)

Section titled “Related problems”
Skill updates silently overwrite local changesBack up local changes before updating; the proposed fix will exclude locally modified Skills from “Update All.”1 issues mergedSkills remain as copies after automatic import, CC SwitchAutomatic import copies Skills to `~/.cc-switch/skills/` and does not delete the source directory in `~/.agents/skills/`.1 issues mergedInstalled Count Mismatch, Missing Skill Directories, Claude Code SkillsOn the Skills page, check whether the directories for installed entries still exist; remove stale records or rescan the directories before syncing.1 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.