Запускаешь npx autoskills в корне проекта. Инструмент сканирует стек, находит подходящие AI-скиллы из курируемого реестра и устанавливает их для Cursor, Claude Code, Codex и других агентов. Всё. Агент теперь знает лучшие практики по React, Supabase, Tailwind или чему угодно ещё, что ты используешь.
5 600 звёзд за 2.5 месяца. Разбираем что это такое, как работает и где реальные ограничения.
Репозиторий: github.com/midudev/autoskills
Сайт: autoskills.sh
npm: npmjs.com/package/autoskills
Реестр скиллов: skills.sh (Vercel Labs)
Что такое AI-скиллы и зачем их вообще устанавливать?
TL;DR: AI-скилл — это markdown-файл, который объясняет агенту лучшие практики работы с конкретной технологией. Без скиллов агент знает React в целом. Со скиллами — знает как именно ты хочешь писать на React в этом проекте.
Cursor, Claude Code, Codex читают специальные файлы конфигурации при старте сессии — .cursorrules, CLAUDE.md, AGENTS.md. Туда можно положить инструкции: «используй такой-то подход», «не делай вот так», «вот паттерны которые мы применяем».
Скиллы — это готовые наборы таких инструкций под конкретные технологии. Вместо того чтобы писать правила для React с нуля, берёшь скилл от мейнтейнеров React-экосистемы — там уже всё, что нужно агенту знать.
Проблема: скиллов много, стеки разные, вручную подбирать и устанавливать под каждый проект — долго. Именно это и автоматизирует autoskills.
Как это работает — четыре шага?
TL;DR: Запустил команду → автоматически определился стек → показало что установит → согласился → скиллы лежат локально с SHA-256 проверкой.
npx autoskillsШаг 1 — Детекшен. Сканирует package.json, lockfiles, Gradle-файлы, конфиги, файловое дерево. Определяет: React, Next.js, Tailwind, Supabase, TypeScript — что угодно из 50+ поддерживаемых технологий. Всё локально, без сетевых запросов.
Шаг 2 — Подбор скиллов. Из курируемого реестра (skills.sh от Vercel Labs) находит matching-скиллы под обнаруженный стек.
Шаг 3 — Подтверждение. Показывает список что будет установлено. Можно посмотреть, убрать лишнее, согласиться. Или --dry-run чтобы просто посмотреть без установки.
Шаг 4 — Установка. Файлы скачиваются, каждый сверяется с SHA-256 хешем из манифеста, записываются локально. Создаётся skills-lock.json — фиксирует версии, источник, хеши. Как package-lock.json, только для AI-знаний.
Для Claude Code — автоматически генерируется CLAUDE.md со сводкой всех установленных скиллов. Claude Code читает этот файл при старте каждой сессии.
Какие технологии поддерживаются?
TL;DR: 50+ технологий. Сильно покрыты: React, Next.js, Tailwind, Supabase, Cloudflare, Vercel. Есть но слабее: мобильные, бэкенд. Некоторые детектируются но скиллов пока нет.
Сильное покрытие (много скиллов):
→ Фронтенд: React, Next.js, Vue, Nuxt, Svelte, Astro, Angular
→ Стилизация: Tailwind CSS, shadcn/ui
→ Данные: Supabase, Neon, Prisma, Drizzle ORM
→ Инфра: Cloudflare, Vercel, Cloudflare Workers, Durable Objects
→ Тестирование: Vitest, Playwright
Есть поддержка, но скиллов меньше:
→ Мобильные: Expo, React Native, Flutter, SwiftUI, Android, Kotlin Multiplatform
→ Десктоп: Tauri, Electron
→ Бэкенд: Express, Hono, NestJS, Spring Boot
Детектируются, скиллов пока нет:
→ AWS, PostgreSQL, React Router — помечены «no skills yet»
Важная деталь: обнаружение технологии ≠ наличие скилла под неё. Если стек нестандартный — проверь через --dry-run что реально установится.
Полезные команды
# Базовый запуск
npx autoskills
# Посмотреть что будет установлено без установки
npx autoskills --dry-run
# Установить только для конкретных агентов
npx autoskills -a cursor,claude-code
# Пропустить подтверждение, установить всё
npx autoskills -y
# Детальный вывод
npx autoskills --verboseФлаг -a полезен если используешь конкретный агент — поставит только нужные файлы без лишнего.
Безопасность — почему это важно именно здесь?
TL;DR: autoskills не тянет скиллы напрямую из случайных репозиториев. Всё проходит через курируемый реестр с проверкой на prompt-injection и SHA-256 верификацией каждого файла.
Скиллы — это инструкции для агентов. Если в скилл-файл подсунуть вредоносные инструкции (prompt injection), агент будет делать что-то нехорошее в твоём проекте. Supply-chain атака на уровне AI-контекста — реальный вектор.
Как autoskills защищается:
→ Скиллы не тянутся напрямую из upstream-репозиториев
→ Мейнтейнеры синхронизируют скиллы в локальный реестр
→ Каждый скилл проверяется на prompt-injection риски
→ SHA-256 хеш записывается в манифест
→ При установке каждый файл сверяется с манифестом
→ skills-lock.json фиксирует всё для аудита
Компромисс: реестр централизованный, всё идёт через мейнтейнеров. Не децентрализованный pip/npm. Зато защищён от случайного или намеренного отравления скиллов.
Где реальные ограничения — честно?
TL;DR: Лицензия CC BY-NC не MIT. Node.js 22+. Детекшен иногда ошибается. Нет авто-обновления установленных скиллов. Покрытие неравномерное за пределами JS-экосистемы.
Лицензия CC BY-NC 4.0 — главный нюанс
Это не MIT и не Apache 2.0. Creative Commons Non-Commercial — нельзя использовать в коммерческих продуктах без разрешения. Если строишь коммерческий продукт и хочешь включить autoskills в пайплайн — нужно уточнять. Для личных и некоммерческих проектов всё нормально.
Node.js 22+
Не все среды готовы к Node 22. Легаси-окружения и консервативные корпоративные конфиги могут упереться.
Детекшен не идеален
Issue #48 (уже исправлен): Python-бэкенд с requirements.txt определялся как веб-фронтенд и получал фронтенд-скиллы. Для не-JS стеков детекшен слабее. --dry-run перед установкой — хорошая привычка.
Нет авто-обновления
Issue #69: при повторном запуске уже установленные скиллы деселектятся. Механизма «проверь обновления» нет — нужно вручную следить за новыми версиями и переустанавливать.
Неравномерное покрытие
React, Next.js, Tailwind, Supabase, Cloudflare — богато. AWS, PostgreSQL, React Router — детект есть, скиллов нет. Python-экосистема — только что починили базовый детекшен. Если стек нестандартный — не жди чудес.
Кому стоит попробовать?
Попробуй, если:
→ Работаешь с JS/TS стеком — React, Next.js, Tailwind, Supabase, Vercel, Cloudflare
→ Используешь Cursor или Claude Code как основной инструмент
→ Хочешь стандартизировать AI-контекст в команде — skills-lock.json версионируется в git
→ Пет-проект или некоммерческий — лицензия не мешает
Подожди или осторожно, если:
→ Коммерческий продукт — уточни лицензию CC BY-NC
→ Python/Go/Ruby основной стек — покрытие слабее
→ Легаси-окружение с Node < 22
→ Enterprise с compliance-требованиями к зависимостям
Что это меняет в работе с агентами?
Autoskills — часть более широкого тренда. Раньше: разработчик вручную пишет CLAUDE.md или .cursorrules с нуля. Сейчас: запустил команду, получил готовый контекст от тех, кто знает технологию лучше всего.
Revista Cloud точно сформулировала суть: «autoskills тачит реальную потребность. Кодинговые агенты перестают быть просто чатами с доступом к терминалу и становятся более специализированными инструментами — и скиллы один из самых понятных способов сделать эту специализацию переиспользуемой.»
Следующий шаг после установки — понять как именно агент использует эти скиллы. Потому что autoskills устанавливает контекст, но не гарантирует что агент его применит правильно. Качество зависит от зрелости скиллов и от того как ты строишь промпты и loops.
Репозиторий: github.com/midudev/autoskills
Сайт: autoskills.sh
npm: npmjs.com/package/autoskills
Реестр скиллов: skills.sh (Vercel Labs)
Каталог AI-инструментов: vibecoderz.ru/category/ai-ide
Вопросы по стеку — к Максиму: telegram.me/maxnagovitsyn
FAQ
Что такое AI-скилл простыми словами?
Markdown-файл с инструкциями для AI-агента: лучшие практики, паттерны, что делать и что не делать при работе с конкретной технологией. Агент читает его и становится «экспертом» в этом стеке.
Работает ли с Cursor и Claude Code одновременно?
Да. Флаг -a cursor,claude-code устанавливает скиллы для обоих.
Скиллы попадают в git?
Да и это рекомендуется. skills-lock.json версионируется — вся команда работает с одинаковым AI-контекстом.
Node.js 22 обязателен?
Да, это требование. Проверь версию: node --version.
Можно использовать в коммерческом проекте?
Сам CLI — уточни лицензию CC BY-NC. Скиллы из реестра могут иметь свои лицензии — проверяй отдельно.
Что делать если стек не определился правильно?
Запусти --dry-run и посмотри что обнаружил детекшен. Часть скиллов можно выбрать вручную из реестра skills.sh.
Как обновить уже установленные скиллы?
Сейчас автоматического механизма нет — Issue #69 открыт. Нужно запустить повторно и переустановить вручную.
