check-skill-conflicts

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Check Skill Conflicts

检查Skill冲突

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

识别本地Claude Code技能与插件提供的技能之间的命名冲突。

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

当某个技能同时存在于

~/.claude/skills/

（本地）和

~/.claude/plugins/

（插件）中时，Agent可能会：

加载错误的技能版本
在不同会话间得到不一致的结果
当技能名称相似时出现不可预测的行为

Quick Check

快速检查

bash

undefined

bash

undefined

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

供程序化使用的JSON输出

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

undefined

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

undefined

What It Checks

检查内容

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

完全匹配 - 两个位置存在相同的技能名称
相似名称 - 仅后缀/前缀不同的名称（例如
```
foo
```
vs
```
foo-skill
```
）
大小写差异 - 名称相同但大小写不同

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)

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:

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

Rename local skill - If both are needed but different

bash

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

当发现冲突时：

移除本地技能 - 如果偏好插件版本

bash

cd ~/.claude/skills && git rm -r <skill-name>

卸载插件 - 如果偏好本地版本
bash
```
/plugin uninstall <plugin-name>
```

重命名本地技能 - 如果两者都需要但功能不同

bash

mv ~/.claude/skills/<old-name> ~/.claude/skills/<new-name>
# 更新SKILL.md前置元数据中的name字段

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`

类型	路径模式
本地技能	`~/.claude/skills/<name>/SKILL.md`
插件技能	`~/.claude/plugins/marketplaces/*/<plugin>/skills/<name>/SKILL.md`
符号链接插件	`~/.claude/plugins/<symlink>/*/skills/<name>/SKILL.md`

Self-Test

自我测试

bash

undefined

bash

undefined

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"

undefined

undefined