Установка первого навыка

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

Устанавливать навыки из официального репозитория Anthropic в ваш проект
Использовать интерактивный интерфейс выбора для выбора нужных навыков
Понимать, куда устанавливаются навыки (директория .claude/skills/)
Проверять успешную установку навыков

Предварительные знания

Этот урок предполагает, что вы уже завершили установку OpenSkills. Если вы еще не установили OpenSkills, пожалуйста, сначала выполните шаги установки.

Ваша текущая ситуация

Вы только что установили OpenSkills, но:

Не знаете, где искать навыки: На GitHub много репозиториев с навыками, но непонятно, какие официальные
Не знаете, как установить навыки: Знаете, что есть команда install, но не понимаете, как ей пользоваться
Боитесь установить не туда: Опасаетесь, что навыки установятся глобально, и проект их не найдет

Эти проблемы очень распространены. Давайте решим их шаг за шагом.

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

Установка первого навыка подходит для следующих сценариев:

Первое использование OpenSkills, хотите быстро попробовать
Нужны навыки от Anthropic (обработка PDF, Git-воркфлоу и т.д.)
Хотите использовать навыки в текущем проекте, а не устанавливать глобально

Рекомендация

При первой установке рекомендуется начать с официального репозитория anthropics/skills — эти навыки качественные и проверенные.

🎒 Подготовка к началу

Перед началом убедитесь:

[ ] Завершена установка OpenSkills
[ ] Вы находитесь в директории вашего проекта
[ ] Настроен Git (для клонирования репозиториев GitHub)

Проверка предварительных условий

Если у вас еще нет директории проекта, создайте временную для практики:

bash

mkdir my-project && cd my-project

Основная идея: установка навыков из GitHub

OpenSkills поддерживает установку навыков из репозиториев GitHub. Процесс установки выглядит так:

[Указать репозиторий] → [Клонировать во временную директорию] → [Найти SKILL.md] → [Интерактивный выбор] → [Скопировать в .claude/skills/]

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

Используйте формат owner/repo для указания репозитория GitHub
Инструмент автоматически клонирует репозиторий во временную директорию
Ищет все поддиректории, содержащие SKILL.md
Через интерактивный интерфейс выбирает навыки для установки
Навыки копируются в директорию .claude/skills/ проекта

Пошаговая инструкция

Шаг 1: Перейдите в директорию проекта

Сначала перейдите в директорию вашего проекта:

bash

cd /path/to/your/project

Почему

OpenSkills по умолчанию устанавливает навыки в директорию .claude/skills/ проекта, таким образом навыки могут отслеживаться системой контроля версий и использоваться всей командой.

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

Ваша директория проекта должна содержать один из следующих элементов:

.git/ (репозиторий Git)
package.json (проект Node.js)
другие файлы проекта

Рекомендация

Даже для нового проекта рекомендуется сначала инициализировать репозиторий Git — так будет проще управлять файлами навыков.

Шаг 2: Установка навыка

Используйте следующую команду для установки навыков из официального репозитория Anthropic:

bash

npx openskills install anthropics/skills

Почему

anthropics/skills — официально поддерживаемый репозиторий навыков Anthropic, содержащий качественные примеры навыков, подходящих для первого знакомства.

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

Команда запустит интерактивный интерфейс выбора:

Installing from: anthropics/skills
Location: project (.claude/skills)
Default install is project-local (./.claude/skills). Use --global for ~/.claude/skills.

Cloning repository...
✓ Repository cloned

Found 4 skill(s)

? Select skills to install:
❯ ◉ pdf (24 KB)    Comprehensive PDF manipulation toolkit for extracting text and tables...
  ◯ git-workflow (12 KB)   Git workflow: Best practices for commits, branches, and PRs...
  ◯ check-branch-first (8 KB)    Git workflow: Always check current branch before making changes...
  ◯ skill-creator (16 KB)   Guide for creating effective skills...

<Space> выбор  <a> выбрать все  <i> инвертировать выбор  <Enter> подтвердить

Руководство по использованию:

