К основному содержанию
команда CX Codex

install-skill — команда для Claude Code: установка скиллов и агентов

Команда install-skill печатает пошаговую инструкцию, как поставить сгенерированный скилл или агент Claude на место, и предлагает выбрать способ установки.

MIT ★ 907 обновлён 2025-11-12

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/install-skill.md
Открыть на GitHub

Что делает install-skill

Команда берёт путь к готовому скиллу или агенту и выдаёт инструкцию по установке. Тип определяется по пути: если в нём есть skills, получаете три варианта: перетащить ZIP в Claude Desktop, скопировать папку в ~/.claude/skills/ или импортировать через skill-creator в браузере. Если agents — два: оставить файл в .claude/agents/ для текущего проекта или скопировать в ~/.claude/agents/, чтобы агент был во всех проектах.

Дальше идёт проверка: ls по каталогу, head -10 по SKILL.md, а для агентов — /agents в Claude, где имя должно появиться в списке. Если агент не вызывается сам, смотрите описание в его файле: оно должно быть достаточно конкретным.

Сначала стоит прогнать /validate-output: невалидный YAML во frontmatter — и скилл не загрузится после перезапуска. Для ZIP-варианта нужен zip в системе, чтобы пересобрать повреждённый архив.

Какие задачи решает

  • скопировать готовый скилл в ~/.claude/skills/ без ошибок в пути
  • решить, куда класть агента: в проект или в домашний каталог
  • проверить, что скилл подхватился после перезапуска
  • пересобрать битый ZIP для импорта в Claude Desktop
  • разобраться, почему агент не вызывается сам

Примеры запросов агенту

  • /install-skill generated-skills/healthcare-analyzer — установи во все проекты и покажи команды
  • /install-skill .claude/agents/code-reviewer — что выбрать: проект или user-level?
  • /install-skill generated-skills/my-skill — проведи по шагам и проверь, что встало

Как установить install-skill

Вручную: положить файлы

.claude/commands/install-skill.md

Вызов — /install-skill. Для всех проектов — ~/.claude/commands/

Вопросы об install-skill

Как установить install-skill в Claude Code?

Скопируйте файл команды по пути .claude/commands/install-skill.md в проекте и перезапустите Claude. После этого она доступна как /install-skill.

Что делает install-skill?

Показывает, куда положить сгенерированный скилл или агент, и предлагает варианты: Claude Desktop с ZIP, каталог ~/.claude/skills/ или .claude/agents/.

Чем установка скилла отличается от установки агента?

Скилл — это папка с SKILL.md, её копируют в ~/.claude/skills/ или импортируют архивом. Агент — один .md-файл в .claude/agents/ либо ~/.claude/agents/.

Исходный текст

install-skill.md · MIT
# /install-skill - Install Generated Skills or Agents

**Step-by-step guide to install your generated skills and agents to the correct locations.**

---

## Usage

```
/install-skill [path-to-skill]
/install-skill [path-to-agent]
```

---

## What This Command Does

Provides step-by-step installation instructions for:
- **Claude Skills** → `~/.claude/skills/` or Claude Desktop import
- **Claude Agents** → `.claude/agents/` (project) or `~/.claude/agents/` (user-level)

Shows multiple installation methods and helps choose the best one.

---

## Install a Skill

```
/install-skill generated-skills/my-skill
```

**Output**:
```
Installing: my-skill

You have 3 installation options:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Option 1: Claude Desktop (Easiest)

1. Locate ZIP file:
   generated-skills/my-skill.zip

2. Open Claude Desktop app

3. Drag and drop the ZIP file into Claude

4. Skill will load automatically!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Option 2: Claude Code (User-level)

Available across ALL your Claude Code projects:

```bash
# Copy skill folder
cp -r generated-skills/my-skill ~/.claude/skills/

# Verify installation
ls ~/.claude/skills/my-skill/

