New: Credits are here. One balance for web and MCP. See pricing

    Tutorials
    claude code
    skill.md
    uninstall

    How to Uninstall Claude Code Skills: Remove & Manage

    Remove SKILL.md skills from Claude Code — personal skills, project skills, and disabling without deleting.

    May 17, 20263 min read
    Share:

    Uninstalling a skill means removing its folder from your skills directory. There's no package manager, no uninstall command — just delete the folder.

    Quick Answer: Uninstall Claude Code skills by deleting the skill's folder from either ~/.claude/skills/ for personal skills or .claude/skills/ for project skills. For project skills, commit the removal to git. To disable without deleting, rename the SKILL.md file.

    Remove a personal skill

    rm -rf ~/.claude/skills/skill-name/
    

    Start a new Claude Code session. The skill is gone.

    Recommended skills

    Remove a project skill

    rm -rf .claude/skills/skill-name/
    git add .claude/skills/
    git commit -m "Remove skill-name skill"
    

    The skill is removed for everyone on the team after they pull.

    Disable without deleting

    If you want to keep a skill's files but stop Claude Code from loading it, rename the SKILL.md file:

    mv ~/.claude/skills/skill-name/SKILL.md ~/.claude/skills/skill-name/SKILL.md.disabled
    

    Claude Code only recognizes files named exactly SKILL.md. Renaming it to anything else disables the skill without losing the file. Rename it back to re-enable.

    Troubleshooting removal

    If you deleted a skill but Claude Code still seems to use it:

    1. Start a new session. Claude Code loads skills at startup. Deleting a skill mid-session doesn't take effect until the next session.
    2. Check both directories. The skill might exist in both personal (~/.claude/skills/) and project (.claude/skills/) directories. Remove from both.
    3. Ask Claude. Say "What skills do you have access to?" and check if the skill is still listed.

    When to uninstall

    • Conflicting skills: Two skills covering the same task can confuse Claude. Remove the less useful one.
    • Outdated skills: A skill that references deprecated APIs or old patterns does more harm than good.
    • Performance: Each skill adds context that Claude reads at startup. Having 50 skills installed means Claude processes 50 descriptions to decide which ones apply. If you notice slower responses, remove skills you don't actively use.

    Find better replacements at Agensi.

    Frequently Asked Questions