Back to Skills

check-skill-conflicts

verified

This skill should be used when checking for naming conflicts between local skills (~/.claude/skills) and plugin-provided skills (~/.claude/plugins). Use to identify duplicate or similarly named skills that may cause inconsistent agent behavior.

View on GitHub

Marketplace

plinde-plugins

plinde/claude-plugins

Plugin

check-skill-conflicts

development

Repository

plinde/claude-plugins
4stars

check-skill-conflicts/skills/check-skill-conflicts/SKILL.md

Last Verified

January 14, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/plinde/claude-plugins/blob/main/check-skill-conflicts/skills/check-skill-conflicts/SKILL.md -a claude-code --skill check-skill-conflicts

Installation paths:

Claude
.claude/skills/check-skill-conflicts/
Powered by add-skill CLI

Instructions

# 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

```bash
# 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>
   ```

2. **Uninstall plugin** - If local version is preferred
   ```bash
   /plugin uninstall <plugin-name>
   ```

3. **Rename local

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2887 chars