# Restart Claude Code (if currently running)
```

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Option 3: Claude Apps (Browser)

1. Go to Claude.ai
2. Enable Skills (Settings → Features)
3. Use the "skill-creator" skill
4. Import the ZIP file

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Which option? (1, 2, or 3): ___
```

**After user chooses**, provide detailed steps for that option.

---

## Install an Agent

```
/install-skill .claude/agents/my-agent
```

(Note: Works for both skills and agents despite command name)

**Output**:
```
Installing: my-agent.md (Claude Code Agent)

You have 2 installation options:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Option 1: Project-level (This project only)

Available only in the claude-code-skills-factory project:

```bash
# File already in correct location!
.claude/agents/my-agent.md

# Restart Claude Code to load
# Agent will auto-invoke when relevant tasks detected
```

✅ Recommended if: Agent is specific to this factory project

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Option 2: User-level (All projects)

Available across ALL your Claude Code projects:

```bash
# Copy to user-level location
cp .claude/agents/my-agent.md ~/.claude/agents/

# Verify installation
ls ~/.claude/agents/my-agent.md

# Restart Claude Code
```

✅ Recommended if: Agent is useful across multiple projects

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Which option? (1 or 2): ___
```

---

## Automatic Detection

**If path contains "skills"**:
→ Provides skill installation instructions (3 options)

**If path contains "agents"**:
→ Provides agent installation instructions (2 options)

**If unclear**:
```
What type of output are you installing?

1. Claude Skill (folder with SKILL.md, goes to ~/.claude/skills/)
2. Claude Agent (single .md file, goes to .claude/agents/ or ~/.claude/agents/)

Your choice: ___
```

---

## Verification Steps

**After installation**, the command helps verify:

**For Skills**:
```bash
# Check skill installed
ls ~/.claude/skills/my-skill/

# Verify SKILL.md
head -10 ~/.claude/skills/my-skill/SKILL.md

# In Claude Desktop: Skills menu should show "my-skill"
```

**For Agents**:
```bash
# Check agent installed
ls .claude/agents/my-agent.md
# or
ls ~/.claude/agents/my-agent.md

# In Claude Code: Run /agents
# Should list "my-agent" in available agents
```

---

## Common Installation Paths

**Claude Skills**:
- User-level: `~/.claude/skills/[skill-name]/`
- Desktop: Import ZIP via drag-and-drop
- Browser: Use skill-creator

**Claude Agents**:
- Project-level: `.claude/agents/[agent-name].md`
- User-level: `~/.claude/agents/[agent-name].md`

---

## Examples

### After Building a Healthcare Skill

```
# 1. Build
/build skill
[Answer questions about healthcare data analysis]
[Skill generated: generated-skills/healthcare-analyzer/]

# 2. Validate
/validate-output skill generated-skills/healthcare-analyzer
✅ Validation passed

# 3. Install
/install-skill generated-skills/healthcare-analyzer
Choose Option 2 (Claude Code user-level)
[Follow provided commands]

# 4. Verify
ls ~/.claude/skills/healthcare-analyzer/
✅ Installed
```

### After Building a Code Reviewer Agent

```
# 1. Build
/build agent
[Answer questions about code review]
[Agent generated: .claude/agents/code-reviewer.md]

# 2. Validate
/validate-agent .claude/agents/code-reviewer
✅ Validation passed

# 3. Install
/install-skill .claude/agents/code-reviewer
Choose Option 1 (Project-level, already in place)
[Just restart Claude Code]

# 4. Verify
/agents
✅ "code-reviewer" listed
```

---

## Troubleshooting

**"Skill not loading after installation"**:
- Restart Claude Code or Claude Desktop
- Check file is in correct location
- Verify YAML frontmatter is valid (/validate-output first)

**"Agent not auto-invoking"**:
- Check /agents to see if it's listed
- Verify description is specific enough
- Try manual invocation: "Use the [agent-name] agent to..."

**"ZIP import failing"**:
- Verify ZIP file exists and isn't corrupted
- Re-create ZIP if needed:
  ```bash
  cd generated-skills
  zip -r my-skill.zip my-skill/
  ```

