mcpskill
v0.2.0
Published
CLI установки Cursor Agent Skills: из npm-пакета или git-репозитория в ~/.cursor/skills (аналог npx skills add).
Readme
База скиллов (Skills)
Репозиторий для хранения и установки Agent Skills в Cursor.
Репозиторий: GitFlic — az6/skills
Клонирование: git clone [email protected]:az6/skills.git (SSH без пароля при настроенном ключе).
Содержимое
Скиллы лежат в skills/<slug>/. Каждый скилл — папка с SKILL.md и опционально references/, скрипты и т.д.
| Скилл | Описание | Установка |
|-------|----------|-----------|
| write-shorter | Кратко, ясно, убедительно — информационный копирайтинг по методу «Пиши, сокращай» | npx mcpskill add --skill write-shorter |
| gitflic | Работа с GitFlic: SSH для git, MCP для создания и управления репозиториями | npx mcpskill add --skill gitflic |
| invoice-ru | Счёт на оплату в российском формате (ИП/ООО): HTML → PDF, автозаполнение по ИНН через DaData | npx mcpskill add --skill invoice-ru |
Установка
Репозиторий по SSH: [email protected]:az6/skills.git (HTTPS: https://gitflic.ru/project/az6/skills.git).
Через mcpskill (аналог npx skills add)
Установка из npm-пакета или из git-репозитория в ~/.cursor/skills (или в каталог проекта .cursor/skills):
# Список скиллов из пакета
npx mcpskill add --list
# Установить один скилл (из пакета)
npx mcpskill add --skill write-shorter
npx mcpskill write-shorter # то же, короткая форма
# Установить все скиллы из пакета
npx mcpskill add --all
# Из git-репозитория (как npx skills add)
npx mcpskill add [email protected]:az6/skills.git --list
npx mcpskill add [email protected]:az6/skills.git --skill write-shorter
npx mcpskill add az6/skills --skill write-shorter -g # короткая форма: [email protected]:az6/skills.git
# Опции: -g (глобально), --dest <dir>, --dry-run
npx mcpskill add --helpБез источника используются скиллы из npm-пакета. Источник — git URL или owner/repo (по умолчанию хост GitFlic).
Через skills CLI
npx skills add [email protected]:az6/skills.git
npx skills add [email protected]:az6/skills.git --skill write-shorter
npx skills add [email protected]:az6/skills.git --list
npx skills add [email protected]:az6/skills.git -gРучная установка (SSH)
git clone [email protected]:az6/skills.git @skills
cd @skills
# write-shorter
cp -r skills/write-shorter ~/.cursor/skills/
# gitflic
cp -r skills/gitflic ~/.cursor/skills/
# invoice-ru
cp -r skills/invoice-ru ~/.cursor/skills/
# Все скиллы
for d in skills/*/; do cp -r "$d" ~/.cursor/skills/; doneПосле установки скилл доступен агенту по имени из frontmatter (name: write-shorter).
Как выгружать скилл
Процесс по skill-creator: валидация → упаковка (опционально) → push в репозиторий.
Зависимости для скриптов: pip install -r requirements.txt (нужен PyYAML).
Валидация — проверить скилл перед выгрузкой:
python scripts/quick_validate.py skills/<slug>Упаковка (опционально) — собрать .skill для раздачи одним файлом:
python scripts/package_skill.py skills/<slug> distВыгрузка в GitFlic — закоммитить и отправить:
git add skills/<slug> skills/index.json README.md git commit -m "Add skill: <slug>" git push origin main
После push установка: npx mcpskill add [email protected]:az6/skills.git --skill <slug>.
Добавление скилла
- Создать папку
skills/<slug>/. - Добавить
SKILL.mdс frontmatter:name,description. - Запустить валидацию:
python scripts/quick_validate.py skills/<slug>. - Обновить README: добавить строку в таблицу скиллов (команда установки
npx mcpskill add --skill <slug>) и при необходимости ручнойcpв разделе «Ручная установка». Обновитьskills/index.json.
