# Skill Maker

> Мета-навык создания новых навыков для агентов по запросу пользователя. Помогает определить намерения, написать черновик SKILL.md, протестировать и итерировать.

- **Type:** Skill
- **Install:** `agentstack add skill-major-woolfi-skills-for-ai-agents-skill-maker`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Major-Woolfi](https://agentstack.voostack.com/s/major-woolfi)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Major-Woolfi](https://github.com/Major-Woolfi)
- **Source:** https://github.com/Major-Woolfi/Skills_for_AI-Agents/tree/main/SKILLS/skill-maker

## Install

```sh
agentstack add skill-major-woolfi-skills-for-ai-agents-skill-maker
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# skill-maker — Создание навыков

## Описание

Мета-навык для создания новых навыков агентов, соответствующих открытому стандарту [agentskills.io](https://agentskills.io/specification).

## Когда активировать

- Пользователь хочет создать новый навык для агента
- Есть рабочий процесс, который нужно превратить в навык
- Нужен черновик, тесты или итерация существующего навыка

## Философия

> Навык — это не код, а инструкция. Хороший навык объясняет не только «что делать», но и «почему».

### Принципы создания навыков

1. **Ясность.** Описание должно быть однозначным — ни двусмысленностей, ни расплывчатых формулировок.
2. **Практичность.** Навык должен реально работать, а не быть теоретическим упражнением.
3. **Итеративность.** Первый черновик почти всегда требует доработки — тестируй и улучшай.
4. **Соответствие стандарту.** Следуй спецификации agentskills.io.

## Обязательный цикл

### Шаг 1: Определение намерений

Начни с понимания целей пользователя.
Возможно, в истории чата уже есть рабочий процесс, который нужно превратить в навык.
Извлеки из контекста: используемые инструменты, последовательность шагов, исправления пользователя, форматы ввода/вывода.

1. Что этот навык должен позволить делать Koda?
2. Когда навык должен срабатывать? (фразы пользователя, контекст).
3. Какой ожидаемый формат вывода?
4. Нужно ли настраивать тест-кейсы?
   Навыки с объективно проверяемым результатом (преобразование файлов, извлечение данных, генерация кода) выигрывают от тестов.
   Для субъективных навыков (стиль письма, искусство) тесты часто не нужны.

### Шаг 2: Интервью и исследование

Проактивно спрашивай о пограничных случаях, форматах, примерах файлов и критериях успеха.
Не пиши тесты, пока не прояснишь эти детали.

Проверьте доступные MCP и инструменты — используйте их для поиска документации или лучших практик.

### Шаг 3: Написание SKILL.md

Документ должен быть на русском языке.

Заполни frontmatter:

- **`name`**: Идентификатор навыка.
  Требования: латиница в нижнем kebab-case, 1-64 символов, должно совпадать с именем директории
- **`description`**: Когда срабатывает и что делает.
  Требования: 1-1024 символов, краткое описание навыка на русском языке.
  Это основной механизм активации.
  Пиши описание немного «настойчивым», чтобы Koda не игнорировал навык там, где он полезен.

#### Проверка имени

```
✅ Валидно: code-review, sprint-planner, github-flow
❌ Невалидно: Code-Review (верхний регистр), -my-skill (дефис в начале), my--skill (двойной дефис)
```

### Шаг 4: Руководство по написанию навыка

#### Анатомия навыка

```
.agents/skills//
    └── SKILL.md
        ├── YAML frontmatter (name, description)
        └── Markdown-инструкции
```

#### Паттерны написания

- **Метаданные** (имя + описание) — всегда в контексте (~100 слов).
- **Тело SKILL.md** — в контексте при срабатывании (<500 строк).

Используй повелительное наклонение.
Объясняй «почему» нужно делать именно так — современные LLM лучше работают, когда понимают логику ограничений.

Навыки не должны содержать вредоносного кода или вводить пользователя в заблуждение.

## Чек-лист

- [ ] Имя навыка соответствует директории (kebab-case)
- [ ] Описание понятное, конкретное, 1-1024 символа
- [ ] Описание на русском языке
- [ ] Frontmatter заполнен (name, description, license, metadata)
- [ ] Навык протестирован на нескольких промптах
- [ ] Пользователь доволен результатом

## Scope

- Применять только когда пользователь явно просит создать навык
- Это мета-навык — он не выполняет задачи, а создаёт инструкции для других навыков
- После создания навыка предложи пользователю протестировать его

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Major-Woolfi](https://github.com/Major-Woolfi)
- **Source:** [Major-Woolfi/Skills_for_AI-Agents](https://github.com/Major-Woolfi/Skills_for_AI-Agents)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-major-woolfi-skills-for-ai-agents-skill-maker
- Seller: https://agentstack.voostack.com/s/major-woolfi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.