Установка инструментов OpenSkills

Чему вы научитесь

После завершения этого урока вы сможете:

• Проверить и настроить окружение Node.js и Git
• Использовать OpenSkills через npx или глобальную установку
• Проверить правильность установки и доступность OpenSkills
• Решать распространенные проблемы установки (несовместимость версий, проблемы с сетью и т. д.)

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

Вы можете столкнуться с такими проблемами:

• Неопределенные требования к окружению: не знаете, какие версии Node.js и Git необходимы
• Не знаете, как установить: OpenSkills — это npm-пакет, но неясно, использовать npx или глобальную установку
• Ошибка установки: проблемы с несовместимостью версий или сетью
• Проблемы с правами доступа: при глобальной установке возникает ошибка EACCES

Этот урок поможет вам шаг за шагом решить эти проблемы.

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

Когда вам нужно:

• Впервые использовать OpenSkills
• Обновиться до новой версии
• Настроить окружение разработки на новом компьютере
• Решить проблемы, связанные с установкой

🎒 Подготовка перед началом

Системные требования

OpenSkills предъявляет минимальные требования к системе. Несоответствие этим требованиям приведет к ошибкам установки или нарушению работы.

Предварительная проверка

Перед началом убедитесь, что установлено следующее программное обеспечение:

1. Node.js версии 20.6 или выше
2. Git (для клонирования навыков из репозитория)

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

OpenSkills — это инструмент CLI для Node.js, доступный двумя способами:

Способ	Команда	Преимущества	Недостатки	Сценарий использования
npx	npx openskills	Без установки, автоматическое использование последней версии	При каждом запуске требуется загрузка (есть кеш)	Редкое использование, тестирование новой версии
Глобальная установка	openskills	Короткая команда, более быстрый отклик	Требуется ручное обновление	Частое использование, фиксированная версия

Рекомендуется использовать npx, если только вы очень часто не используете OpenSkills.

---

Следуйте за мной

Шаг 1: Проверка версии Node.js

Сначала проверьте, установлен ли Node.js в системе и соответствует ли версия требованиям:

node --version

Почему

OpenSkills требует Node.js версии 20.6 или выше, ниже этой версии возникнут ошибки во время выполнения.

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

v20.6.0

Или более поздняя версия (например, v22.0.0).

Слишком низкая версия

Если вы видите v18.x.x или более низкую версию (например, v16.x.x), вам нужно обновить Node.js.

Если версия слишком низкая:

Рекомендуется использовать nvm (Node Version Manager) для установки и управления Node.js:

macOS/Linux

# Установка nvm (если не установлен)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Перезагрузка конфигурации терминала
source ~/.bashrc  # или source ~/.zshrc

# Установка Node.js 20 LTS
nvm install 20
nvm use 20

# Проверка версии
node --version

Windows

# Скачать и установить nvm-windows
# Посетите: https://github.com/coreybutler/nvm-windows/releases

# После установки выполните в PowerShell:
nvm install 20
nvm use 20

# Проверка версии
node --version

Что вы должны увидеть (после обновления):

v20.6.0

---

Шаг 2: Проверка установки Git

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

git --version

Почему

При установке навыков из GitHub OpenSkills использует команду git clone для загрузки репозитория.

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

git version 2.40.0

(Номер версии может отличаться, главное — наличие вывода)

Git не установлен

Если вы видите command not found: git или аналогичную ошибку, вам нужно установить Git.

Если Git не установлен:

macOS

# В macOS обычно Git уже установлен, если нет, используйте Homebrew:
brew install git

Windows

# Скачать и установить Git for Windows
# Посетите: https://git-scm.com/download/win

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install git

Linux (CentOS/RHEL)

sudo yum install git

После установки снова выполните git --version для проверки.

---

Шаг 3: Проверка окружения

Теперь проверьте доступность Node.js и Git:

node --version && git --version

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

v20.6.0
git version 2.40.0

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

---

Шаг 4: Использование npx (рекомендуется)

OpenSkills рекомендуется запускать напрямую через npx, без дополнительной установки:

npx openskills --version

Почему

npx автоматически загрузит и запустит последнюю версию OpenSkills, без необходимости ручной установки или обновления. При первом запуске пакет будет загружен в локальный кеш, при последующих запусках будет использоваться кеш, что очень быстро.

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

1.5.0

(Номер версии может отличаться)

Принцип работы npx

npx (Node Package eXecute) — это встроенный инструмент npm 5.2.0+:

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

Тестовая команда установки:

npx openskills list

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

Installed Skills:

No skills installed. Run: npx openskills install <source>

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

---

Шаг 5: (необязательно) Глобальная установка

