Удаление навыков

Что вы сможете делать после изучения

• Использовать openskills manage для интерактивного удаления нескольких навыков
• Использовать openskills remove для скриптового удаления указанных навыков
• Понимать сценарии использования обоих способов удаления
• Подтверждать, удаляете ли вы навык из project или global местоположения
• Безопасно очищать ненужные навыки

Ваша текущая проблема

По мере увеличения количества установленных навыков вы можете столкнуться с такими проблемами:

• "Некоторые навыки мне больше не нужны, хочу удалить несколько, но удалять по одному — слишком утомительно"
• "Хочу автоматически удалять навыки в скрипте, команда manage требует интерактивного выбора"
• "Не уверен, установлен ли навык в project или global, хочу проверить перед удалением"
• "При массовом удалении навыков боюсь случайно удалить используемые"

OpenSkills предоставляет два способа удаления для решения этих проблем: интерактивный manage (подходит для ручного выбора нескольких навыков) и скриптовый remove (подходит для точного удаления одного навыка).

Когда использовать этот способ

Сценарий	Рекомендуемый способ	Команда
Ручное удаление нескольких навыков	Интерактивный выбор	openskills manage
Автоматическое удаление в скрипте или CI/CD	Точное указание имени навыка	openskills remove <name>
Быстрое удаление, когда знаете имя навыка	Прямое удаление	openskills remove <name>
Просмотр списка навыков перед удалением	Сначала список, потом удаление	openskills list → openskills manage

Основная идея

Два способа удаления OpenSkills применяются в разных сценариях:

Интерактивное удаление: openskills manage

• Характеристика: Отображает все установленные навыки и позволяет отметить те, которые нужно удалить
• Применение: Ручное управление библиотекой навыков, удаление нескольких навыков за раз
• Преимущество: Не удаляет случайно, можно заранее увидеть все варианты
• Поведение по умолчанию: Ничего не выбрано (для предотвращения случайного удаления)

Скриптовое удаление: openskills remove <name>

• Характеристика: Непосредственно удаляет указанный навык
• Применение: Скрипты, автоматизация, точное удаление
• Преимущество: Быстро, не требует взаимодействия
• Риск: При ошибке в имени навыка — ошибка, не удалит другие навыки

Принцип удаления

Оба способа удаляют весь каталог навыка (включая SKILL.md, references/, scripts/, assets/ и все остальные файлы), не оставляя следов.

Удаление необратимо

Удаление навыка удаляет весь каталог навыка без возможности восстановления. Рекомендуется перед удалением убедиться, что навык больше не нужен, или просто переустановить его.

Действуйте вместе со мной

Шаг 1: Интерактивное удаление нескольких навыков

Зачем Когда нужно удалить несколько навыков, интерактивный выбор безопаснее и нагляднее

Выполните команду:

npx openskills manage

Вы должны увидеть

Сначала отобразится список всех установленных навыков (отсортированных по project/global):

? Select skills to remove:
❯◯ pdf                         (project)
 ◯ code-analyzer                (project)
 ◯ email-reader                 (global)
 ◯ git-tools                    (global)

• Синий (project): навыки уровня проекта
• Серый (global): глобальные навыки
• Пробел: отметить/снять отметку
• Enter: подтвердить удаление

Предположим, вы отметили pdf и git-tools, затем нажали Enter:

Вы должны увидеть

✅ Removed: pdf (project)
✅ Removed: git-tools (global)

✅ Removed 2 skill(s)

По умолчанию ничего не выбрано

Команда manage по умолчанию ничего не выбирает, это сделано для предотвращения случайного удаления. Вам нужно использовать пробел для ручного выбора навыков для удаления.

Шаг 2: Скриптовое удаление одного навыка

Зачем Когда знаете имя навыка и хотите быстро его удалить

Выполните команду:

npx openskills remove pdf

Вы должны увидеть

✅ Removed: pdf
   From: project (/Users/yourname/project/.claude/skills/pdf)

Если навык не существует:

Error: Skill 'pdf' not found

Программа завершится с кодом ошибки 1 (подходит для проверки в скриптах).

Шаг 3: Подтверждение местоположения удаления

Зачем Перед удалением подтвердить местоположение навыка (project vs global), чтобы избежать случайного удаления

При удалении навыка команда отображает местоположение удаления:

# Скриптовое удаление показывает подробное местоположение
npx openskills remove pdf
✅ Removed: pdf
   From: project (/Users/yourname/project/.claude/skills/pdf)

# Интерактивное удаление также показывает местоположение каждого навыка
npx openskills manage
# Выбор и подтверждение
✅ Removed: pdf (project)
✅ Removed: git-tools (global)

Правила определения:

• Если путь содержит текущий каталог проекта → (project)
• Если путь содержит домашний каталог → (global)

Шаг 4: Проверка после удаления

Зачем Подтвердить успешное удаление, чтобы ничего не упустить

После удаления навыка используйте команду list для проверки:

npx openskills list

Вы должны увидеть

Удалённые навыки больше не отображаются в списке.

Контрольный пункт ✅

Подтвердите следующее:

• [ ] Выполнение openskills manage показывает список всех навыков
• [ ] Можно использовать пробел для выбора/снятия выбора навыков
• [ ] По умолчанию ничего не выбрано (предотвращение случайного удаления)
• [ ] Выполнение openskills remove <name> удаляет указанный навык
• [ ] При удалении отображается, это project или global местоположение
• [ ] После удаления с помощью openskills list подтверждается исчезновение навыка

Возможные проблемы

Проблема 1: Случайное удаление используемого навыка

Проявление: После удаления обнаруживается, что навык всё ещё нужен

Решение:

Переустановите навык:

# Если устанавливали с GitHub
npx openskills install anthropics/skills

# Если устанавливали с локального пути
npx openskills install ./path/to/skill

OpenSkills записывает источник установки (в файле .openskills.json), при переустановке информация об исходном пути не теряется.

Проблема 2: Команда manage показывает "No skills installed"

Проявление: Выполнение openskills manage сообщает, что навыки не установлены

Причина: В текущем каталоге действительно нет навыков

Шаги по устранению:

1. Проверьте, находитесь ли вы в правильном каталоге проекта
2. Подтвердите, установлены ли глобальные навыки (openskills list --global)
3. Перейдите в каталог с установленными навыками и попробуйте снова

# Перейдите в каталог проекта
cd /path/to/your/project

# Попробуйте снова
npx openskills manage

Проблема 3: Команда remove выдаёт ошибку "Skill not found"

Проявление: Выполнение openskills remove <name> сообщает, что навык не найден

Причина: Ошибка в написании имени навыка или навык уже удалён

Шаги по устранению:

1. Сначала проверьте правильное имя навыка с помощью команды list:

npx openskills list

2. Проверьте написание имени навыка (обратите внимание на регистр и дефисы)

3. Подтвердите, является ли навык project или global (ищите в разных каталогах)

# Просмотр навыков проекта
ls -la .claude/skills/

# Просмотр глобальных навыков
ls -la ~/.claude/skills/

Проблема 4: После удаления навык всё ещё в AGENTS.md

Проявление: После удаления навыка в AGENTS.md всё ещё есть ссылка на него

Причина: Удаление навыка не обновляет AGENTS.md автоматически

Решение:

Выполните команду sync повторно:

npx openskills sync

Команда sync заново сканирует установленные навыки и обновляет AGENTS.md, удалённые навыки автоматически исключаются из списка.

Резюме урока

OpenSkills предоставляет два способа удаления навыков:

Интерактивное удаление: openskills manage

• 🎯 Сценарий использования: Ручное управление библиотекой навыков, удаление нескольких навыков
• ✅ Преимущество: Наглядно, без случайного удаления, с предварительным просмотром
• ⚠️ Примечание: По умолчанию ничего не выбрано, требуется ручной выбор

Скриптовое удаление: openskills remove <name>

• 🎯 Сценарий использования: Скрипты, автоматизация, точное удаление
• ✅ Преимущество: Быстро, без необходимости взаимодействия
• ⚠️ Примечание: Ошибка в написании имени навыка вызовет ошибку

Ключевые моменты:

1. Оба способа удаляют весь каталог навыка (невозможно восстановить)
2. При удалении отображается, это project или global местоположение
3. После удаления используйте openskills list для проверки
4. Не забудьте выполнить openskills sync повторно для обновления AGENTS.md

Анонс следующего урока

В следующем уроке мы изучим Режим Universal: мультиагентная среда.

Вы узнаете:

• Как использовать флаг --universal для избежания конфликтов с Claude Code
• Единое управление навыками в мультиагентной среде
• Роль каталога .agent/skills

---

Приложение: Справочник по исходному коду

Нажмите, чтобы развернуть и посмотреть расположение исходного кода

Обновлено: 2026-01-24

Функция	Путь к файлу	Номера строк
Реализация команды manage	src/commands/manage.ts	10-62
Реализация команды remove	src/commands/remove.ts	8-21
Поиск всех навыков	src/utils/skills.ts	30-64
Поиск указанного навыка	src/utils/skills.ts	66-90

Ключевые функции:

• manageSkills(): Интерактивное удаление навыков с использованием inquirer checkbox для выбора пользователем
• removeSkill(skillName): Скриптовое удаление указанного навыка, выход с ошибкой, если не найден
• findAllSkills(): Обход 4 каталогов поиска, сбор всех навыков
• findSkill(skillName): Поиск указанного навыка, возврат объекта Skill

Ключевые константы:

• Нет (все пути и конфигурации вычисляются динамически)

Основная логика:

1. Команда manage (src/commands/manage.ts):

   • Вызов findAllSkills() для получения всех навыков (строка 11)
   • Сортировка по project/global (строки 20-25)
   • Использование inquirer checkbox для выбора пользователем (строки 33-37)
   • По умолчанию checked: false, ничего не выбрано (строка 30)
   • Обход выбранных навыков, вызов rmSync для удаления (строки 45-52)

2. Команда remove (src/commands/remove.ts):

   • Вызов findSkill(skillName) для поиска навыка (строка 9)
   • Если не найден, вывод ошибки и process.exit(1) (строки 12-14)
   • Вызов rmSync для удаления всего каталога навыка (строка 16)
   • Определение project или global через homedir() (строка 18)

3. Операция удаления:

   • Использование rmSync(baseDir, { recursive: true, force: true }) для удаления всего каталога навыка
   • recursive: true: рекурсивное удаление всех дочерних файлов и каталогов
   • force: true: игнорирование ошибки "файл не существует"