check-skill-conflicts

Check Skill Conflicts

Identifies naming conflicts between local Claude Code skills and plugin-provided skills.

Why This Matters

When a skill exists in both ~/.claude/skills/ (local) and ~/.claude/plugins/ (plugin), agents may:

• Load the wrong skill version
• Get inconsistent results between sessions
• Have unpredictable behavior when skill names are similar

Quick Check

# Run conflict check
~/.claude/plugins/marketplaces/plinde-plugins/check-skill-conflicts/skills/check-skill-conflicts/scripts/check-conflicts.sh

# Verbose output (shows all skills found)
~/.claude/plugins/marketplaces/plinde-plugins/check-skill-conflicts/skills/check-skill-conflicts/scripts/check-conflicts.sh --verbose

JSON output for programmatic use

~/.claude/plugins/marketplaces/plinde-plugins/check-skill-conflicts/skills/check-skill-conflicts/scripts/check-conflicts.sh --json

## What It Checks

1. **Exact Matches** - Same skill name in both locations
2. **Similar Names** - Names that differ only by suffix/prefix (e.g., `foo` vs `foo-skill`)
3. **Case Variations** - Same name with different casing

## Output Example

SKILL CONFLICT CHECK

Local Skills: 45 found in ~/.claude/skills/ Plugin Skills: 12 found in ~/.claude/plugins/

EXACT MATCHES (High Priority): ⚠️ kyverno-version-lookup Local: ~/.claude/skills/kyverno-version-lookup/ Plugin: ~/.claude/plugins/marketplaces/plinde-plugins/kyverno-version-lookup/

SIMILAR NAMES (Review Recommended): ⚡ plugin-creator ~ plugin-dev Local: ~/.claude/skills/plugin-creator/ Plugin: ~/.claude/plugins/marketplaces/.../plugin-dev/

No conflicts: ✅ (if none found)

## Resolution Options

When conflicts are found:

1. **Remove local skill** - If plugin version is preferred
   ```bash
   cd ~/.claude/skills && git rm -r <skill-name>

1. Uninstall plugin - If local version is preferred

   /plugin uninstall <plugin-name>
   

2. Rename local skill - If both are needed but different

   mv ~/.claude/skills/<old-name> ~/.claude/skills/<new-name>
   # Update SKILL.md frontmatter name field
   

Skill Locations

Type	Path Pattern
Local Skills	~/.claude/skills/<name>/SKILL.md
Plugin Skills	~/.claude/plugins/marketplaces/*/<plugin>/skills/<name>/SKILL.md
Symlinked Plugins	~/.claude/plugins/<symlink>/*/skills/<name>/SKILL.md

Self-Test

# Verify script exists and is executable
test -x ~/.claude/plugins/marketplaces/plinde-plugins/check-skill-conflicts/skills/check-skill-conflicts/scripts/check-conflicts.sh && \
  echo "✅ check-conflicts.sh exists" || echo "❌ Script missing"

# Run a quick check
~/.claude/plugins/marketplaces/plinde-plugins/check-skill-conflicts/skills/check-skill-conflicts/scripts/check-conflicts.sh --json | jq -e '.local_count >= 0' > /dev/null && \
  echo "✅ Script runs successfully" || echo "❌ Script failed"