Если вы часто используете OpenSkills, можно выбрать глобальную установку:

npm install -g openskills

Почему

После глобальной установки можно напрямую использовать команду openskills, не вводя npx каждый раз, отклик быстрее.

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

added 4 packages in 3s

(Вывод может отличаться)

Проблемы с правами доступа

Если при глобальной установке возникла ошибка EACCES, это означает отсутствие прав на запись в глобальный каталог.

Решение:

# Способ 1: использование sudo (macOS/Linux)
sudo npm install -g openskills

# Способ 2: исправление прав npm (рекомендуется)
# Просмотр каталога глобальной установки
npm config get prefix

# Настройка правильных прав (замените /usr/local на фактический путь)
sudo chown -R $(whoami) /usr/local/lib/node_modules
sudo chown -R $(whoami) /usr/local/bin

Проверка глобальной установки:

openskills --version

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

1.5.0

Обновление глобальной установки

Для обновления глобально установленного OpenSkills:

npm update -g openskills

---

Контрольная точка ✅

После выполнения вышеуказанных шагов вы должны убедиться:

• [ ] Версия Node.js — 20.6 или выше (node --version)
• [ ] Git установлен (git --version)
• [ ] npx openskills --version или openskills --version корректно выводит номер версии
• [ ] npx openskills list или openskills list работает нормально

Если все проверки пройдены, поздравляем! OpenSkills успешно установлен.

---

Предупреждение о проблемах

Проблема 1: Слишком низкая версия Node.js

Сообщение об ошибке:

Error: The module was compiled against a different Node.js version

Причина: версия Node.js ниже 20.6

Решение:

Используйте nvm для установки Node.js версии 20 или выше:

nvm install 20
nvm use 20

---

Проблема 2: Команда npx не найдена

Сообщение об ошибке:

command not found: npx

Причина: слишком низкая версия npm (npx требует npm 5.2.0+)

Решение:

# Обновление npm
npm install -g npm@latest

# Проверка версии
npx --version

---

Проблема 3: Таймаут сети или сбой загрузки

Сообщение об ошибке:

Error: network timeout

Причина: ограничен доступ к репозиторию npm

Решение:

# Использование зеркала npm (например, Taobao)
npm config set registry https://registry.npmmirror.com

# Повторная попытка
npx openskills --version

Восстановление источника по умолчанию:

npm config set registry https://registry.npmjs.org

---

Проблема 4: Ошибка прав доступа при глобальной установке

Сообщение об ошибке:

Error: EACCES: permission denied

Причина: отсутствие прав на запись в каталог глобальной установки

Решение:

См. способ исправления прав в «Шаге 5» или использование sudo (не рекомендуется).

---

Проблема 5: Сбой клонирования Git

Сообщение об ошибке:

Error: git clone failed

Причина: не настроен SSH-ключ или проблемы с сетью

Решение:

# Проверка подключения Git
git ls-remote https://github.com/numman-ali/openskills.git

# Если не удается, проверьте сеть или настройте прокси
git config --global http.proxy http://proxy.example.com:8080

---

Итог урока

В этом уроке мы изучили:

1. Требования к окружению: Node.js 20.6+ и Git
2. Рекомендуемый способ использования: npx openskills (без установки)
3. Необязательная глобальная установка: npm install -g openskills (при частом использовании)
4. Проверка окружения: проверка номеров версий и доступности команд
5. Распространенные проблемы: несовместимость версий, проблемы с правами, сетевые проблемы

Теперь вы завершили установку OpenSkills, в следующем уроке мы узнаем, как установить первый навык.

---

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

В следующем уроке мы изучим Установка первого навыка

Вы узнаете:

• Как установить навыки из официального репозитория Anthropic
• Техники интерактивного выбора навыков
• Структура каталога навыков
• Проверка правильности установки навыка

---

Приложение: ссылка на исходный код

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

Время обновления: 2026-01-24

Основная конфигурация

Параметр	Путь к файлу	Строка
Требование к версии Node.js	package.json	45-47
Информация о пакете	package.json	1-9
Точка входа CLI	src/cli.ts	39-80

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

• Требование Node.js: >=20.6.0 (package.json:46)
• Имя пакета: openskills (package.json:2)
• Версия: 1.5.0 (package.json:3)
• Команда CLI: openskills (package.json:8)

Описание зависимостей

Зависимости времени выполнения (package.json:48-53):

• @inquirer/prompts: интерактивный выбор
• chalk: цветной вывод в терминал
• commander: разбор аргументов CLI
• ora: анимация загрузки

Зависимости разработки (package.json:54-59):

• typescript: компиляция TypeScript
• vitest: модульное тестирование
• tsup: инструмент сборки