┌─────────────────────────────────────────────────────────────┐
│  Инструкции по использованию                               │
│                                                             │
│  Шаг 1          Шаг 2           Шаг 3                       │
│  Перемещение →  Пробел для    →  Enter для подтверждения  │
│  курсора        выбора                                      │
│                                                             │
│  ○ Не выбрано        ◉ Выбрано                            │
└─────────────────────────────────────────────────────────────┘

Вы должны увидеть:
- Курсор может перемещаться вверх-вниз
- Пробел переключает состояние выбора (○ ↔ ◉)
- Enter подтверждает установку

Шаг 3: Выбор навыков

В интерактивном интерфейсе выберите навыки, которые хотите установить.

Пример:

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

? Select skills to install:
❯ ◉ pdf (24 KB)    ← выберите это
  ◯ git-workflow (12 KB)
  ◯ check-branch-first (8 KB)
  ◯ skill-creator (16 KB)

Действия:

Переместите курсор: Используйте стрелки вверх/вниз для перемещения на строку pdf
Выберите навык: Нажмите пробел, чтобы убедиться, что отображается ◉, а не ◯
Подтвердите установку: Нажмите Enter, чтобы начать установку

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

✅ Installed: pdf
   Location: /path/to/your/project/.claude/skills/pdf

Skills installed to: /path/to/your/project/.claude/skills/

Next steps:
  → Run openskills sync to generate AGENTS.md with your installed skills
  → Run openskills list to see all installed skills

Дополнительные возможности

Если вы хотите установить несколько навыков за раз:

Нажмите пробел, чтобы выбрать каждый нужный навык (несколько ◉)
Нажмите <a>, чтобы выбрать все навыки
Нажмите <i>, чтобы инвертировать текущий выбор

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

После завершения установки проверьте, успешно ли навык установлен в директорию проекта.

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

bash

ls -la .claude/skills/

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

.claude/skills/
└── pdf/
    ├── SKILL.md
    ├── .openskills.json
    ├── references/
    │   ├── pdf-extraction.md
    │   └── table-extraction.md
    └── scripts/
        └── extract-pdf.js

Описание ключевых файлов:

Файл	Назначение
`SKILL.md`	Основное содержимое и инструкции навыка
`.openskills.json`	Метаданные установки (запись источника, используется для обновлений)
`references/`	Справочные документы и подробные описания
`scripts/`	Исполняемые скрипты

Просмотр метаданных навыка:

bash

cat .claude/skills/pdf/.openskills.json

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

json

{
  "source": "anthropics/skills",
  "sourceType": "git",
  "repoUrl": "https://github.com/anthropics/skills",
  "subpath": "pdf",
  "installedAt": "2026-01-24T10:30:00.000Z"
}

Этот файл метаданных записывает информацию об источнике навыка и используется при последующих обновлениях через openskills update.

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

После выполнения описанных выше шагов подтвердите:

[ ] В командной строке отображался интерактивный интерфейс выбора
[ ] Успешно выбран хотя бы один навык (отображается ◉)
[ ] Установка успешна, отображается сообщение ✅ Installed:
[ ] Директория .claude/skills/ создана
[ ] Директория навыка содержит файл SKILL.md
[ ] Директория навыка содержит файл метаданных .openskills.json

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

Предупреждения о возможных проблемах

Проблема 1: Ошибка клонирования репозитория

Проявление:

✗ Failed to clone repository
fatal: repository 'https://github.com/anthropics/skills' not found

Причина:

Проблема с сетевым подключением
Неправильный адрес репозитория GitHub

Решение:

Проверьте сетевое подключение: ping github.com
Подтвердите правильность адреса репозитория (формат owner/repo)

Проблема 2: Нет интерактивного интерфейса выбора

Проявление:

Команда сразу установила все навыки, не отобразив интерфейс выбора.

Причина:

В репозитории только один файл SKILL.md (одно-навыковый репозиторий)
Использован флаг -y или --yes (пропуск выбора)

Решение:

Если это одно-навыковый репозиторий, это нормальное поведение
Если нужен выбор, уберите флаг -y

Проблема 3: Ошибка доступа

Проявление:

Error: EACCES: permission denied, mkdir '.claude/skills'

Причина:

Текущая директория не имеет прав на запись

Решение:

Проверьте права директории: ls -la
Используйте sudo или перейдите в директорию с правами на запись

Проблема 4: Не найден SKILL.md

Проявление:

Error: No SKILL.md files found in repository

Причина:

В репозитории нет файлов навыков в правильном формате

Решение:

Подтвердите, что это репозиторий навыков
Проверьте структуру директорий в репозитории

Краткое содержание урока

В этом уроке вы научились:

Использовать openskills install anthropics/skills для установки навыков из официального репозитория
Выбирать навыки в интерактивном интерфейсе, используя пробел для выбора, Enter для подтверждения
Устанавливать навыки в .claude/skills/, директория содержит SKILL.md и метаданные
Проверять успешную установку, проверяя структуру директорий и содержимое файлов

Ключевые команды:

Команда	Назначение
`npx openskills install anthropics/skills`	Установка навыков из официального репозитория
`ls .claude/skills/`	Просмотр установленных навыков
`cat .claude/skills/<name>/.openskills.json`	Просмотр метаданных навыка

Следующий урок

В следующем уроке мы изучим использование навыков.
Вы научитесь:
Использовать команду openskills read для чтения содержимого навыков
Понимать, как ИИ-агенты загружают навыки в контекст
Осваивать 4-уровневую систему приоритетов поиска навыков

Установка навыков — это только первый шаг, далее нужно понять, как ИИ-агенты используют эти навыки.

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

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

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

Функция	Путь к файлу	Номер строки
Точка входа команды установки	`src/commands/install.ts`	83-183
Определение места установки (project vs global)	`src/commands/install.ts`	84-92
Парсинг сокращения GitHub	`src/commands/install.ts`	131-143
Клонирование репозитория	`src/commands/install.ts`	155-169
Рекурсивный поиск навыков	`src/commands/install.ts`	358-373
Интерактивный интерфейс выбора	`src/commands/install.ts`	427-455
Копирование и установка навыков	`src/commands/install.ts`	461-486
Список официальных навыков (предупреждение о конфликтах)	`src/utils/marketplace-skills.ts`	1-25

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

installFromRepo() - Установка навыков из репозитория с поддержкой интерактивного выбора
installSpecificSkill() - Установка навыка по указанному подпути
installFromLocal() - Установка навыков из локального пути
warnIfConflict() - Проверка и предупреждение о конфликтах навыков

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

ANTHROPIC_MARKETPLACE_SKILLS - Список навыков Anthropic Marketplace, используется для предупреждений о конфликтах

Установка первого навыка ​

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

Ваша текущая ситуация ​

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

🎒 Подготовка к началу ​

Основная идея: установка навыков из GitHub ​

Пошаговая инструкция ​

Шаг 1: Перейдите в директорию проекта ​

Шаг 2: Установка навыка ​

Шаг 3: Выбор навыков ​

Шаг 4: Проверка установки ​

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

Предупреждения о возможных проблемах ​

Проблема 1: Ошибка клонирования репозитория ​

Проблема 2: Нет интерактивного интерфейса выбора ​

Проблема 3: Ошибка доступа ​

Проблема 4: Не найден SKILL.md ​

Краткое содержание урока ​

Следующий урок ​

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

Установка первого навыка

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

Ваша текущая ситуация

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

🎒 Подготовка к началу

Основная идея: установка навыков из GitHub

Пошаговая инструкция

Шаг 1: Перейдите в директорию проекта

Шаг 2: Установка навыка

Шаг 3: Выбор навыков

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

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

Предупреждения о возможных проблемах

Проблема 1: Ошибка клонирования репозитория

Проблема 2: Нет интерактивного интерфейса выбора

Проблема 3: Ошибка доступа

Проблема 4: Не найден SKILL.md

Краткое содержание урока

Следующий урок

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