---

## Tips

**Before Installing**:
- ✅ Always run /validate-output first
- ✅ Fix any validation errors
- ✅ Test locally if possible

**After Installing**:
- ✅ Restart Claude Code/Desktop
- ✅ Test with simple invocation
- ✅ Share with team (if useful)

**For Skills**:
- Desktop: Easiest (drag-and-drop)
- Code: Most flexible (edit files directly)
- Browser: Good for quick sharing

**For Agents**:
- Project-level: If agent is project-specific
- User-level: If agent is useful everywhere

---

## Related Commands

- `/build` - Generate skills/prompts/agents first
- `/validate-output` - Validate before installing
- `/test-factory` - Test after installing
- `/factory-status` - See installation status

---

**Make installation easy and error-free!** 📦

© alirezarezvani · MIT · alirezarezvani/claude-code-skill-factory

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
earth2studio-install NVIDIA Earth-2 Team Скилл earth2studio-install для Claude Code помогает установить Earth2Studio и выбрать дополнительные зависимости для нужных моделей. Он включается при настройке Python-окружения и проверяет установку. CX Codex +1 1 900установок pipefy-toolkit-setup pipefy Скилл pipefy-toolkit-setup для Claude Code пошагово настраивает подключение к Pipefy AI toolkit: помогает выбрать вариант интеграции и пройти авторизацию. CX Codex +1 717установок c-apps daxaur Даёт им команды mas для управления приложениями Mac App Store. Поиск, установка, обновление и просмотр информации об приложениях — прямо из терминала. CX Codex +1 ★ 179звёзд репо install-anti-slop dmmulroy Скилл install-anti-slop разворачивает в репозитории вендорные плагины Oxlint против антипаттернов кода. Помогает настроить правила линтинга и зафиксировать версии зависимостей. CX Codex +1 16 300установок dx-pkg-post-install-configure forcedotcom Скилл dx-pkg-post-install-configure для Claude Code автоматизирует настройку Salesforce после установки управляемого пакета. Он подключается, когда нужно применить права доступа, настройки страниц или другие шаги из инструкции пакета. CX Codex +1 3 600установок sdk-install launchdarkly Скилл sdk-install проводит агента по шагам detect → plan → apply, чтобы подключить LaunchDarkly к проекту и инициализировать SDK. CX Codex +1 2 300установок

Из того же набора36

Весь набор →
cp Команда cp проверяет ветку, готовит коммит, отправляет его в origin и запускает удалённые проверки. Она пригодится перед созданием pull request. CX Codex +1 ★ 907звёзд репо rv Команда rv прогоняет локальные проверки перед push: yamllint по workflow, compileall по Python, markdown-link-check по README. CX Codex +1 ★ 907звёзд репо social-media-analyzer Скилл social-media-analyzer считает вовлечённость, охваты и окупаемость рекламы по выгрузкам из соцсетей прямо в Claude Code. CX Codex +1 ★ 907звёзд репо build Команда build для Claude Code создаёт скиллы, промпты, субагентов и хуки в пошаговом диалоге с проверкой результата. CX Codex +1 ★ 907звёзд репо factory-guide Субагент factory-guide маршрутизирует запросы на создание скиллов, промптов, агентов и хуков, передавая задачу специализированным субагентам. CX Codex ★ 907звёзд репо test-factory Команда test-factory помогает проверить созданные скиллы, субагентов и промпты: предлагает тестовые сценарии и подсказывает, что проверить в результате. CX Codex +1 ★ 907звёзд репо factory-status Команда factory-status собирает один отчёт по всему, что уже наделала фабрика скиллов: что прошло проверку, что установлено и какой шаг делать дальше. CX Codex +1 ★ 907звёзд репо install-hook Команда install-hook встраивает сгенерированные хуки в глобальный или проектный файл настроек Claude Code с автоматической проверкой безопасности и бэкапом. CX Codex +1 ★ 907звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой