Формат инвентаря

Skill Item

Путь:

skills/<name>.md

Пример:

---
name: create-spec
description: Написать лаконичное ТЗ для разработчика
targets:
  - claude-code
  - cursor
tags:
  - planning
---

# Role

...

Поля:

Поле	Обязательно	Описание
name	да	Идентификатор навыка; должен совпадать с именем файла
description	нет	Короткое описание навыка
targets	нет	Список AI-сред; если не указан, применяются все обнаруженные
tags	нет	Пользовательские теги

Тело Markdown после frontmatter не должно быть пустым.

Folder Skill

Skill Item может храниться в виде папки:

skills/<name>/SKILL.md
skills/<name>/agent-patterns.md   # опциональные справочные файлы
skills/<name>/delegation.md
skills/<name>/examples.md

SKILL.md — основной файл навыка с frontmatter и телом. Остальные файлы в папке — справочные: их можно упомянуть в SKILL.md через @mention. При установке навыка папка целиком копируется в AI-среду.

Приоритет: если одновременно существуют skills/<name>.md и skills/<name>/SKILL.md, используется плоский файл (<name>.md).

Ограничение: apply --dry-run и расчёт дельты сравнивают только хеш SKILL.md. Изменения в справочных файлах папки не отображаются в составе изменений.

MCP Item

Путь:

mcp/<name>.yaml

Пример:

name: context7
description: Документация библиотек через MCP
command: npx
args:
  - -y
  - "@upstash/context7-mcp"
targets:
  - claude-code
  - cursor
  - codex
env:
  - name: UPSTASH_REDIS_REST_URL
    description: URL Redis-хранилища Upstash
    required: true
    example: https://example.upstash.io

Поля:

Поле	Обязательно	Описание
name	да	Идентификатор MCP-сервера
description	да	Короткое описание
command	да	Команда запуска
args	да	Список аргументов, может быть пустым
targets	да	Список AI-сред
env	да	Список env-переменных, может быть пустым

Env variable

Поле	Обязательно	Описание
name	да	Имя переменной
description	да	Назначение переменной
required	да	Требовать значение при применении
example	нет	Пример значения

Значения env-переменных не хранятся в MCP Item. Они задаются локально и сохраняются в aim.local.yaml.

Targets

Поддерживаемые значения:

• claude-code;
• cursor;
• codex.