Справочник по командам: Полная шпаргалка по OpenSkills

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

Уверенно использовать все 7 команд OpenSkills
Понимать назначение и применение глобальных опций
Быстро находить значения параметров и флагов команд
Использовать неинтерактивные команды в скриптах

Обзор команд

OpenSkills предоставляет 7 команд:

Команда	Назначение	Сценарии использования
`install`	Установка навыков	Установка новых навыков из GitHub, локальных путей или приватных репозиториев
`list`	Список навыков	Просмотр всех установленных навыков и их расположения
`read`	Чтение навыков	Загрузка содержимого навыков для ИИ-агента (обычно вызывается автоматически)
`update`	Обновление навыков	Обновление установленных навыков из исходного репозитория
`sync`	Синхронизация	Запись списка навыков в AGENTS.md
`manage`	Управление	Интерактивное удаление навыков
`remove`	Удаление	Удаление указанного навыка (подходит для скриптов)

Подсказка

Используйте npx openskills --help, чтобы просмотреть краткое описание всех команд.

Глобальные опции

Некоторые команды поддерживают следующие глобальные опции:

Опция	Сокращение	Назначение	Применимые команды
`--global`	`-g`	Установка в глобальный каталог `~/.claude/skills/`	`install`
`--universal`	`-u`	Установка в универсальный каталог `.agent/skills/` (многоагентная среда)	`install`
`--yes`	`-y`	Пропуск интерактивных подсказок, использование поведения по умолчанию	`install`, `sync`
`--output <path>`	`-o <path>`	Указание пути к выходному файлу	`sync`

Подробное описание команд

install — установка навыков

Устанавливает навыки из репозитория GitHub, локального пути или приватного git-репозитория.

bash

openskills install <source> [options]

Параметры:

Параметр	Обязательный	Описание
`<source>`	✅	Источник навыка (сокращённая запись GitHub, git URL или локальный путь)

Опции:

Опция	Сокращение	Значение по умолчанию	Описание
`--global`	`-g`	`false`	Установка в глобальный каталог `~/.claude/skills/`
`--universal`	`-u`	`false`	Установка в универсальный каталог `.agent/skills/`
`--yes`	`-y`	`false`	Пропуск интерактивного выбора, установка всех найденных навыков

Примеры параметра source:

bash

# Сокращённая запись GitHub (рекомендуется)
openskills install anthropics/skills

# Указание ветки
openskills install owner/repo@branch

# Приватный репозиторий
openskills install [email protected]:owner/repo.git

# Локальный путь
openskills install ./path/to/skill

# Git URL
openskills install https://github.com/owner/repo.git

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

При установке отображается список всех найденных навыков для выбора
Используйте --yes, чтобы пропустить выбор и установить все навыки
Приоритет места установки: --universal → --global → каталог проекта по умолчанию
После установки в каталоге навыка создаётся файл метаданных .openskills.json

list — список навыков

Выводит список всех установленных навыков.

bash

openskills list

Опции: нет

Формат вывода:

Available Skills:

skill-name           [description]            (project/global)

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

Сортировка по местоположению: сначала навыки проекта, затем глобальные
Внутри одного местоположения сортировка по алфавиту
Отображение имени навыка, описания и метки местоположения

read — чтение навыков

Выводит содержимое одного или нескольких навыков в стандартный вывод. Эта команда в основном используется ИИ-агентами для динамической загрузки навыков.

bash

openskills read <skill-names...>

Параметры:

Параметр	Обязательный	Описание
`<skill-names...>`	✅	Список имён навыков (поддерживается несколько, разделённых пробелом или запятой)

Опции: нет

Примеры:

bash

# Чтение одного навыка
openskills read pdf

# Чтение нескольких навыков
openskills read pdf git

# Разделение запятыми (также поддерживается)
openskills read "pdf,git,excel"

Формат вывода:

Skill: pdf
Base Directory: /path/to/.claude/skills/pdf

---SKILL.md 内容---

[SKILL.END]

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

Поиск навыков по 4 каталогам в порядке приоритета
Вывод имени навыка, базового пути каталога и полного содержимого SKILL.md
Для ненайденных навыков отображается сообщение об ошибке

update — обновление навыков

Обновляет установленные навыки из записанного источника. Если не указано имя навыка, обновляются все установленные навыки.

bash

openskills update [skill-names...]

Параметры:

Параметр	Обязательный	Описание
`[skill-names...]`	❌	Список имён навыков для обновления (по умолчанию все)

Опции: нет

Примеры:

bash

# Обновление всех навыков
openskills update

# Обновление указанных навыков
openskills update pdf git

# Разделение запятыми (также поддерживается)
openskills update "pdf,git,excel"

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

Обновляются только навыки с метаданными (установленные через install)
Навыки без метаданных пропускаются с уведомлением
После успешного обновления обновляется временная метка установки
При обновлении из git-репозитория используется shallow-клон (--depth 1)

sync — синхронизация с AGENTS.md

Синхронизирует установленные навыки с файлом AGENTS.md (или другим пользовательским файлом), создавая список навыков, доступных для ИИ-агентов.

bash

openskills sync [options]

Опции:

Опция	Сокращение	Значение по умолчанию	Описание
`--output <path>`	`-o <path>`	`AGENTS.md`	Путь к выходному файлу
`--yes`	`-y`	`false`	Пропуск интерактивного выбора, синхронизация всех навыков

Примеры:

bash

# Синхронизация в файл по умолчанию
openskills sync

# Синхронизация в пользовательский файл
openskills sync -o .ruler/AGENTS.md

# Пропуск интерактивного выбора
openskills sync -y

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

Разбор существующего файла и предвыбор уже включённых навыков
При первой синхронизации по умолчанию выбираются навыки проекта
Генерация XML-формата, совместимого с Claude Code
Поддержка замены или добавления секции навыков в существующий файл

manage — управление навыками

Интерактивное удаление установленных навыков. Предоставляет дружественный интерфейс для удаления.

bash

openskills manage

Опции: нет

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

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

remove — удаление навыков

Удаление указанного установленного навыка (в виде скрипта). Удобнее, чем manage, при использовании в скриптах.

bash

openskills remove <skill-name>

Параметры:

Параметр	Обязательный	Описание
`<skill-name>`	✅	Имя навыка для удаления

Опции: нет

Примеры:

bash

openskills remove pdf

# Также можно использовать алиас
openskills rm pdf

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

Удаление всего каталога навыка (включая все файлы и подкаталоги)
Отображение местоположения и источника удаления
Вывод сообщения об ошибке и завершение при отсутствии навыка

Шпаргалка по быстрым операциям

Задача	Команда
Просмотр всех установленных навыков	`openskills list`
Установка официального навыка	`openskills install anthropics/skills`
Установка из локального пути	`openskills install ./my-skill`
Глобальная установка навыка	`openskills install owner/skill --global`
Обновление всех навыков	`openskills update`
Обновление конкретного навыка	`openskills update pdf git`
Интерактивное удаление навыка	`openskills manage`
Удаление указанного навыка	`openskills remove pdf`
Синхронизация с AGENTS.md	`openskills sync`
Пользовательский путь вывода	`openskills sync -o custom.md`

Частые проблемы и решения

1. Команда не найдена

Проблема: При выполнении команды появляется сообщение "command not found"

Причины:

Node.js не установлен или версия слишком старая (требуется 20.6+)
Не используется npx или глобальная установка

Решение:

bash

# Использование npx (рекомендуется)
npx openskills list

# Или глобальная установка
npm install -g openskills

2. Навык не найден

Проблема: openskills read skill-name выводит "Skill not found"

Причины:

Навык не установлен
Неправильное написание имени навыка
Навык установлен не в каталоге поиска

Решение:

bash

# Проверка установленных навыков
openskills list

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

3. Ошибка обновления

Проблема: openskills update выводит "No metadata found"

Причины:

Навык установлен не через команду install
Файл метаданных .openskills.json был удалён

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

bash

openskills install <original-source>

Краткое резюме урока

OpenSkills предоставляет полный интерфейс командной строки, охватывающий установку, список, чтение, обновление, синхронизацию и управление навыками. Освоение этих команд — основа эффективного использования OpenSkills:

install — установка новых навыков (поддержка GitHub, локальных путей, приватных репозиториев)
list — просмотр установленных навыков
read — чтение содержимого навыков (используется ИИ-агентами)
update — обновление установленных навыков
sync — синхронизация с AGENTS.md
manage — интерактивное удаление навыков
remove — удаление указанного навыка

Запомните назначение глобальных опций:

--global / --universal — управление местом установки
--yes — пропуск интерактивных подсказок (удобно для CI/CD)
--output — пользовательский путь к выходному файлу

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

В следующем уроке мы изучим Подробное описание источников установки.
Вы узнаете:
Подробное использование трёх способов установки
Сценарии применения каждого способа
Методы настройки приватных репозиториев

Справочник по командам: Полная шпаргалка по OpenSkills ​

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

Обзор команд ​

Глобальные опции ​

Подробное описание команд ​

install — установка навыков ​

list — список навыков ​

read — чтение навыков ​

update — обновление навыков ​

sync — синхронизация с AGENTS.md ​

manage — управление навыками ​

remove — удаление навыков ​

Шпаргалка по быстрым операциям ​

Частые проблемы и решения ​

1. Команда не найдена ​

2. Навык не найден ​

3. Ошибка обновления ​

Краткое резюме урока ​

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

Справочник по командам: Полная шпаргалка по OpenSkills

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

Обзор команд

Глобальные опции

Подробное описание команд

install — установка навыков

list — список навыков

read — чтение навыков

update — обновление навыков

sync — синхронизация с AGENTS.md

manage — управление навыками

remove — удаление навыков

Шпаргалка по быстрым операциям

Частые проблемы и решения

1. Команда не найдена

2. Навык не найден

3. Ошибка обновления

Краткое резюме урока

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